Get Started on Cloud
BasicsAI AgentsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesTerraformTunnelsYAMLBuddy GitCLIAPIFAQ

bdy crawl

View as Markdown
$bdy crawl [options] [command]

Crawl websites into Markdown, HTML and screenshots

OPTIONS
--context <name>
Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.
--examples
Show only examples; with this flag --format accepts text, json or jsonl
--verbose
Show REST API requests, responses, timing and retries on stderr
-h, --help
display help for command
AVAILABLE COMMANDS
Link current directory to a crawl suite Required scopes: CRAWL_WRITE
Crawl a URL and download the results (screenshots, Markdown, HTML) to a directory

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

Next pageGetting Started

Examples

Crawl a single page and save md/html into current dir
bdy crawl run https://example.com --outputType md$
Follow links and capture full-page screenshots in dark mode
bdy crawl run https://example.com --follow --fullPage --outputType png --colorScheme DARK --outputDir ./out$
Crawl with multiple output types and a specific css selector
bdy crawl run https://example.com --outputTypes '["jpeg","md"]' --cssSelector "main"$
Interactively link current directory to a crawl suite
bdy crawl link$
Link non-interactively to a specific suite
bdy crawl link -w workspace -p project -s suite-identifier$