Installation

Octoparse CLI est distribué sous forme de package npm et fonctionne avec Node.js 20 ou version ultérieure.

Configuration requise

Avant d’installer Octoparse CLI, assurez-vous que votre environnement dispose des éléments suivants :

Node.js 20 ou version ultérieure
npm 8 ou version ultérieure
Un terminal ou un shell en ligne de commande

Vérifiez les versions de Node.js et npm :

node -v
npm -v

Si votre version de Node.js est antérieure à la version 20, mettez-la à niveau avant de continuer.

Télécharger Node.js

Installez Node.js 20 ou version ultérieure pour votre système d’exploitation.

Plateformes compatibles avec l’Extraction locale

L’Extraction locale utilise une instance Chrome indépendante. Les plateformes suivantes sont compatibles :

macOS (x64 et arm64)
Windows (x64)
Linux (x64)

Linux arm64 n’est pas compatible avec l’Extraction locale. Chrome for Testing ne fournit aucun package pour Linux arm64. Si vous utilisez un serveur ARM ou un conteneur Apple Silicon avec une image Linux arm64, les commandes locales run et detect échoueront. L’Extraction dans le cloud (octoparse cloud start) fonctionne sur toutes les plateformes.

Installation avec npm

Installez globalement Octoparse CLI :

npm install -g @octoparse-ai/octoparse-cli

Après l’installation, la commande octoparse est disponible globalement.

Vérification de l’installation

Vérifications rapides

Vérifiez la version installée :

octoparse --version

Affichez l’aide :

octoparse --help

Comprendre la sortie de `doctor`

Exécutez les diagnostics :

octoparse doctor

octoparse doctor vérifie Node.js, le moteur Octoparse intégré, les extensions de l’environnement d’exécution, la disponibilité de Chrome et le mode de navigateur. Un résultat positif renvoie "ok": true :

{
  "ok": true,
  "checks": [
    { "name": "node", "ok": true, "message": "v24.0.0" },
    { "name": "engine", "ok": true, "message": "..." },
    { "name": "electron-client", "ok": true, "message": "not required" },
    { "name": "browser-mode", "ok": true, "message": "independent Chrome only" }
  ]
}

electron-client: not required : l’application de bureau Octoparse n’est pas nécessaire pour exécuter la CLI.
browser-mode: independent Chrome only : l’Extraction locale utilise une instance Chrome indépendante et non le navigateur du client de bureau.

Si chrome affiche ok: false, consultez la section Dépannage ci-dessous. Si nécessaire, spécifiez un chemin Chrome personnalisé :

octoparse doctor --chrome-path /path/to/chrome

Vérifier la disponibilité du navigateur utilisateur

octoparse browser status

Utilisez la sortie JSON pour obtenir des vérifications structurées de l’environnement et du navigateur utilisateur :

octoparse doctor --json
octoparse browser status --json

Gestion de l’installation

Mettre à jour Octoparse CLI

Exécutez de nouveau la commande d’installation npm pour effectuer la mise à jour :

npm install -g @octoparse-ai/octoparse-cli
octoparse --version

Désinstaller Octoparse CLI

npm uninstall -g @octoparse-ai/octoparse-cli

Si le shell renvoie octoparse: command not found, la commande a bien été supprimée.

Dépannage

Problème	Points à vérifier
`octoparse: command not found`	Vérifiez que le répertoire global des exécutables npm figure dans votre `PATH`
Erreur d’autorisation pendant l’installation	Vérifiez les autorisations des packages npm globaux ou utilisez un gestionnaire de versions Node.js. Consulter le guide npm →
Version de Node.js trop ancienne	Passez à Node.js 20 ou version ultérieure
Expiration du délai d’installation npm	Vérifiez votre registre npm ainsi que les paramètres du Proxy, du VPN ou du pare-feu
Échec du téléchargement de Chrome	Vérifiez l’accès de votre réseau au CDN de Chrome for Testing. Essayez `--chrome-path` pour utiliser une installation locale de Chrome
Linux arm64 non pris en charge	Utilisez un environnement Linux x64 ou passez à l’Extraction dans le cloud avec `octoparse cloud start`
Échec d’une vérification dans `doctor`	Corrigez la dépendance signalée (Node.js, Chrome ou fichiers du moteur), puis exécutez de nouveau `octoparse doctor`. Si le problème persiste, transmettez la sortie `ok: false` à l’assistance Octoparse

Étapes suivantes

Obtenir une clé API et se connecter

Créez une clé API Octoparse et authentifiez la CLI.

Exécuter votre première tâche

Répertoriez les tâches, inspectez-en une, exécutez-la en local et exportez les données.

Parcourir toutes les commandes

Consultez les commandes CLI courantes pour les tâches, les exécutions locales et dans le Cloud, et les exports.

VUE D’ENSEMBLE

BIEN DÉMARRER

CRÉER DES TÂCHES

TÂCHES ET EXÉCUTIONS

DONNÉES

AUTOMATISATION

RÉFÉRENCE

Configuration requise

Télécharger Node.js

Plateformes compatibles avec l’Extraction locale

Installation avec npm

Vérification de l’installation

Vérifications rapides

Comprendre la sortie de `doctor`

Vérifier la disponibilité du navigateur utilisateur

Gestion de l’installation

Mettre à jour Octoparse CLI

Désinstaller Octoparse CLI

Dépannage

Étapes suivantes

Obtenir une clé API et se connecter

Exécuter votre première tâche

Parcourir toutes les commandes

​Configuration requise

Télécharger Node.js

​Plateformes compatibles avec l’Extraction locale

​Installation avec npm

​Vérification de l’installation

​Vérifications rapides

​Comprendre la sortie de doctor

​Vérifier la disponibilité du navigateur utilisateur

​Gestion de l’installation

​Mettre à jour Octoparse CLI

​Désinstaller Octoparse CLI

​Dépannage

​Étapes suivantes

Obtenir une clé API et se connecter

Exécuter votre première tâche

Parcourir toutes les commandes

Configuration requise

Plateformes compatibles avec l’Extraction locale

Installation avec npm

Vérification de l’installation

Vérifications rapides

Comprendre la sortie de `doctor`

Vérifier la disponibilité du navigateur utilisateur

Gestion de l’installation

Mettre à jour Octoparse CLI

Désinstaller Octoparse CLI

Dépannage

Étapes suivantes