Comandos de trabajos y monitoreo

Estos comandos inician trabajos que se ejecutan durante un tiempo y leen su progreso y resultados. Los comandos que enumeran resultados los paginan con --limit y --cursor (o --offset): pasa el cursor del resultado anterior para obtener la siguiente página.

crawl

Rastrea un sitio web. olostep crawl <url> ejecuta olostep crawl create. Consulta Crawls.

olostep crawl list

Lista tus rastreos recientes.

olostep crawl list [--limit integer] [--source text] [--offset integer] [--json] [--fields a,b]

Flags

Flag	Requerido	Descripción
`--limit`	No	Tamaño de página.
`--source`	No	Filtro de origen.
`--offset`	No	Desplazamiento basado en cero desde la página anterior.

También acepta --json y --fields. Consulta Flags globales.

olostep crawl list --limit 10

olostep crawl get

Muestra el progreso y configuraciones de un rastreo.

olostep crawl get [--json] [--fields a,b] <crawl_id>

Argumentos

Argumento	Descripción
`crawl_id`	ID del rastreo.

También acepta --json y --fields. Consulta Flags globales.

olostep crawl get <crawl_id>

olostep crawl pages

Muestra una página de los resultados de un rastreo. Cada página tiene un ID de Recuperación para olostep content retrieve.

olostep crawl pages [--limit integer] [--cursor text] [--json] [--fields a,b] <crawl_id>

Argumentos

Argumento	Descripción
`crawl_id`	ID del rastreo.

Flags

Flag	Requerido	Descripción
`--limit`	No	Máximo de registros en esta página.
`--cursor`	No	Próximo cursor opaco de un resultado anterior.

También acepta --json y --fields. Consulta Flags globales.

olostep crawl pages <crawl_id>
olostep crawl pages <crawl_id> --limit 100 --json

olostep crawl create

Rastrea un sitio web, siguiendo enlaces desde una URL de inicio hasta un límite de páginas.

Usa créditos.

olostep crawl create (--max-pages integer) [--depth integer] [--include-urls string]... [--exclude-urls string]... [--include-external] [--include-subdomain] [--follow-robots-txt] [--ignore-sitemap] [--scrape-options json] [--preview] [--start-url text] [--json] [--fields a,b] [--dry-run] [<start_url>]

Abreviatura: olostep crawl <url>. Argumentos

Argumento	Descripción
`start_url`	Una URL http(s). Opcional; puedes pasarla como un flag en su lugar.

Flags

Flag	Requerido	Descripción
`-n`, `--max-pages`	Sí	Máximo de páginas a rastrear.
`--depth`	No	Profundidad máxima de enlaces desde la URL de inicio.
`--include-urls`	No	Patrones de URL para incluir. Repite el flag o separa los valores con comas.
`--exclude-urls`	No	Patrones de URL para excluir. Repite el flag o separa los valores con comas.
`--include-external`	No	Seguir enlaces externos.
`--include-subdomain`	No	Incluir subdominios.
`--follow-robots-txt`	No	Seguir robots.txt.
`--ignore-sitemap`	No	Ignorar el sitemap.
`--scrape-options`	No	Opciones de scraping soportadas por el dashboard. Objeto JSON o `@file.json`.
`--start-url`	No	Igual que el argumento `start_url`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep crawl https://docs.example.com -n 50
olostep crawl https://example.com -n 200 --depth 3 --include-urls "/blog/**" --exclude-urls "/tag/**"

batch

Raspa muchas URLs en un solo trabajo. Consulta Batches.

olostep batch list

Lista tus lotes recientes.

olostep batch list [--limit integer] [--source text] [--status text] [--search text] [--offset integer] [--json] [--fields a,b]

Flags

Flag	Requerido	Descripción
`--limit`	No	Tamaño de página.
`--source`	No	Filtro de origen.
`--status`	No	Estado del lote.
`--search`	No	Filtro de búsqueda.
`--offset`	No	Desplazamiento basado en cero desde la página anterior.

También acepta --json y --fields. Consulta Flags globales.

olostep batch list --limit 20
olostep batch list --status completed --json

olostep batch get

Muestra el progreso y metadatos de un lote.

olostep batch get [--json] [--fields a,b] <batch_id>

Argumentos

Argumento	Descripción
`batch_id`	ID del lote.

También acepta --json y --fields. Consulta Flags globales.

olostep batch get <batch_id>

olostep batch items

Muestra una página de los elementos de un lote: cada URL de entrada y su resultado.

olostep batch items [--limit integer] [--cursor text] [--json] [--fields a,b] <batch_id>

Argumentos

Argumento	Descripción
`batch_id`	ID del lote.

Flags

Flag	Requerido	Descripción
`--limit`	No	Máximo de registros en esta página.
`--cursor`	No	Próximo cursor opaco de un resultado anterior.

También acepta --json y --fields. Consulta Flags globales.

olostep batch items <batch_id> --limit 50
olostep batch items <batch_id> --cursor <next_cursor>

olostep batch create

Crea un lote que raspa una lista de URLs. Cada elemento tiene su propio custom_id y una url. Hasta 10,000 elementos.

Usa créditos.

olostep batch create (--items json) [--country text] [--parser json] [--metadata json] [--preview] [--json] [--fields a,b] [--dry-run]

Flags

Flag	Requerido	Descripción
`--items`	Sí	Las URLs a raspar: una lista JSON de `{"custom_id": "...", "url": "..."}`, o `@file.json`.
`--country`	No	País opcional.
`--parser`	No	Un parser para ejecutar en cada página: `{"id": "<parser_id>"}`, o `@file.json`.
`--metadata`	No	Metadatos del lote. Objeto JSON o `@file.json`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep batch create --items '[{"custom_id":"home","url":"https://example.com"},{"custom_id":"pricing","url":"https://example.com/pricing"}]'
olostep batch create --items @urls.json --country US

olostep batch update

Reemplaza los metadatos de un lote.

olostep batch update (--metadata json) [--preview] [--json] [--fields a,b] [--dry-run] <batch_id>

Argumentos

Argumento	Descripción
`batch_id`	ID del lote.

Flags

Flag	Requerido	Descripción
`--metadata`	Sí	Objeto de metadatos. Objeto JSON o `@file.json`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep batch update <batch_id> --metadata '{"project":"q4-pricing"}'

olostep batch export

Comienza a preparar una descarga de los resultados de un lote. Verifícalo con olostep batch export-status.

olostep batch export [--preview] [--json] [--fields a,b] [--dry-run] <batch_id>

Argumentos

Argumento	Descripción
`batch_id`	ID del lote.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep batch export <batch_id>
olostep batch export-status <batch_id>

olostep batch export-status

Verifica el progreso de una exportación y obtén su URL de descarga cuando esté lista.

olostep batch export-status [--json] [--fields a,b] <batch_id>

Argumentos

Argumento	Descripción
`batch_id`	ID del lote.

También acepta --json y --fields. Consulta Flags globales.

olostep batch export-status <batch_id>

monitors

Observa la web para detectar cambios en un horario. Consulta Monitors.

olostep monitors list

Lista tus monitores.

olostep monitors list [--include-deleted] [--json] [--fields a,b]

Flags

Flag	Requerido	Descripción
`--include-deleted`	No	Incluir monitores eliminados.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors list

olostep monitors get

Muestra la configuración y el estado actual de un monitor.

olostep monitors get [--json] [--fields a,b] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors get <monitor_id>

olostep monitors create

Crea un monitor que observa la web para lo que describes, en un horario.

Usa créditos.

olostep monitors create (--query text) [--urls string]... (--frequency text) [--notification json] [--webhook json] [--source-policy json] [--output-schema json] [--preview] [--json] [--fields a,b] [--dry-run]

Flags

Flag	Requerido	Descripción
`--query`	Sí	Qué monitorear, en palabras simples.
`--urls`	No	URLs de origen opcionales. Repite el flag o separa los valores con comas.
`--frequency`	Sí	Con qué frecuencia verificar, en palabras, como `every day at 9am` (UTC).
`--notification`	No	Canales de notificación y preferencias de eventos. Objeto JSON o `@file.json`.
`--webhook`	No	Configuración de webhook. Objeto JSON o `@file.json`.
`--source-policy`	No	URLs y dominios incluidos/excluidos. Objeto JSON o `@file.json`.
`--output-schema`	No	Esquema de salida estructurada esperado. Objeto JSON o `@file.json`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep monitors create --query "Cambios de precios nuevos en example.com" --urls https://example.com/pricing --frequency "every day at 9am"

olostep monitors update

Cambia la frecuencia, notificaciones, webhook o metadatos de un monitor.

olostep monitors update [--frequency text] [--notification json] [--webhook json] [--metadata json] [--preview] [--json] [--fields a,b] [--dry-run] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

Flags

Flag	Requerido	Descripción
`--frequency`	No	Con qué frecuencia verificar, en palabras, como `every day at 9am` (UTC).
`--notification`	No	Canales de notificación y preferencias de eventos. Objeto JSON o `@file.json`.
`--webhook`	No	Configuración de webhook. Objeto JSON o `@file.json`.
`--metadata`	No	Metadatos del monitor. Objeto JSON o `@file.json`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep monitors update <monitor_id> --frequency "every 20 minutes"

olostep monitors pause

Pausa un monitor.

olostep monitors pause [--preview] [--json] [--fields a,b] [--dry-run] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep monitors pause <monitor_id>

olostep monitors resume

Reanuda un monitor pausado.

olostep monitors resume [--preview] [--json] [--fields a,b] [--dry-run] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep monitors resume <monitor_id>

olostep monitors delete

Elimina un monitor.

Pide confirmación antes de ejecutarse; pasa --yes cuando no hay terminal.

olostep monitors delete [--preview] [--json] [--fields a,b] [--dry-run] [--yes] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json, --fields, --dry-run, --preview y --yes. Consulta Flags globales.

olostep monitors delete <monitor_id> --dry-run
olostep monitors delete <monitor_id> --yes

olostep monitors events

Muestra una página de eventos de ejecución de un monitor.

olostep monitors events [--limit integer] [--cursor text] [--status text] [--json] [--fields a,b] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

Flags

Flag	Requerido	Descripción
`--limit`	No	Máximo de registros en esta página.
`--cursor`	No	Próximo cursor opaco de un resultado anterior.
`--status`	No	Filtro de estado de ejecución.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors events <monitor_id> --limit 20

olostep monitors planning

Muestra el plan de un monitor y cómo se ejecuta.

olostep monitors planning [--json] [--fields a,b] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors planning <monitor_id>

olostep monitors run

Ejecuta un monitor ahora, con sus configuraciones guardadas.

Usa créditos.

olostep monitors run (--monitor-id text) [--preview] [--json] [--fields a,b] [--dry-run]

Flags

Flag	Requerido	Descripción
`--monitor-id`	Sí	ID del monitor.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep monitors run --monitor-id <monitor_id>

olostep monitors run-get

Muestra una ejecución de monitor y su instantánea estructurada.

olostep monitors run-get [--include-trace] [--json] [--fields a,b] <monitor_id> <run_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.
`run_id`	ID de ejecución.

Flags

Flag	Requerido	Descripción
`--include-trace`	No	Incluir traza de ejecución.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors run-get <monitor_id> <run_id>
olostep monitors run-get <monitor_id> <run_id> --include-trace --json

olostep monitors logs

Muestra los registros recientes de las ejecuciones de un monitor.

olostep monitors logs [--since integer] [--json] [--fields a,b] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

Flags

Flag	Requerido	Descripción
`--since`	No	Hora de inicio, en milisegundos desde la época Unix.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors logs <monitor_id>

olostep monitors snapshot

Muestra la instantánea estructurada de una ejecución de monitor.

olostep monitors snapshot [--json] [--fields a,b] <monitor_id> <run_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.
`run_id`	ID de ejecución.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors snapshot <monitor_id> <run_id> --json

Obtén el enlace público de un monitor. No cambia quién puede verlo.

olostep monitors share [--json] [--fields a,b] <monitor_id>

Argumentos

Argumento	Descripción
`monitor_id`	ID del monitor.

También acepta --json y --fields. Consulta Flags globales.

olostep monitors share <monitor_id>

agents

Ejecuta agentes de investigación. Consulta Agents.

olostep agents list

Lista los agentes de investigación disponibles para tu equipo.

olostep agents list [--json] [--fields a,b]

También acepta --json y --fields. Consulta Flags globales.

olostep agents list

olostep agents get

Muestra los detalles de un agente y los valores de entrada predeterminados.

olostep agents get [--version text] [--json] [--fields a,b] <agent_id>

Argumentos

Argumento	Descripción
`agent_id`	ID del agente.

Flags

Flag	Requerido	Descripción
`--version`	No	Versión.

También acepta --json y --fields. Consulta Flags globales.

olostep agents get <agent_id>

olostep agents runs

Lista las ejecuciones de un agente de investigación.

olostep agents runs [--json] [--fields a,b] <agent_id>

Argumentos

Argumento	Descripción
`agent_id`	ID del agente.

También acepta --json y --fields. Consulta Flags globales.

olostep agents runs <agent_id>

olostep agents run

Ejecuta un agente de investigación con tus valores de entrada.

Usa créditos.

olostep agents run [--version text] [--input-values json] [--preview] [--json] [--fields a,b] [--dry-run] <agent_id>

Argumentos

Argumento	Descripción
`agent_id`	ID del agente.

Flags

Flag	Requerido	Descripción
`--version`	No	Versión del agente.
`--input-values`	No	Valores de entrada que coinciden con el esquema declarado del agente. Objeto JSON o `@file.json`.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep agents get <agent_id>
olostep agents run <agent_id> --input-values @inputs.json

olostep agents run-get

Muestra el estado y resultados de la ejecución de un agente de investigación.

olostep agents run-get [--json] [--fields a,b] <agent_id> <run_id>

Argumentos

Argumento	Descripción
`agent_id`	ID del agente.
`run_id`	ID de ejecución.

También acepta --json y --fields. Consulta Flags globales.

olostep agents run-get <agent_id> <run_id>

olostep agents request

Pide al equipo de Olostep que construya un agente de investigación personalizado para ti.

olostep agents request (--task text) [--model text] [--schedule text] [--budget text] [--preview] [--json] [--fields a,b] [--dry-run]

Flags

Flag	Requerido	Descripción
`--task`	Sí	Flujo de trabajo de investigación solicitado.
`--model`	No	Modelo solicitado.
`--schedule`	No	Horario solicitado.
`--budget`	No	Presupuesto solicitado.

También acepta --json, --fields, --dry-run y --preview. Consulta Flags globales.

olostep agents request --task "Cada lunes, encontrar nuevas empresas fintech de Serie A en Europa" --schedule "weekly"

logs

Lee las solicitudes que tu equipo hizo a la API de Olostep.

olostep logs list

Muestra una página de tus registros de solicitudes a la API. Filtra por estado, endpoint y método.

olostep logs list [--days 1|7|30|90] [--page integer] [--size integer] [--status text] [--endpoint text] [--method GET|POST|PUT|PATCH|DELETE] [--json] [--fields a,b]

Flags

Flag	Requerido	Descripción
`--days`	No	Ventana de retroceso en días. Uno de: `1`, `7`, `30`, `90`.
`--page`	No	Número de página, comenzando en 1.
`--size`	No	Tamaño de página.
`--status`	No	Filtro de estado HTTP.
`--endpoint`	No	Filtro de endpoint/ruta.
`--method`	No	Filtro de método HTTP. Uno de: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.

También acepta --json y --fields. Consulta Flags globales.

olostep logs list --days 7
olostep logs list --days 1 --status 429 --method POST

olostep logs export

Exporta tus registros de solicitudes a la API como JSON o CSV.

olostep logs export [--days 1|7|30|90] [--format json|csv] [--max-pages integer] [--status text] [--endpoint text] [--method GET|POST|PUT|PATCH|DELETE] [--json] [--fields a,b]

Flags

Flag	Requerido	Descripción
`--days`	No	Ventana de retroceso en días. Uno de: `1`, `7`, `30`, `90`.
`--format`	No	Formato de exportación. Uno de: `json`, `csv`.
`--max-pages`	No	Máximo de páginas de registros a exportar (1 a 100).
`--status`	No	Filtro de estado HTTP.
`--endpoint`	No	Filtro de endpoint o ruta.
`--method`	No	Filtro de método HTTP. Uno de: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.

También acepta --json y --fields. Consulta Flags globales.

olostep logs export --days 30 --format csv

Olostep CLI

Referencia de comandos

Comandos de trabajos y monitoreo

crawl

olostep crawl list

olostep crawl get

olostep crawl pages

olostep crawl create

batch

olostep batch list

olostep batch get

olostep batch items

olostep batch create

olostep batch update

olostep batch export

olostep batch export-status

monitors

olostep monitors list

olostep monitors get

olostep monitors create

olostep monitors update

olostep monitors pause

olostep monitors resume

olostep monitors delete

olostep monitors events

olostep monitors planning

olostep monitors run

olostep monitors run-get

olostep monitors logs

olostep monitors snapshot

agents

olostep agents list

olostep agents get

olostep agents runs

olostep agents run

olostep agents run-get

olostep agents request

logs

olostep logs list

olostep logs export

​crawl

​olostep crawl list

​olostep crawl get

​olostep crawl pages

​olostep crawl create

​batch

​olostep batch list

​olostep batch get

​olostep batch items

​olostep batch create

​olostep batch update

​olostep batch export

​olostep batch export-status

​monitors

​olostep monitors list

​olostep monitors get

​olostep monitors create

​olostep monitors update

​olostep monitors pause

​olostep monitors resume

​olostep monitors delete

​olostep monitors events

​olostep monitors planning

​olostep monitors run

​olostep monitors run-get

​olostep monitors logs

​olostep monitors snapshot

​olostep monitors share

​agents

​olostep agents list

​olostep agents get

​olostep agents runs

​olostep agents run

​olostep agents run-get

​olostep agents request

​logs

​olostep logs list

​olostep logs export

crawl

olostep crawl list

olostep crawl get

olostep crawl pages

olostep crawl create

batch

olostep batch list

olostep batch get

olostep batch items

olostep batch create

olostep batch update

olostep batch export

olostep batch export-status

monitors

olostep monitors list

olostep monitors get

olostep monitors create

olostep monitors update

olostep monitors pause

olostep monitors resume

olostep monitors delete

olostep monitors events

olostep monitors planning

olostep monitors run

olostep monitors run-get

olostep monitors logs

olostep monitors snapshot

olostep monitors share

agents

olostep agents list

olostep agents get

olostep agents runs

olostep agents run

olostep agents run-get

olostep agents request

logs

olostep logs list

olostep logs export