Browser Markdown Scrape

Convert a URL to Markdown and scrape CSS selectors using Cloudflare Browser Rendering quickAction (REST-style binding — not Puppeteer).

FeaturesCopy Anchor Link

• GET /markdown?url= → page Markdown via quickAction("markdown")
• GET /scrape?url=&selector= → structured elements via quickAction("scrape")
• HTTP/HTTPS URL validation only

API ReferenceCopy Anchor Link

GET /markdownCopy Anchor Link

url string (required)

Target page (http:// or https://).

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/markdown?url=https://example.com"

Success ResponseCopy Anchor Link

{
  "url": "https://example.com/",
  "markdown": "# Example Domain\n\n..."
}

Error CodesCopy Anchor Link

• 400 - Missing or non-http(s) url (INVALID_URL)
• 502 - quickAction failure (MARKDOWN_ERROR)

GET /scrapeCopy Anchor Link

url string (required)

Target page.

selector string (required)

CSS selector (sent as one scrape element).

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/scrape?url=https://example.com&selector=h1"

Success ResponseCopy Anchor Link

{
  "url": "https://example.com/",
  "results": [
    {
      "selector": "h1",
      "results": [{ "text": "Example Domain", "html": "Example Domain" }]
    }
  ]
}

Error CodesCopy Anchor Link

• 400 - Invalid url (INVALID_URL)
• 400 - Missing selector (MISSING_SELECTOR)
• 502 - quickAction failure (SCRAPE_ERROR)

Use CasesCopy Anchor Link

• Normalize pages to Markdown for RAG / LLM pipelines
• Extract specific DOM fields without writing Puppeteer scripts
• Compare quickAction REST bindings vs Puppeteer-based experiments

LimitationsCopy Anchor Link

• Requires Browser Rendering (often wrangler dev --remote locally)
• Single CSS selector per scrape request
• JS-heavy SPAs may need advanced goto options (not exposed in this demo)

DeploymentCopy Anchor Link

curl "https://your-worker.workers.dev/markdown?url=https://example.com"

Local DevelopmentCopy Anchor Link

cd apps/experiments/browser-markdown-scrape
npm install
npm run dev -- --remote

curl "http://localhost:8787/markdown?url=https://example.com"

ConfigurationCopy Anchor Link

• Browser binding BROWSER — uses quickAction("markdown" | "scrape", …)

Cloudflare Features UsedCopy Anchor Link

• Workers - Edge compute runtime
• Browser Rendering - Headless browser at the edge
• Markdown endpoint - URL → Markdown quick action
• Scrape endpoint - CSS selector scrape quick action