Comandi per lavori e monitoraggio

Questi comandi avviano lavori che durano un po’ di tempo e leggono il loro progresso e risultati. I comandi che elencano i risultati li paginano con --limit e --cursor (o --offset): passa il cursore dal risultato precedente per ottenere la pagina successiva.

crawl

Esegui la scansione di un sito web. olostep crawl <url> esegue olostep crawl create. Vedi Crawls.

olostep crawl list

Elenca le tue scansioni recenti.

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

Flags

Flag	Obbligatorio	Descrizione
`--limit`	No	Dimensione della pagina.
`--source`	No	Filtro sorgente.
`--offset`	No	Offset a zero dalla pagina precedente.

Accetta anche --json e --fields. Vedi Flag globali.

olostep crawl list --limit 10

olostep crawl get

Mostra il progresso e le impostazioni di una scansione.

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

Argomenti

Argomento	Descrizione
`crawl_id`	ID della scansione.

Accetta anche --json e --fields. Vedi Flag globali.

olostep crawl get <crawl_id>

olostep crawl pages

Mostra una pagina dei risultati di una scansione. Ogni pagina ha un ID di recupero per olostep content retrieve.

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

Argomenti

Argomento	Descrizione
`crawl_id`	ID della scansione.

Flags

Flag	Obbligatorio	Descrizione
`--limit`	No	Numero massimo di record in questa pagina.
`--cursor`	No	Cursore opaco successivo da un risultato precedente.

Accetta anche --json e --fields. Vedi Flag globali.

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

olostep crawl create

Esegui la scansione di un sito web, seguendo i link da un URL iniziale fino a un limite di pagina.

Utilizza crediti.

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>]

Abbreviazione: olostep crawl <url>. Argomenti

Argomento	Descrizione
`start_url`	Un URL http(s). Facoltativo; puoi passarlo come flag invece.

Flags

Flag	Obbligatorio	Descrizione
`-n`, `--max-pages`	Sì	Numero massimo di pagine da scansionare.
`--depth`	No	Profondità massima del link dall’URL iniziale.
`--include-urls`	No	Modelli di URL da includere. Ripeti il flag o separa i valori con virgole.
`--exclude-urls`	No	Modelli di URL da escludere. Ripeti il flag o separa i valori con virgole.
`--include-external`	No	Segui i link esterni.
`--include-subdomain`	No	Includi i sottodomini.
`--follow-robots-txt`	No	Segui robots.txt.
`--ignore-sitemap`	No	Ignora la sitemap.
`--scrape-options`	No	Opzioni di scraping supportate dalla dashboard. Oggetto JSON o `@file.json`.
`--start-url`	No	Uguale all’argomento `start_url`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

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

batch

Raccogli molti URL in un unico lavoro. Vedi Batch.

olostep batch list

Elenca i tuoi batch recenti.

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

Flags

Flag	Obbligatorio	Descrizione
`--limit`	No	Dimensione della pagina.
`--source`	No	Filtro sorgente.
`--status`	No	Stato del batch.
`--search`	No	Filtro di ricerca.
`--offset`	No	Offset a zero dalla pagina precedente.

Accetta anche --json e --fields. Vedi Flag globali.

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

olostep batch get

Mostra il progresso e i metadati di un batch.

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

Argomenti

Argomento	Descrizione
`batch_id`	ID del batch.

Accetta anche --json e --fields. Vedi Flag globali.

olostep batch get <batch_id>

olostep batch items

Mostra una pagina degli elementi di un batch: ogni URL di input e il suo risultato.

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

Argomenti

Argomento	Descrizione
`batch_id`	ID del batch.

Flags

Flag	Obbligatorio	Descrizione
`--limit`	No	Numero massimo di record in questa pagina.
`--cursor`	No	Cursore opaco successivo da un risultato precedente.

Accetta anche --json e --fields. Vedi Flag globali.

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

olostep batch create

Crea un batch che raccoglie un elenco di URL. Ogni elemento ha il tuo custom_id e un url. Fino a 10.000 elementi.

Utilizza crediti.

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

Flags

Flag	Obbligatorio	Descrizione
`--items`	Sì	Gli URL da raccogliere: un elenco JSON di `{"custom_id": "...", "url": "..."}`, o `@file.json`.
`--country`	No	Paese opzionale.
`--parser`	No	Un parser da eseguire su ogni pagina: `{"id": "<parser_id>"}`, o `@file.json`.
`--metadata`	No	Metadati del batch. Oggetto JSON o `@file.json`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

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

Sostituisci i metadati di un batch.

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

Argomenti

Argomento	Descrizione
`batch_id`	ID del batch.

Flags

Flag	Obbligatorio	Descrizione
`--metadata`	Sì	Oggetto metadati. Oggetto JSON o `@file.json`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

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

olostep batch export

Inizia a preparare un download dei risultati di un batch. Controllalo con olostep batch export-status.

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

Argomenti

Argomento	Descrizione
`batch_id`	ID del batch.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

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

olostep batch export-status

Controlla il progresso di un’esportazione e ottieni il suo URL di download quando è pronto.

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

Argomenti

Argomento	Descrizione
`batch_id`	ID del batch.

Accetta anche --json e --fields. Vedi Flag globali.

olostep batch export-status <batch_id>

monitors

Osserva il web per cambiamenti su un programma. Vedi Monitors.

olostep monitors list

Elenca i tuoi monitor.

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

Flags

Flag	Obbligatorio	Descrizione
`--include-deleted`	No	Includi i monitor eliminati.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors list

olostep monitors get

Mostra le impostazioni e lo stato attuale di un monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors get <monitor_id>

olostep monitors create

Crea un monitor che osserva il web per ciò che descrivi, su un programma.

Utilizza crediti.

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	Obbligatorio	Descrizione
`--query`	Sì	Cosa monitorare, in parole semplici.
`--urls`	No	URL sorgente opzionali. Ripeti il flag o separa i valori con virgole.
`--frequency`	Sì	Frequenza di controllo, in parole, come `ogni giorno alle 9am` (UTC).
`--notification`	No	Canali di notifica e preferenze evento. Oggetto JSON o `@file.json`.
`--webhook`	No	Configurazione webhook. Oggetto JSON o `@file.json`.
`--source-policy`	No	URL e domini inclusi/esclusi. Oggetto JSON o `@file.json`.
`--output-schema`	No	Schema di output strutturato previsto. Oggetto JSON o `@file.json`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep monitors create --query "Nuovi cambiamenti di prezzo su example.com" --urls https://example.com/pricing --frequency "ogni giorno alle 9am"

olostep monitors update

Cambia la frequenza, le notifiche, il webhook o i metadati di un monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Flags

Flag	Obbligatorio	Descrizione
`--frequency`	No	Frequenza di controllo, in parole, come `ogni giorno alle 9am` (UTC).
`--notification`	No	Canali di notifica e preferenze evento. Oggetto JSON o `@file.json`.
`--webhook`	No	Configurazione webhook. Oggetto JSON o `@file.json`.
`--metadata`	No	Metadati del monitor. Oggetto JSON o `@file.json`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep monitors update <monitor_id> --frequency "ogni 20 minuti"

olostep monitors pause

Metti in pausa un monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep monitors pause <monitor_id>

olostep monitors resume

Riprendi un monitor in pausa.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep monitors resume <monitor_id>

olostep monitors delete

Elimina un monitor.

Chiede conferma prima di eseguire; passa --yes quando non c’è un terminale.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json, --fields, --dry-run, --preview e --yes. Vedi Flag globali.

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

olostep monitors events

Mostra una pagina degli eventi di esecuzione di un monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Flags

Flag	Obbligatorio	Descrizione
`--limit`	No	Numero massimo di record in questa pagina.
`--cursor`	No	Cursore opaco successivo da un risultato precedente.
`--status`	No	Filtro di stato dell’esecuzione.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors events <monitor_id> --limit 20

olostep monitors planning

Mostra il piano di un monitor e come viene eseguito.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors planning <monitor_id>

olostep monitors run

Esegui un monitor ora, con le sue impostazioni salvate.

Utilizza crediti.

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

Flags

Flag	Obbligatorio	Descrizione
`--monitor-id`	Sì	ID del monitor.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep monitors run --monitor-id <monitor_id>

olostep monitors run-get

Mostra un’esecuzione di monitor e il suo snapshot strutturato.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.
`run_id`	ID dell’esecuzione.

Flags

Flag	Obbligatorio	Descrizione
`--include-trace`	No	Includi il tracciato di esecuzione.

Accetta anche --json e --fields. Vedi Flag globali.

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

olostep monitors logs

Mostra i log recenti delle esecuzioni di un monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Flags

Flag	Obbligatorio	Descrizione
`--since`	No	Ora di inizio, in millisecondi dall’epoca Unix.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors logs <monitor_id>

olostep monitors snapshot

Mostra lo snapshot strutturato di un’esecuzione di monitor.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.
`run_id`	ID dell’esecuzione.

Accetta anche --json e --fields. Vedi Flag globali.

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

Ottieni il link di condivisione pubblica di un monitor. Non cambia chi può vederlo.

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

Argomenti

Argomento	Descrizione
`monitor_id`	ID del monitor.

Accetta anche --json e --fields. Vedi Flag globali.

olostep monitors share <monitor_id>

agents

Esegui agenti di ricerca. Vedi Agents.

olostep agents list

Elenca gli agenti di ricerca disponibili per il tuo team.

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

Accetta anche --json e --fields. Vedi Flag globali.

olostep agents list

olostep agents get

Mostra i dettagli di un agente e gli input predefiniti.

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

Argomenti

Argomento	Descrizione
`agent_id`	ID dell’agente.

Flags

Flag	Obbligatorio	Descrizione
`--version`	No	Versione.

Accetta anche --json e --fields. Vedi Flag globali.

olostep agents get <agent_id>

olostep agents runs

Elenca le esecuzioni di un agente di ricerca.

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

Argomenti

Argomento	Descrizione
`agent_id`	ID dell’agente.

Accetta anche --json e --fields. Vedi Flag globali.

olostep agents runs <agent_id>

olostep agents run

Esegui un agente di ricerca con i tuoi valori di input.

Utilizza crediti.

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

Argomenti

Argomento	Descrizione
`agent_id`	ID dell’agente.

Flags

Flag	Obbligatorio	Descrizione
`--version`	No	Versione dell’agente.
`--input-values`	No	Valori di input che corrispondono allo schema dichiarato dell’agente. Oggetto JSON o `@file.json`.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

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

olostep agents run-get

Mostra lo stato e i risultati di un’esecuzione di un agente di ricerca.

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

Argomenti

Argomento	Descrizione
`agent_id`	ID dell’agente.
`run_id`	ID dell’esecuzione.

Accetta anche --json e --fields. Vedi Flag globali.

olostep agents run-get <agent_id> <run_id>

olostep agents request

Chiedi al team di Olostep di creare un agente di ricerca personalizzato per te.

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

Flags

Flag	Obbligatorio	Descrizione
`--task`	Sì	Flusso di lavoro di ricerca richiesto.
`--model`	No	Modello richiesto.
`--schedule`	No	Programma richiesto.
`--budget`	No	Budget richiesto.

Accetta anche --json, --fields, --dry-run e --preview. Vedi Flag globali.

olostep agents request --task "Ogni lunedì, trova nuove aziende fintech Series A in Europa" --schedule "settimanale"

logs

Leggi le richieste che il tuo team ha fatto all’API di Olostep.

olostep logs list

Mostra una pagina dei log delle richieste API. Filtra per stato, endpoint e metodo.

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	Obbligatorio	Descrizione
`--days`	No	Finestra di retrospettiva in giorni. Uno di: `1`, `7`, `30`, `90`.
`--page`	No	Numero di pagina, a partire da 1.
`--size`	No	Dimensione della pagina.
`--status`	No	Filtro di stato HTTP.
`--endpoint`	No	Filtro endpoint/percorso.
`--method`	No	Filtro metodo HTTP. Uno di: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.

Accetta anche --json e --fields. Vedi Flag globali.

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

olostep logs export

Esporta i log delle tue richieste API come 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	Obbligatorio	Descrizione
`--days`	No	Finestra di retrospettiva in giorni. Uno di: `1`, `7`, `30`, `90`.
`--format`	No	Formato di esportazione. Uno di: `json`, `csv`.
`--max-pages`	No	Numero massimo di pagine di log da esportare (1 a 100).
`--status`	No	Filtro di stato HTTP.
`--endpoint`	No	Filtro endpoint o percorso.
`--method`	No	Filtro metodo HTTP. Uno di: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`.

Accetta anche --json e --fields. Vedi Flag globali.

olostep logs export --days 30 --format csv

Olostep CLI

Riferimento comandi

Comandi per lavori e monitoraggio

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