Instalación

Octoparse CLI se distribuye como paquete npm y funciona con Node.js 20 o una versión posterior.

Requisitos

Antes de instalar Octoparse CLI, asegúrate de que tu entorno disponga de:

Node.js 20 o posterior
npm 8 o posterior
Un terminal o shell de línea de comandos

Comprueba las versiones de Node.js y npm:

node -v
npm -v

Si tu versión de Node.js es anterior a la 20, actualízala antes de continuar.

Descargar Node.js

Instala Node.js 20 o posterior para tu sistema operativo.

Plataformas compatibles con la extracción local

La extracción local utiliza una instancia independiente de Chrome. Plataformas compatibles:

macOS (x64 y arm64)
Windows (x64)
Linux (x64)

Linux arm64 no es compatible con la extracción local. Chrome for Testing no ofrece un paquete para Linux arm64. Si utilizas un servidor ARM o un contenedor de Apple Silicon con una imagen Linux arm64, los comandos locales run y detect fallarán. La extracción en la nube (octoparse cloud start) funciona en cualquier plataforma.

Instalar con npm

Instala Octoparse CLI globalmente:

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

Después de la instalación, el comando octoparse estará disponible globalmente.

Verificar la instalación

Comprobaciones rápidas

Comprueba la versión instalada:

octoparse --version

Abre la ayuda:

octoparse --help

Interpretar el resultado de doctor

Ejecuta los diagnósticos:

octoparse doctor

octoparse doctor comprueba Node.js, el motor integrado de Octoparse, las extensiones del entorno de ejecución, la disponibilidad de Chrome y el modo del navegador. Un resultado correcto devuelve "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: la aplicación de escritorio de Octoparse no es necesaria para ejecutar la CLI.
browser-mode: independent Chrome only: la extracción local utiliza una instancia independiente de Chrome, no el navegador del cliente de escritorio.

Si chrome muestra ok: false, consulta la sección Solución de problemas más adelante. Si es necesario, utiliza una ruta personalizada de Chrome:

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

Comprobar si el navegador del usuario está listo

octoparse browser status

Utiliza la salida JSON para realizar comprobaciones estructuradas del entorno y del navegador del usuario:

octoparse doctor --json
octoparse browser status --json

Gestionar la instalación

Actualizar Octoparse CLI

Vuelve a ejecutar el comando de instalación de npm para actualizarla:

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

Desinstalar Octoparse CLI

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

Si el shell devuelve octoparse: command not found, el comando se ha eliminado.

Solución de problemas

Problema	Qué comprobar
`octoparse: command not found`	Confirma que el directorio global de binarios de npm esté incluido en tu `PATH`
Error de permisos durante la instalación	Comprueba los permisos de los paquetes globales de npm o utiliza un gestor de versiones de Node.js. Consulta la guía de npm →
La versión de Node.js es demasiado antigua	Actualiza a Node.js 20 o posterior
La instalación de npm agota el tiempo de espera	Comprueba el registro de npm y la configuración del Proxy, la VPN o el cortafuegos
Chrome no se descarga	Comprueba el acceso de red a la CDN de Chrome for Testing. Prueba `--chrome-path` para usar una instalación local de Chrome
Linux arm64 no es compatible	Usa un entorno Linux x64 o cambia a la extracción en la nube mediante `octoparse cloud start`
`doctor` muestra una comprobación fallida	Corrige la dependencia indicada (Node.js, Chrome o archivos del motor) y vuelve a ejecutar `octoparse doctor`. Si el problema continúa, comparte con el equipo de soporte de Octoparse el resultado que contiene `ok: false`

Siguientes pasos

Obtener una clave de API e iniciar sesión

Crea una clave de API de Octoparse y autentica la CLI.

Ejecutar tu primera tarea

Enumera las tareas, examina una, ejecútala localmente y exporta los datos.

Consultar todos los comandos

Consulta los comandos habituales de la CLI para tareas, ejecuciones locales, ejecuciones en la nube y exportaciones.

DESCRIPCIÓN GENERAL

PRIMEROS PASOS

CREAR TAREAS

TAREAS Y EJECUCIONES

DATOS

AUTOMATIZACIÓN

REFERENCIA

Requisitos

Descargar Node.js

Plataformas compatibles con la extracción local

Instalar con npm

Verificar la instalación

Comprobaciones rápidas

Interpretar el resultado de doctor

Comprobar si el navegador del usuario está listo

Gestionar la instalación

Actualizar Octoparse CLI

Desinstalar Octoparse CLI

Solución de problemas

Siguientes pasos

Obtener una clave de API e iniciar sesión

Ejecutar tu primera tarea

Consultar todos los comandos

​Requisitos

Descargar Node.js

​Plataformas compatibles con la extracción local

​Instalar con npm

​Verificar la instalación

​Comprobaciones rápidas

​Interpretar el resultado de doctor

​Comprobar si el navegador del usuario está listo

​Gestionar la instalación

​Actualizar Octoparse CLI

​Desinstalar Octoparse CLI

​Solución de problemas

​Siguientes pasos

Obtener una clave de API e iniciar sesión

Ejecutar tu primera tarea

Consultar todos los comandos

Requisitos

Plataformas compatibles con la extracción local

Instalar con npm

Verificar la instalación

Comprobaciones rápidas

Interpretar el resultado de doctor

Comprobar si el navegador del usuario está listo

Gestionar la instalación

Actualizar Octoparse CLI

Desinstalar Octoparse CLI

Solución de problemas

Siguientes pasos