bdy crawl

$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

Link current directory to a crawl suite Required scopes: CRAWL_WRITE

run

Crawl a URL and download the results (screenshots, Markdown, HTML) to a directory

Documentation for bdy v1.25.20

Last modified on Oct 14, 2026

Getting 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$