Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

NPM pakket: olostep-cli CLI voor de Olostep API: map, answer, scrape, scrape-get, crawl, batch-scrape, en batch-update. Antwoorden zijn JSON (mooi geprint) voor scripts, CI en agents. Het installeren van dit pakket downloadt een standalone binary voor je besturingssysteem. Je hebt geen Python nodig om olostep te draaien.
Bij installatie downloadt een postinstall-stap de bijpassende binary van de GitHub releases van het pakket. Als dat mislukt, controleer of er een release bestaat voor deze pakketversie en jouw platform, en installeer dan opnieuw.

Installeren

Vereisten: Node.js 16+ (alleen voor npm / npx; de CLI zelf is een native binary).
npm install -g olostep-cli
Draai zonder een globale installatie:
npx -y olostep-cli@latest --help
Platforms: macOS (Apple Silicon en Intel), Linux x64, Windows x64.

API sleutel

Stel OLOSTEP_API_KEY in je omgeving in, of in een .env bestand in de directory waar je olostep draait. Maak sleutels aan: Olostep API Keys.
export OLOSTEP_API_KEY=your_key_here
olostep --help

Uitvoer

VlagGedrag
--out <pad>Schrijf JSON naar een bestand (bovenliggende mappen worden aangemaakt indien nodig).
--out -Schrijf JSON alleen naar stdout (UTF-8, ingesprongen). Goed voor pipes en subprocess capture.
Voortgangs- en logregels gaan naar stderr, zodat stdout parseerbaar blijft.
olostep map "https://example.com" --top-n 20 --out - | jq '.urls[:10]'
olostep scrape "https://example.com" --out - | jq .result.markdown_content
Als je --out weglaat, gaan bestanden naar output/ (zie Standaard --out paden).

Commando’s

Gebruik olostep <commando> --help voor elke optie. De meeste commando’s accepteren --timeout (HTTP, seconden).

map: ontdek URL’s

OptieBeschrijving
--outBestandspad of -
--top-nMax URL’s
--search-queryBegeleid ontdekking
--include-subdomain / --no-include-subdomainSubdomeinen
--include-url / --exclude-urlHerhaalbare patronen
--cursorPaginering
Gebruik --top-n, niet --limit (verwijderd).
olostep map "https://example.com" --top-n 100 --search-query "blog"

answer: onderzocht antwoord

Vraagt totdat het antwoord klaar is.
OptieBeschrijving
--outBestand of -
--json-formatOptionele gestructureerde uitvoer hint (JSON object string)
--poll-interval / --poll-timeoutPolling (seconden)
Gebruik --json-format, niet --model (verwijderd).
olostep answer "What does this company build?" --out answer.json
olostep answer "Extract facts" --json-format '{"company":"","year":""}' --out -

scrape: één URL

Formaten: html, markdown, text, json, raw_pdf, screenshot (komma-gescheiden; standaard markdown).
OptieBeschrijving
--formatsKomma-gescheiden
--countryLandcode
--wait-before-scrapingMs te wachten voor scrape
--payload-jsonGeavanceerde opties als JSON object string
--payload-fileZelfde, uit bestand (niet samen met --payload-json)
olostep scrape "https://example.com" --formats markdown,html
olostep scrape "https://example.com" --payload-file scrape-options.json --out -

scrape-get: door scrape ID

olostep scrape-get "scrape_abc123" --out -

crawl: site crawl

Ophalen formaten: markdown, html, json. Opmerkelijke vlaggen: --max-pages, --max-depth, --include-subdomain, --include-external, --include-url, --exclude-url, --search-query, --top-n, --webhook, --crawl-timeout, --follow-robots-txt / --ignore-robots-txt, --formats, --pages-limit, --pages-search-query, --poll-seconds, --poll-timeout, --dry-run (print payload, geen verzoek).
olostep crawl "https://docs.example.com" --max-pages 50 --formats markdown,html
olostep crawl "https://example.com" --max-pages 10 --dry-run

batch-scrape: CSV

CSV kolommen: custom_id of id, en url.
OptieBeschrijving
--formatsmarkdown, html, json
--countryOptioneel
--parser-idGestructureerde extractie parser
--poll-seconds, --log-every, --items-limitPolling / paginering
--dry-runAlleen payload printen
olostep batch-scrape urls.csv --formats markdown,html

batch-update: batch metadata

Vereist één van --metadata-json of --metadata-file (JSON object).
olostep batch-update "batch_abc123" --metadata-json '{"team":"growth"}'

Standaard --out paden

Wanneer --out wordt weggelaten:
CommandoStandaard
mapoutput/map.json
answeroutput/answer.json
scrapeoutput/scrape.json
scrape-getoutput/scrape_get.json
crawloutput/crawl_results.json
batch-scrapeoutput/batch_results.json
batch-updateoutput/batch_update.json

Globale vlaggen

VlagBeschrijving
-V, --versionVersie
-h, --helpHulp

Gerelateerde documentatie

Repository: github.com/olostep-api/CLI

Veiligheid

Houd API sleutels uit versiebeheer; roteer als ze zijn gelekt.