Cloudflare Browser Rendering Skill Reference
Description: Expert knowledge for Cloudflare Browser Rendering - control headless Chrome on Cloudflare's global network for browser automation, screenshots, PDFs, web scraping, testing, and content generation.
When to use: Any task involving Cloudflare Browser Rendering including: taking screenshots, generating PDFs, web scraping, browser automation, testing web applications, extracting structured data, capturing page metrics, or automating browser interactions.
Decision Tree
REST API vs Workers Bindings
Use REST API when:
- One-off, stateless tasks (screenshot, PDF, content fetch)
- No Workers infrastructure yet
- Simple integrations from external services
- Need quick prototyping without deployment
Use Workers Bindings when:
- Complex browser automation workflows
- Need session reuse for performance
- Multiple page interactions per request
- Custom scripting and logic required
- Building production applications
Puppeteer vs Playwright
| Feature | Puppeteer | Playwright |
|---|---|---|
| API Style | Chrome DevTools Protocol | High-level abstractions |
| Selectors | CSS, XPath | CSS, text, role, test-id |
| Best for | Advanced control, CDP access | Quick automation, testing |
| Learning curve | Steeper | Gentler |
Use Puppeteer: Need CDP protocol access, Chrome-specific features, migration from existing Puppeteer code Use Playwright: Modern selector APIs, cross-browser patterns, faster development
Tier Limits Summary
| Limit | Free Tier | Paid Tier |
|---|---|---|
| Daily browser time | 10 minutes | Unlimited* |
| Concurrent sessions | 3 | 30 |
| Requests per minute | 6 | 180 |
*Subject to fair-use policy. See gotchas.md for details.
Reading Order
New to Browser Rendering:
- configuration.md - Setup and deployment
- patterns.md - Common use cases with examples
- api.md - API reference
- gotchas.md - Avoid common pitfalls
Specific task:
- Setup/deployment → configuration.md
- API reference/endpoints → api.md
- Example code/patterns → patterns.md
- Debugging/troubleshooting → gotchas.md
REST API users:
- Start with api.md REST API section
- Check gotchas.md for rate limits
Workers users:
- Start with configuration.md
- Review patterns.md for session management
- Reference api.md for Workers Bindings
In This Reference
- configuration.md - Setup, deployment, wrangler config, compatibility
- api.md - REST API endpoints + Workers Bindings (Puppeteer/Playwright)
- patterns.md - Common patterns, use cases, real examples
- gotchas.md - Troubleshooting, best practices, tier limits, common errors