Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Restructure examples docs: move to top-level with templates/apps sections

avocardioe77fbcbd2e0e
diff --git a/docs/customize/examples/prompting-guide.mdx b/docs/customize/agent/prompting-guide.mdx
similarity index 100%
rename from docs/customize/examples/prompting-guide.mdx
rename to docs/customize/agent/prompting-guide.mdx
diff --git a/docs/docs.json b/docs/docs.json
index bab079a3a..38674ef72 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -99,6 +99,7 @@
"pages": [
"customize/agent/basics",
"customize/agent/supported-models",
+ "customize/agent/prompting-guide",
"customize/agent/output-format",
"customize/agent/all-parameters"
]
@@ -126,20 +127,6 @@
"customize/tools/response"
]
},
- {
- "group": "Examples",
- "icon": "folder-open",
- "pages": [
- "customize/examples/fast-agent",
- "customize/examples/follow-up-tasks",
- "customize/examples/parallel-browser",
- "customize/examples/playwright-integration",
- "customize/examples/sensitive-data",
- "customize/examples/secure",
- "customize/examples/more-examples",
- "customize/examples/prompting-guide"
- ]
- },
{
"group": "Integration",
"icon": "plug",
@@ -150,6 +137,32 @@
}
]
},
+ {
+ "group": "Examples",
+ "pages": [
+ {
+ "group": "Templates",
+ "icon": "folder",
+ "pages": [
+ "examples/templates/fast-agent",
+ "examples/templates/follow-up-tasks",
+ "examples/templates/parallel-browser",
+ "examples/templates/playwright-integration",
+ "examples/templates/sensitive-data",
+ "examples/templates/secure",
+ "examples/templates/more-examples"
+ ]
+ },
+ {
+ "group": "Apps",
+ "icon": "box-open",
+ "pages": [
+ "examples/apps/ad-use",
+ "examples/apps/vibetest-use"
+ ]
+ }
+ ]
+ },
{
"group": "Development",
"pages": [
diff --git a/docs/examples/apps/ad-use.mdx b/docs/examples/apps/ad-use.mdx
new file mode 100644
index 000000000..43c453259
--- /dev/null
+++ b/docs/examples/apps/ad-use.mdx
@@ -0,0 +1,65 @@
+---
+title: "Ad Generator (Ad-Use)"
+description: "Generate Instagram ads from landing pages using browser agents and Google's Nano Banana 🍌."
+icon: "image"
+mode: "wide"
+---
+
+<Note>
+This demo requires browser-use v0.7.6+.
+</Note>
+
+## Features
+
+1. Agent visits your target website
+2. Captures brand name, tagline, and key selling points
+3. Takes a clean screenshot for design reference
+4. Creates a scroll-stopping Instagram ad with 🍌
+
+## Setup
+
+Make sure the newest version of browser-use is installed (with screenshot functionality):
+```bash
+pip install -U browser-use
+```
+
+Export your Gemini API key, get it from: [Google AI Studio](https://makersuite.google.com/app/apikey)
+```
+export GOOGLE_API_KEY='your-google-api-key-here'
+```
+
+## Normal Usage
+
+```bash
+# Basic - Generate ad from any website
+python ad_generator.py https://www.apple.com/iphone-16-pro/
+
+# Debug Mode - See the browser in action
+python ad_generator.py https://www.apple.com/iphone-16-pro/ --debug
+```
+
+## Programmatic Usage
+```python
+import asyncio
+from ad_generator import create_ad_from_landing_page
+
+async def main():
+ results = await create_ad_from_landing_page(
+ url="https://your-landing-page.com",
+ debug=False
+ )
+ print(f"Generated ads: {results}")
+
+asyncio.run(main())
+```
+
+## Output
+
+Generated ads are saved in the `output/` directory with:
+- **PNG image files** (ad_style_timestamp.png) - Actual generated ads from Gemini 2.5 Flash Image
+- **Prompt files** (ad_style_timestamp_prompt.txt) - The prompts used for generation
+- **Landing page screenshots** for reference
+
+## Source Code
+
+Full implementation: [https://github.com/browser-use/browser-use/tree/main/examples/apps/ad-use](https://github.com/browser-use/browser-use/tree/main/examples/apps/ad-use)
\ No newline at end of file
diff --git a/docs/examples/apps/vibetest-use.mdx b/docs/examples/apps/vibetest-use.mdx
new file mode 100644
index 000000000..be0e7e260
--- /dev/null
+++ b/docs/examples/apps/vibetest-use.mdx
@@ -0,0 +1,8 @@
+---
+title: "QA-Testing (Vibetest-Use)"
+description: "WIP"
+icon: "vial"
+mode: "wide"
+---
+
+WIP
\ No newline at end of file
diff --git a/docs/customize/examples/fast-agent.mdx b/docs/examples/templates/fast-agent.mdx
similarity index 100%
rename from docs/customize/examples/fast-agent.mdx
rename to docs/examples/templates/fast-agent.mdx
diff --git a/docs/customize/examples/follow-up-tasks.mdx b/docs/examples/templates/follow-up-tasks.mdx
similarity index 100%
rename from docs/customize/examples/follow-up-tasks.mdx
rename to docs/examples/templates/follow-up-tasks.mdx
diff --git a/docs/customize/examples/more-examples.mdx b/docs/examples/templates/more-examples.mdx
similarity index 100%
rename from docs/customize/examples/more-examples.mdx
rename to docs/examples/templates/more-examples.mdx
diff --git a/docs/customize/examples/parallel-browser.mdx b/docs/examples/templates/parallel-browser.mdx
similarity index 100%
rename from docs/customize/examples/parallel-browser.mdx
rename to docs/examples/templates/parallel-browser.mdx
diff --git a/docs/customize/examples/playwright-integration.mdx b/docs/examples/templates/playwright-integration.mdx
similarity index 100%
rename from docs/customize/examples/playwright-integration.mdx
rename to docs/examples/templates/playwright-integration.mdx
diff --git a/docs/customize/examples/secure.mdx b/docs/examples/templates/secure.mdx
similarity index 100%
rename from docs/customize/examples/secure.mdx
rename to docs/examples/templates/secure.mdx
diff --git a/docs/customize/examples/sensitive-data.mdx b/docs/examples/templates/sensitive-data.mdx
similarity index 100%
rename from docs/customize/examples/sensitive-data.mdx
rename to docs/examples/templates/sensitive-data.mdx