Skip to content

Commit a6f1c6e

Browse files
authored
Move integration methods below use cases, extract to partial, update get-started page (#28753)
1 parent a63431b commit a6f1c6e

3 files changed

Lines changed: 29 additions & 29 deletions

File tree

src/content/docs/browser-rendering/get-started.mdx

Lines changed: 7 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,12 @@ sidebar:
66
---
77
import { Render } from "~/components";
88

9-
Cloudflare Browser Rendering allows you to programmatically control a headless browser, enabling you to do things like take screenshots, generate PDFs, and perform automated browser tasks.
9+
Cloudflare Browser Rendering allows you to programmatically control a headless browser, enabling you to do things like take screenshots, generate PDFs, and perform automated browser tasks. This guide will help you choose the right integration method and get you started with your first project.
1010

11-
There are two ways to use Browser Rendering:
12-
- [REST API](/browser-rendering/rest-api/) for simple, one-off actions, like taking a screenshot, fetching HTML, or generating a PDF.
13-
- [Workers Bindings](/browser-rendering/workers-bindings/) for more complex, multi-step browser automation using [Puppeteer](/browser-rendering/puppeteer/) and [Playwright](/browser-rendering/playwright/).
14-
15-
This guide will help you choose the right path for your needs and get you started with your first Browser Rendering project.
11+
<Render file="integration-methods" product="browser-rendering" />
1612

1713
## REST API
1814

19-
The REST API is best for situations where you have an existing application and want to perform simple, stateless browser actions.
20-
2115
### Prerequisites
2216
- Sign up for a [Cloudflare account](https://dash.cloudflare.com/sign-up/workers-and-pages).
2317
- Create a [Cloudflare API Token](/fundamentals/api/get-started/create-token/) with `Browser Rendering - Edit` permissions.
@@ -33,12 +27,10 @@ The REST API can also be used to:
3327

3428
- [Fetch HTML](/browser-rendering/rest-api/content-endpoint/)
3529
- [Generate a PDF](/browser-rendering/rest-api/pdf-endpoint/)
36-
- [and more...](/browser-rendering/rest-api/)
30+
- [Explore all REST API endpoints](/browser-rendering/rest-api/)
3731

3832
## Workers Bindings
3933

40-
Workers Bindings are best for situations where you need to build more complex, multi-step browser automation workflows. You can use familiar tools like [Puppeteer](/browser-rendering/puppeteer/) and [Playwright](/browser-rendering/playwright/).
41-
4234
### Prerequisites
4335
<Render file="prereqs" product="workers" />
4436

@@ -49,9 +41,10 @@ Workers Bindings are best for situations where you need to build more complex, m
4941
product="browser-rendering"
5042
/>
5143

52-
## Next Steps
53-
If you have any feature requests or notice any bugs, share your feedback directly with the Cloudflare team by joining the [Cloudflare Developers community on Discord](https://discord.cloudflare.com/).
44+
## Next steps
5445

5546
- Check out all the [REST API endpoints](/browser-rendering/rest-api/)
5647
- Try out the [Playwright MCP](/browser-rendering/playwright/playwright-mcp/)
57-
- Learn more about Browser Rendering [limits](/browser-rendering/limits/) and [pricing](/browser-rendering/pricing/).
48+
- Learn more about Browser Rendering [limits](/browser-rendering/limits/) and [pricing](/browser-rendering/pricing/)
49+
50+
If you have any feature requests or notice any bugs, share your feedback directly with the Cloudflare team by joining the [Cloudflare Developers community on Discord](https://discord.cloudflare.com/).

src/content/docs/browser-rendering/index.mdx

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ import {
1515
LinkTitleCard,
1616
Plan,
1717
RelatedProduct,
18+
Render,
1819
AstroIcon,
1920
} from "~/components";
2021

@@ -40,6 +41,10 @@ Programmatically load and fully render dynamic webpages or raw HTML and capture
4041
- [HTML elements](/browser-rendering/rest-api/scrape-endpoint/)
4142
- [Structured data](/browser-rendering/rest-api/json-endpoint/)
4243

44+
## Integration methods
45+
46+
<Render file="integration-methods" product="browser-rendering" />
47+
4348
## Key features
4449

4550
- **Scale to thousands of browsers**: Instant access to a global pool of browsers with low cold-start time, ideal for high-volume screenshot generation, data extraction, or automation at scale
@@ -48,21 +53,6 @@ Programmatically load and fully render dynamic webpages or raw HTML and capture
4853
- **Session management**: [Reuse browser sessions](/browser-rendering/workers-bindings/reuse-sessions/) across requests to improve performance and reduce cold-start overhead
4954
- **Flexible pricing**: Pay only for browser time used with generous free tier ([view pricing](/browser-rendering/pricing/))
5055

51-
## Integration methods
52-
53-
- **[REST API](/browser-rendering/rest-api/)**: Simple HTTP endpoints for stateless tasks like screenshots, PDFs, and scraping.
54-
- **[Workers Bindings](/browser-rendering/workers-bindings/)**: Full browser automation within Workers using [Puppeteer](/browser-rendering/puppeteer/), [Playwright](/browser-rendering/playwright/), or [Stagehand](/browser-rendering/stagehand/).
55-
56-
| Use case | Recommended | Why |
57-
| --- | --- | --- |
58-
| Simple screenshot, PDF, or scrape | [REST API](/browser-rendering/rest-api/) | No code deployment; single HTTP request |
59-
| Browser automation | [Playwright](/browser-rendering/playwright/) | Full control with built-in tracing and assertions |
60-
| Porting existing scripts | [Puppeteer](/browser-rendering/puppeteer/) or [Playwright](/browser-rendering/playwright/) | Minimal code changes from standard libraries |
61-
| AI-powered data extraction | [JSON endpoint](/browser-rendering/rest-api/json-endpoint/) | Structured data via natural language prompts |
62-
| AI agent browsing | [Playwright MCP](/browser-rendering/playwright/playwright-mcp/) | LLMs control browsers via MCP |
63-
| Resilient scraping | [Stagehand](/browser-rendering/stagehand/) | AI finds elements by intent, not selectors |
64-
65-
6656
## Related products
6757

6858
<RelatedProduct header="Workers" href="/workers/" product="workers">
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
{}
3+
---
4+
5+
Browser Rendering offers multiple integration methods depending on your use case:
6+
7+
- **[REST API](/browser-rendering/rest-api/)**: Simple HTTP endpoints for stateless tasks like screenshots, PDFs, and scraping.
8+
- **[Workers Bindings](/browser-rendering/workers-bindings/)**: Full browser automation within Workers using [Puppeteer](/browser-rendering/puppeteer/), [Playwright](/browser-rendering/playwright/), or [Stagehand](/browser-rendering/stagehand/).
9+
10+
| Use case | Recommended | Why |
11+
| --- | --- | --- |
12+
| Simple screenshot, PDF, or scrape | [REST API](/browser-rendering/rest-api/) | No code deployment; single HTTP request |
13+
| Browser automation | [Playwright](/browser-rendering/playwright/) | Full control with built-in tracing and assertions |
14+
| Porting existing scripts | [Puppeteer](/browser-rendering/puppeteer/) or [Playwright](/browser-rendering/playwright/) | Minimal code changes from standard libraries |
15+
| AI-powered data extraction | [JSON endpoint](/browser-rendering/rest-api/json-endpoint/) | Structured data via natural language prompts |
16+
| AI agent browsing | [Playwright MCP](/browser-rendering/playwright/playwright-mcp/) | LLMs control browsers via MCP |
17+
| Resilient scraping | [Stagehand](/browser-rendering/stagehand/) | AI finds elements by intent, not selectors |

0 commit comments

Comments
 (0)