> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Installation
> Installez Octoparse CLI avec npm, vérifiez Node.js et votre plateforme, puis contrôlez le moteur local, Chrome et le navigateur utilisateur.
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 :
```bash theme={null}
node -v
npm -v
```
Si votre version de Node.js est antérieure à la version 20, mettez-la à niveau avant de continuer.
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 :
```bash theme={null}
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 :
```bash theme={null}
octoparse --version
```
Affichez l’aide :
```bash theme={null}
octoparse --help
```
### Comprendre la sortie de `doctor`
Exécutez les diagnostics :
```bash theme={null}
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` :
```json theme={null}
{
"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](#dépannage) ci-dessous.
Si nécessaire, spécifiez un chemin Chrome personnalisé :
```bash theme={null}
octoparse doctor --chrome-path /path/to/chrome
```
### Vérifier la disponibilité du navigateur utilisateur
```bash theme={null}
octoparse browser status
```
Utilisez la sortie JSON pour obtenir des vérifications structurées de l’environnement et du navigateur utilisateur :
```bash theme={null}
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 :
```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
octoparse --version
```
### Désinstaller Octoparse CLI
```bash theme={null}
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 →](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) |
| 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
Créez une clé API Octoparse et authentifiez la CLI.
Répertoriez les tâches, inspectez-en une, exécutez-la en local et exportez les données.
Consultez les commandes CLI courantes pour les tâches, les exécutions locales et dans le Cloud, et les exports.