1# Cloudflare Browser Rendering Skill Reference
2 
3**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.
4 
5**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.
6 
7## Decision Tree
8 
9### REST API vs Workers Bindings
10 
11**Use REST API when:**
12- One-off, stateless tasks (screenshot, PDF, content fetch)
13- No Workers infrastructure yet
14- Simple integrations from external services
15- Need quick prototyping without deployment
16 
17**Use Workers Bindings when:**
18- Complex browser automation workflows
19- Need session reuse for performance
20- Multiple page interactions per request
21- Custom scripting and logic required
22- Building production applications
23 
24### Puppeteer vs Playwright
25 
26| Feature | Puppeteer | Playwright |
27|---------|-----------|------------|
28| API Style | Chrome DevTools Protocol | High-level abstractions |
29| Selectors | CSS, XPath | CSS, text, role, test-id |
30| Best for | Advanced control, CDP access | Quick automation, testing |
31| Learning curve | Steeper | Gentler |
32 
33**Use Puppeteer:** Need CDP protocol access, Chrome-specific features, migration from existing Puppeteer code
34**Use Playwright:** Modern selector APIs, cross-browser patterns, faster development
35 
36## Tier Limits Summary
37 
38| Limit | Free Tier | Paid Tier |
39|-------|-----------|-----------|
40| Daily browser time | 10 minutes | Unlimited* |
41| Concurrent sessions | 3 | 30 |
42| Requests per minute | 6 | 180 |
43 
44*Subject to fair-use policy. See [gotchas.md](gotchas.md) for details.
45 
46## Reading Order
47 
48**New to Browser Rendering:**
491. [configuration.md](configuration.md) - Setup and deployment
502. [patterns.md](patterns.md) - Common use cases with examples
513. [api.md](api.md) - API reference
524. [gotchas.md](gotchas.md) - Avoid common pitfalls
53 
54**Specific task:**
55- **Setup/deployment** → [configuration.md](configuration.md)
56- **API reference/endpoints** → [api.md](api.md)
57- **Example code/patterns** → [patterns.md](patterns.md)
58- **Debugging/troubleshooting** → [gotchas.md](gotchas.md)
59 
60**REST API users:**
61- Start with [api.md](api.md) REST API section
62- Check [gotchas.md](gotchas.md) for rate limits
63 
64**Workers users:**
65- Start with [configuration.md](configuration.md)
66- Review [patterns.md](patterns.md) for session management
67- Reference [api.md](api.md) for Workers Bindings
68 
69## In This Reference
70 
71- **[configuration.md](configuration.md)** - Setup, deployment, wrangler config, compatibility
72- **[api.md](api.md)** - REST API endpoints + Workers Bindings (Puppeteer/Playwright)
73- **[patterns.md](patterns.md)** - Common patterns, use cases, real examples
74- **[gotchas.md](gotchas.md)** - Troubleshooting, best practices, tier limits, common errors
75 
76## See Also
77 
78- [Cloudflare Docs](https://developers.cloudflare.com/browser-rendering/)
79