> ## 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. # Crear tareas desde una URL > Usa octoparse detect para examinar una URL, seleccionar datos y generar un archivo de tarea local con flujos automáticos, manuales o de agentes de IA. `octoparse detect` abre el navegador con la extensión de Octoparse, examina la página y genera un archivo de tarea local. Úsalo para crear una tarea desde una URL sin la aplicación de escritorio de Octoparse. Desde la versión 0.1.32, la detección rechaza las páginas con CAPTCHA, acceso restringido, desafíos de seguridad o errores del servicio antes de generar la tarea. La clasificación de candidatos también descarta con mayor rigor las regiones deficientes y los contenedores de navegación que abarcan toda la página. Las páginas complejas y los flujos de inicio de sesión aún pueden requerir una revisión manual. Hay tres modos disponibles: | Modo | Cuándo usarlo | | ------------------------ | -------------------------------------------------------------------------------------- | | `--auto` | Quieres que la CLI elija automáticamente la mejor región de datos | | `--manual` | Necesitas iniciar sesión, cerrar un muro de pago o seleccionar personalmente la región | | Agente de IA (`--agent`) | Un LLM o una herramienta de automatización controla el flujo de trabajo | Para los agentes de IA, usa `--agent` o el flujo de preparación, vista previa y aplicación en lugar de `--auto`. El modo automático está pensado para la selección directa desde la CLI. `detect` requiere una cuenta de Octoparse y credenciales válidas. También requiere Chrome local y no es compatible con Linux arm64. Consulta [Instalación](../quick-start/installation#plataformas-compatibles-con-la-extracción-local) para conocer los requisitos de la plataforma. ## Modo automático La CLI elige la mejor región de datos candidata y genera un archivo de tarea: ```bash theme={null} octoparse detect --auto --output task.json ``` Proporciona una descripción en lenguaje natural de los datos que quieres extraer: ```bash theme={null} octoparse detect --auto --goal "Extract product titles and prices" --output task.json ``` Busca una palabra clave antes de realizar la detección, una opción útil para las páginas de resultados de búsqueda: ```bash theme={null} octoparse detect --auto --query "keyword" --goal "Extract search results" --output task.json ``` Usa `--json` para obtener una respuesta estructurada: ```bash theme={null} octoparse detect --auto --goal "..." --output task.json --json ``` Si se omite `--output`, se crea automáticamente un archivo `detected_.json`. ## Elegir un modo de navegador Usa una instancia independiente de Chrome for Testing o reutiliza un perfil con sesión iniciada del navegador del sistema: ```bash theme={null} octoparse detect --browser independent --auto octoparse detect --browser user --browser-id chrome --profile "Default" --manual ``` El modo del navegador sigue la prioridad compartida que documenta `octoparse browser --help`: opción del comando, `OCTOPARSE_BROWSER`, ajuste guardado mediante `octoparse browser use` y, por último, `independent`. El modo de usuario está disponible en Windows y macOS. ## Modo manual El modo manual abre una capa en el navegador donde puedes iniciar sesión, cerrar ventanas emergentes y seleccionar personalmente la región de datos: ```bash theme={null} octoparse detect --manual octoparse detect --manual --goal "Get article titles and links" ``` Usa `--save-session` para almacenar las cookies de sitios que requieren iniciar sesión; de esta forma, las futuras ejecuciones locales podrán reproducir la sesión: ```bash theme={null} octoparse detect --manual --save-session --session-name my-session --output task.json ``` Las sesiones de Cookie no cubren todos los sitios, especialmente las páginas que requieren localStorage, vinculación del dispositivo o una verificación nueva. ## Validar la tarea generada Después de generar el archivo de tarea, valídalo antes de ejecutarlo: ```bash theme={null} octoparse task validate --task-file task.json ``` Después, realiza una pequeña ejecución local de muestra: ```bash theme={null} octoparse run --task-file task.json --max-rows 10 --headless ``` Exporta los resultados de muestra: ```bash theme={null} octoparse data export --source local --format xlsx ``` ## Flujo de trabajo con un agente de IA En los flujos controlados por un LLM o automatizados, usa el contrato del agente en lugar de `--auto`. Empieza por consultar las capacidades: ```bash theme={null} octoparse capabilities --json ``` La respuesta incluye `machineContract.recipes.createTaskFromUrlWithAgent`, el flujo recomendado para agentes. ### En un solo paso (la opción más rápida) Usa `--agent` con un ejecutor local de confianza que pueda leer un archivo de contexto y escribir un plan: ```bash theme={null} octoparse detect \ --agent \ --agent-command "path/to/your/agent-runner" \ --goal "Extract search results" \ --output task.json \ --yes \ --run-sample 5 \ --json ``` La respuesta es un único objeto JSON que contiene la tarea generada, el resultado de la vista previa y el resultado de la ejecución de muestra. ### Paso a paso y auditable Para auditorías o reparaciones, usa la secuencia de preparación, vista previa y aplicación en lugar de generar la tarea en un solo paso. Exporta el contexto de la página web para que el agente pueda planificar. ```bash theme={null} octoparse detect \ --prepare-agent \ --goal "Extract product titles and prices" \ --output context.json \ --json ``` Se genera `context.json` con las regiones de datos candidatas, muestras de campos, capturas visuales y un `decisionSummary`. Crea un archivo `plan.json` a partir de `context.json`. Usa el esquema `octopus.detect.agent-plan.v1`. Abre la ruta de la captura anotada indicada en `context.visualArtifacts.annotatedScreenshotPath` antes de elegir los campos e incluye pruebas de `visualReview` en el plan. Valida el plan antes de generar el archivo de tarea definitivo. ```bash theme={null} octoparse detect \ --preview-agent-plan plan.json \ --agent-context context.json \ --json ``` Si `data.pass` es false, revisa el plan antes de aplicarlo. Genera el archivo de tarea local definitivo. ```bash theme={null} octoparse detect \ --apply-agent-plan plan.json \ --agent-context context.json \ --output task.json ``` Después puedes examinar y validar el archivo `task.json` generado o usarlo en una ejecución local de la CLI. ## Solución de problemas de detect | Problema | Qué comprobar | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | Chrome no se inicia | Ejecuta `octoparse doctor` y comprueba la entrada `chrome`. Prueba `--chrome-path /path/to/chrome` | | `LINUX_ARM64_UNSUPPORTED` | Cambia a un entorno Linux x64 o usa la extracción en la nube | | `LOGIN_SESSION_REQUIRED` | Usa `--manual` para iniciar sesión y `--save-session` para almacenarla | | La vista previa del plan devuelve `pass: false` | Revisa `candidateId` o la selección de campos en `plan.json` y vuelve a ejecutar la vista previa | | La tarea genera resultados vacíos o incorrectos | Comprueba `context.resultValidationPolicy` en el contexto del agente; es habitual que falten campos aislados en anuncios o filas heterogéneas | ## Siguientes pasos Ejecuta localmente una tarea generada, comprueba su estado y exporta los resultados. Referencia completa de los comandos de detección, ejecución, nube, datos y autenticación.