Cloudflare /crawl Endpoint
One API call crawls an entire site and returns clean content in HTML, Markdown, or plaintext - no scripts, no browser management, no scraping infrastructure.
What It Is
Cloudflare's /crawl endpoint is a managed crawling API built on top of their Browser Rendering product. A single POST request crawls an entire domain, following links and extracting content, then returns structured output in the format you specify. It handles JavaScript rendering, pagination, and link traversal internally - the caller gets clean content without managing headless browsers, proxy rotation, or rate limiting.
The current endpoint is an asynchronous crawl job with HTML, Markdown, or JSON output. render: true uses a headless browser for JavaScript-dependent pages; render: false uses a faster static fetch on Workers. Scope, depth, limit, include/exclude patterns, headers, cookies, and authentication must be explicit in the run receipt. Markdown is useful for ingestion, but it is not proof that every page, script-rendered state, or protected route was captured. Source: Cloudflare Browser Rendering /crawl docs, reviewed 2026-08-12
The reviewed local artifact shows the concrete API shape: a POST to https://api.cloudflare.com/client/v4/accounts/{account_id}/browser-rendering/crawl with bearer token auth and a JSON body containing the target url. That makes this a Cloudflare-account API route, not a general anonymous crawl primitive. Source: local X image artifact, 2026-06-30
Robots and operator controls: Cloudflare emphasized /crawl respects robots.txt, self-identifies as a bot, cannot bypass Cloudflare bot detection or CAPTCHAs, and honors AI Crawl Control, Content Signals, and Pay-Per-Crawl. The current API also exposes crawl-purpose controls. Preserve the requested purpose, robots/content-signal outcome, scope, credentials used, job ID, completion status, and page/error counts with every source receipt. Source: X/@CloudflareDev thread, 2026-03-11; Cloudflare docs, reviewed 2026-08-12
Relevance to Kevin's Stack
This fills a specific gap in the Agent Operations Skills toolkit. Currently, the wiki's ingestion pipeline uses Jina Reader for single-page extraction and Firecrawl for multi-page crawls in cloud automations. Cloudflare /crawl provides a middle option: multi-page crawling without Firecrawl's per-page pricing, backed by Cloudflare's existing infrastructure (Workers + Browser Rendering). For source-compile automation runs that need to ingest documentation sites or multi-page references, this is a lower-cost alternative to Firecrawl.
It also complements Defuddle - Web Content Extraction (local single-page extraction) and Autobrowse (Browserbase Skills) (browser-based site learning). The hierarchy for multi-page crawling becomes: Firecrawl MCP for cloud automations → Cloudflare /crawl for bulk site ingestion → Jina Reader for single pages → defuddle as local fallback.
Do not use /crawl to bypass site controls. The source thread explicitly says it respects robots.txt, cannot bypass Cloudflare bot detection or CAPTCHAs, and self-identifies as a bot. For Kevin's wiki/source-compile pipeline, this is strongest for documentation sites and owned/allowed sources where Cloudflare account auth, API scopes, and crawl costs are acceptable.
Signal
- 19,837 likes, 25,545 bookmarks on X - extremely high engagement, indicating strong developer demand for managed crawling APIs
- Announcement from @CloudflareDev (official account), signaling production-grade reliability
Timeline
- 2026-08-12 | Rechecked the live API contract: asynchronous jobs, browser-rendered versus static-fetch modes, explicit scope/depth/limits/filters, credentialed headers and cookies, and crawl-purpose/content-signal receipts. Source: Cloudflare Browser Rendering
/crawldocs - 2026-03-10 | Cloudflare announces /crawl endpoint for Browser Rendering. "One API call and an entire site crawled." 19,837 likes, 25,545 bookmarks (#10 in corpus). Thread covers job polling, RAG/training use cases, and robots.txt best practices. Source: X/@CloudflareDev, 2026-03-10
- 2026-05-17 | Added to wiki tool registry. Source: X bookmark absorption, 2026-05-17
- 2026-06-12 | Top-25 absorption enriched self-thread (robots.txt, Pay-Per-Crawl). Source: x-bookmark-absorb, 2026-06-12
- 2026-06-30 | Deep-reviewed the local API artifact and official docs. Added the account-scoped
browser-rendering/crawlPOST shape and reinforced robots/operator-control constraints. Source: Cloudflare docs, 2026-06-30