Qué permite hacer Octoparse CLI
Crear tareas desde una URL
Inspecciona cualquier URL y genera un archivo de tarea local de forma automática, manual o mediante un flujo con un agente de IA.
Buscar y gestionar tareas
Enumera tareas en la nube, busca por palabra clave, inspecciona detalles y trabaja con grupos de tareas.
Crear desde plantillas
Consulta y busca plantillas, crea Plantillas de tarea y modifícalas.
Ejecutar tareas localmente
Ejecuta tareas con el motor local integrado y una instancia independiente de Chrome.
Elegir un modo de navegador
Usa una instancia independiente de Chrome o reutiliza un perfil de Chrome o Edge con la sesión iniciada.
Ejecutar y programar tareas en la nube
Inicia la Extracción en la nube, revisa el historial y configura programaciones recurrentes.
Inspeccionar y exportar datos
Comprueba el número de registros, previsualiza filas, revisa datos no exportados y exporta resultados locales o en la nube.
Automatizar con agentes
Usa salidas JSON, flujos de eventos JSONL y códigos de salida para integrar la CLI en scripts y agentes de IA.
Cómo funciona
Octoparse CLI ejecuta directamente el motor integrado de Octoparse para la Ejecución local. Usa una instancia independiente de Chrome y no requiere el cliente de escritorio Electron. La Extracción en la nube se controla mediante API de backend; la Ejecución local, mediante el motor local.Esta CLI registra el estado de las ejecuciones locales, que no se sincroniza con el cliente de escritorio de Octoparse.
Requisitos
Antes de usar Octoparse CLI, necesitas:- Node.js 20 o posterior
- npm 8 o posterior
- Una cuenta de Octoparse (clave de API u OAuth)
- Acceso a las tareas que quieras ejecutar o exportar
--task-file y .otd. Los comandos de configuración y diagnóstico como --help, --version, doctor, browser, capabilities y auth pueden ejecutarse sin ella.
Flujo habitual
1
Instalar Octoparse CLI
Instala globalmente la CLI con npm.
2
Autenticarse
Inicia sesión con OAuth o una clave de API de Octoparse. En CI, usa la variable de entorno
OCTO_ENGINE_API_KEY.
3
Crear o buscar una tarea
Usa
octoparse detect <url> para generar un archivo desde una URL, crea una tarea desde una plantilla o usa octoparse task list para encontrar un ID existente.4
Ejecutar o controlar la tarea
Ejecútala localmente, inicia o detén una ejecución en la nube, configura una programación o consulta su estado.
5
Inspeccionar y exportar datos
Comprueba el estado, previsualiza filas, revisa los datos no exportados o exporta resultados locales o en la nube.
Ejemplos rápidos de comandos
Sustituye<taskId> por el ID real de la tarea y <url> por la página que quieras extraer.
Limitaciones actuales
Octoparse CLI v1 no admite kernel browser ni flujos heredados. Kernel browser designa el modo utilizado por entornos de ejecución antiguos de Octoparse. Los flujos heredados son tareas creadas con definiciones antiguas que el entorno actual de la CLI no admite. Si una tarea no es compatible, reconstrúyela o actualízala en la aplicación de escritorio actual y vuelve a ejecutarla con la CLI.Siguientes pasos
Instalar Octoparse CLI
Configura Node.js, instala la CLI con npm y verifica el entorno local.
Crear tareas desde una URL
Usa detect para generar un archivo de tarea desde cualquier URL.
Consultar todos los comandos
Revisa los comandos de tareas, plantillas, programaciones, detect, ejecuciones locales y en la nube, autenticación y exportación.