Skip to main content
Octoparse CLI est un outil en ligne de commande permettant de créer, exécuter, gérer, planifier, inspecter et exporter des tâches Octoparse depuis un terminal. Contrairement à l’application de bureau, Octoparse CLI est conçu pour les Flux de travail scriptés, les pipelines CI/CD, les environnements serveur et les pipelines de données automatisés.

​
Fonctionnalités d’Octoparse CLI

Créer des tâches à partir d’une URL

Inspectez n’importe quelle URL et générez automatiquement ou manuellement un fichier de tâche local, ou faites-le au moyen du Flux de travail d’un agent IA.

Rechercher et gérer les tâches

Répertoriez les tâches dans le Cloud, effectuez une recherche par mot-clé, inspectez les détails d’une tâche et utilisez les Groupes de tâches.

Créer à partir de modèles

Affichez et recherchez des modèles, créez des Modèles de tâche et modifiez-les.

Exécuter les tâches en local

Exécutez des tâches Octoparse avec le moteur local intégré et une instance Chrome indépendante.

Choisir un mode de navigateur

Utilisez une instance Chrome indépendante ou réutilisez un profil Chrome ou Edge déjà connecté.

Exécuter et planifier des tâches dans le Cloud

Démarrez une Extraction dans le cloud, consultez l’historique et configurez des planifications récurrentes.

Inspecter et exporter les données

Vérifiez le nombre d’enregistrements, prévisualisez les lignes, consultez les données non exportées et exportez les résultats locaux ou dans le Cloud.

Automatiser avec des agents

Utilisez la sortie JSON, les flux d’événements JSONL et les codes de sortie pour intégrer la CLI aux scripts et agents IA.

​
Fonctionnement

Octoparse CLI exécute directement le moteur Octoparse intégré pour l’Extraction locale. Il utilise une instance Chrome indépendante et ne nécessite pas le client de bureau Electron. L’Extraction dans le cloud est contrôlée par les API du service. L’Extraction locale est contrôlée par le moteur local.
L’état des exécutions locales est suivi par cette CLI et n’est pas synchronisé avec celui du client de bureau Octoparse.

​
Configuration requise

Avant d’utiliser Octoparse CLI, assurez-vous de disposer des éléments suivants :
  • Node.js 20 ou version ultérieure
  • npm 8 ou version ultérieure
  • Un compte Octoparse (clé API ou OAuth)
  • Un accès aux tâches que vous souhaitez exécuter ou exporter
Consultez la page Installation pour connaître la configuration requise selon la plateforme et les étapes d’installation, notamment les limitations de Linux arm64. Les commandes fonctionnelles nécessitent une authentification, y compris les exécutions locales avec --task-file et les fichiers .otd. Les commandes de configuration et de diagnostic telles que --help, --version, doctor, browser, capabilities et auth peuvent être exécutées sans authentification.

​
Flux de travail courant

1

Installer Octoparse CLI

Installez globalement la CLI avec npm.
2

S’authentifier

Connectez-vous avec OAuth ou une clé API Octoparse. Pour la CI, utilisez la variable d’environnement OCTO_ENGINE_API_KEY.
Ne publiez jamais de clés API dans Git, des scripts, la documentation, des captures d’écran, des journaux partagés ou la sortie de la CI.
3

Créer ou rechercher une tâche

Utilisez octoparse detect <url> pour générer un fichier de tâche à partir d’une URL, créez une tâche depuis un modèle ou utilisez octoparse task list pour trouver l’ID d’une tâche existante.
4

Exécuter ou contrôler la tâche

Exécutez la tâche en local, démarrez ou arrêtez une exécution dans le Cloud, configurez une planification dans le Cloud ou vérifiez l’état de l’exécution.
5

Inspecter et exporter les données

Vérifiez l’état des données, prévisualisez les lignes, consultez les données non exportées ou exportez les données collectées depuis les résultats locaux ou dans le Cloud.

​
Exemples de commandes courantes

Remplacez <taskId> par l’ID réel de votre tâche et <url> par la page à scraper.

​
Limitations actuelles

Octoparse CLI v1 ne prend pas en charge le navigateur du noyau ni les anciens Flux de travail. Le navigateur du noyau désigne le mode de navigateur utilisé par les anciens Flux de travail d’exécution Octoparse. Un ancien Flux de travail désigne une tâche créée avec une ancienne définition de tâche Octoparse qui n’est pas prise en charge par l’environnement d’exécution actuel de la CLI. Si une tâche n’est pas prise en charge, recréez-la ou mettez-la à jour dans la version actuelle de l’application de bureau Octoparse, puis exécutez-la de nouveau avec la CLI.

​
Étapes suivantes

Installer Octoparse CLI

Configurez Node.js, installez la CLI avec npm et vérifiez l’environnement d’exécution local.

Créer des tâches à partir d’une URL

Utilisez detect pour générer un fichier de tâche à partir de n’importe quelle URL.

Parcourir toutes les commandes

Consultez les commandes relatives aux tâches, modèles, planifications, à detect, aux exécutions locales et dans le Cloud, à l’authentification et à l’export.