Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
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.mdxsimilarity index 100%rename from docs/customize/examples/prompting-guide.mdxrename to docs/customize/agent/prompting-guide.mdxdiff --git a/docs/docs.json b/docs/docs.jsonindex 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.mdxnew file mode 100644index 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 filediff --git a/docs/examples/apps/vibetest-use.mdx b/docs/examples/apps/vibetest-use.mdxnew file mode 100644index 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 filediff --git a/docs/customize/examples/fast-agent.mdx b/docs/examples/templates/fast-agent.mdxsimilarity index 100%rename from docs/customize/examples/fast-agent.mdxrename to docs/examples/templates/fast-agent.mdxdiff --git a/docs/customize/examples/follow-up-tasks.mdx b/docs/examples/templates/follow-up-tasks.mdxsimilarity index 100%rename from docs/customize/examples/follow-up-tasks.mdxrename to docs/examples/templates/follow-up-tasks.mdxdiff --git a/docs/customize/examples/more-examples.mdx b/docs/examples/templates/more-examples.mdxsimilarity index 100%rename from docs/customize/examples/more-examples.mdxrename to docs/examples/templates/more-examples.mdxdiff --git a/docs/customize/examples/parallel-browser.mdx b/docs/examples/templates/parallel-browser.mdxsimilarity index 100%rename from docs/customize/examples/parallel-browser.mdxrename to docs/examples/templates/parallel-browser.mdxdiff --git a/docs/customize/examples/playwright-integration.mdx b/docs/examples/templates/playwright-integration.mdxsimilarity index 100%rename from docs/customize/examples/playwright-integration.mdxrename to docs/examples/templates/playwright-integration.mdxdiff --git a/docs/customize/examples/secure.mdx b/docs/examples/templates/secure.mdxsimilarity index 100%rename from docs/customize/examples/secure.mdxrename to docs/examples/templates/secure.mdxdiff --git a/docs/customize/examples/sensitive-data.mdx b/docs/examples/templates/sensitive-data.mdxsimilarity index 100%rename from docs/customize/examples/sensitive-data.mdxrename to docs/examples/templates/sensitive-data.mdx