# Browser Run

Control and interact with headless browser instances programmatically

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://developers.cloudflare.com/browser-run/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://developers.cloudflare.com/llms.txt).
>
> Use [Browser Run llms-full.txt](https://developers.cloudflare.com/browser-run/llms-full.txt) for the complete Browser Run documentation in a single file, intended for offline indexing, bulk vectorization, or large-context models.

## Overview

- [Browser Run](https://developers.cloudflare.com/browser-run/index.md): Control headless browsers with Cloudflare's Workers Browser Run API. Automate tasks, take screenshots, convert pages to PDFs, and test web apps.

## Get started

- [Get started](https://developers.cloudflare.com/browser-run/get-started/index.md): Choose an integration method and set up your first Browser Run project using Quick Actions, Puppeteer, or Playwright.

## Examples

- [Examples](https://developers.cloudflare.com/browser-run/examples/index.md): Explore Browser Run code examples for Quick Actions, Puppeteer, Playwright, and CDP integrations.

## Quick Actions

- [Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/index.md): Use Browser Run Quick Actions HTTP endpoints to capture screenshots, extract HTML, generate PDFs, and perform other common browser tasks.
- [Reference](https://developers.cloudflare.com/api/resources/browser_rendering/index.md): View the complete Browser Run Quick Actions API reference for all available endpoints and parameters.
- [/content - Fetch HTML](https://developers.cloudflare.com/browser-run/quick-actions/content-endpoint/index.md): Capture fully rendered HTML from a webpage after JavaScript execution using the Browser Run /content endpoint.
- [/crawl - Crawl web content](https://developers.cloudflare.com/browser-run/quick-actions/crawl-endpoint/index.md): Scrape and follow links across a website using the Browser Run /crawl endpoint, with configurable depth and output formats.
- [/json - Capture structured data using AI](https://developers.cloudflare.com/browser-run/quick-actions/json-endpoint/index.md): Extract structured JSON data from webpages using AI with the Browser Run /json endpoint.
- [/links - Retrieve links from a webpage](https://developers.cloudflare.com/browser-run/quick-actions/links-endpoint/index.md): Extract all links from a webpage, including hidden ones, using the Browser Run /links endpoint.
- [/markdown - Extract Markdown from a webpage](https://developers.cloudflare.com/browser-run/quick-actions/markdown-endpoint/index.md): Convert webpage content to Markdown format using the Browser Run /markdown endpoint.
- [/pdf - Render PDF](https://developers.cloudflare.com/browser-run/quick-actions/pdf-endpoint/index.md): Generate a PDF from a webpage or custom HTML using the Browser Run /pdf endpoint.
- [/scrape - Scrape HTML elements](https://developers.cloudflare.com/browser-run/quick-actions/scrape-endpoint/index.md): Extract structured data from specific webpage elements using the Browser Run /scrape endpoint.
- [/screenshot - Capture screenshot](https://developers.cloudflare.com/browser-run/quick-actions/screenshot-endpoint/index.md): Capture a screenshot of a fully rendered webpage using the Browser Run /screenshot endpoint.
- [/snapshot - Take a webpage snapshot](https://developers.cloudflare.com/browser-run/quick-actions/snapshot/index.md): Capture both HTML content and a screenshot of a webpage in a single Browser Run /snapshot request.

## Chrome DevTools Protocol (CDP)

- [Chrome DevTools Protocol (CDP)](https://developers.cloudflare.com/browser-run/cdp/index.md): Create persistent browser sessions, manage tabs, and interact with browsers using Chrome DevTools Protocol (CDP) commands via the /devtools endpoints.
- [Using with MCP clients (CDP)](https://developers.cloudflare.com/browser-run/cdp/mcp-clients/index.md): Configure AI coding agents to control Browser Run sessions through the Model Context Protocol (MCP) using the chrome-devtools-mcp package.
- [Using with Playwright (CDP)](https://developers.cloudflare.com/browser-run/cdp/playwright/index.md): Connect Playwright to Browser Run sessions from any Node.js environment to automate browser tasks using the Chrome DevTools Protocol.
- [Using with Puppeteer (CDP)](https://developers.cloudflare.com/browser-run/cdp/puppeteer/index.md): Connect Puppeteer to Browser Run sessions from any Node.js environment to automate browser tasks using the Chrome DevTools Protocol.
- [Session management (HTTP)](https://developers.cloudflare.com/browser-run/cdp/session-management/index.md): Manage browser sessions and tabs using HTTP endpoints, including creating sessions, listing targets, and opening the Chrome DevTools UI.

## Playwright

- [Playwright](https://developers.cloudflare.com/browser-run/playwright/index.md): Learn how to use Playwright with Cloudflare Workers for browser automation. Access Playwright API, manage sessions, and optimize Browser Run.
- [Playwright MCP](https://developers.cloudflare.com/browser-run/playwright/playwright-mcp/index.md): Deploy a Playwright MCP server that uses Browser Run to provide browser automation capabilities to your agents.

## Puppeteer

- [Puppeteer](https://developers.cloudflare.com/browser-run/puppeteer/index.md): Learn how to use Puppeteer with Cloudflare Workers for browser automation. Access Puppeteer API, manage sessions, and optimize Browser Run.

## Stagehand

- [Stagehand](https://developers.cloudflare.com/browser-run/stagehand/index.md): Deploy a Stagehand server that uses Browser Run to provide browser automation capabilities to your agents.

## FAQ

- [FAQ](https://developers.cloudflare.com/browser-run/faq/index.md): Find answers to frequently asked questions about Browser Run, including errors, troubleshooting, and session management.

## Limits

- [Limits](https://developers.cloudflare.com/browser-run/limits/index.md): Learn about the limits associated with Browser Run.

## Pricing

- [Pricing](https://developers.cloudflare.com/browser-run/pricing/index.md): Understand Browser Run pricing for Quick Actions and Browser Sessions, including browser hours and concurrent browser costs.

## Changelog

- [Changelog](https://developers.cloudflare.com/browser-run/changelog/index.md): Review recent changes to Browser Run.

## features

- [Custom fonts](https://developers.cloudflare.com/browser-run/features/custom-fonts/index.md): Learn how to add custom fonts to Browser Run for use in screenshots and PDFs.
- [Human in the Loop](https://developers.cloudflare.com/browser-run/features/human-in-the-loop/index.md): Temporarily hand off browser control to a human operator for authentication, sensitive actions, or tasks that are difficult to fully automate.
- [Live View](https://developers.cloudflare.com/browser-run/features/live-view/index.md): View and interact with remote Browser Run sessions in real time using the hosted DevTools UI or native Chrome DevTools.
- [Reuse sessions](https://developers.cloudflare.com/browser-run/features/reuse-sessions/index.md): Improve Browser Run performance by reconnecting to existing browser sessions instead of launching new instances.
- [Session recording](https://developers.cloudflare.com/browser-run/features/session-recording/index.md): Record and replay Browser Run sessions to visually debug browser automation scripts.
- [WebMCP](https://developers.cloudflare.com/browser-run/features/webmcp/index.md): Use WebMCP to let AI agents discover and execute structured tools exposed by websites, replacing fragile screenshot-analyze-click loops with direct function calls.

## how-to

- [Deploy a Browser Run Worker with Durable Objects](https://developers.cloudflare.com/browser-run/how-to/browser-run-with-do/index.md): Use the Browser Run API along with Durable Objects to take screenshots from web pages and store them in R2.
- [Deploy a Browser Run Worker](https://developers.cloudflare.com/browser-run/how-to/deploy-worker/index.md): Create and deploy a Cloudflare Worker that uses Browser Run to take screenshots from web pages.
- [Generate OG images for Astro sites](https://developers.cloudflare.com/browser-run/how-to/og-images-astro/index.md): Use Browser Run to automatically generate Open Graph social preview images for your Astro site pages.
- [Generate PDFs Using HTML and CSS](https://developers.cloudflare.com/browser-run/how-to/pdf-generation/index.md): Generate PDF documents from web pages or custom HTML and CSS using Browser Run with Puppeteer or Quick Actions.
- [Build a web crawler with Queues and Browser Run](https://developers.cloudflare.com/queues/tutorials/web-crawler-with-browser-run/index.md): Build a scalable web crawler that uses Cloudflare Queues and Browser Run to process URLs asynchronously.

## reference

- [Automatic request headers](https://developers.cloudflare.com/browser-run/reference/automatic-request-headers/index.md): Review the headers Cloudflare automatically attaches to every Browser Run request, including User-Agent and bot detection identifiers.
- [Browser close reasons](https://developers.cloudflare.com/browser-run/reference/browser-close-reasons/index.md): Identify why a Browser Run session closed and review common close reason codes in the dashboard.
- [robots.txt and sitemaps](https://developers.cloudflare.com/browser-run/reference/robots-txt/index.md): Configure robots.txt rules and sitemaps to control how Browser Run accesses your website.
- [Supported fonts](https://developers.cloudflare.com/browser-run/reference/supported-fonts/index.md): View the list of pre-installed fonts available in the Browser Run Chromium environment for screenshots and PDFs.
- [Quick Actions timeouts](https://developers.cloudflare.com/browser-run/reference/timeouts/index.md): Configure Browser Run Quick Actions timeout settings for page load, selector wait, and action execution.
- [Wrangler](https://developers.cloudflare.com/browser-run/reference/wrangler/index.md): Use Wrangler, a command-line tool, to deploy projects using Cloudflare's Workers Browser Run API.
- [Wrangler commands](https://developers.cloudflare.com/browser-run/reference/wrangler-commands/index.md): Manage Browser Run sessions from the command line using Wrangler.