{
  "markdown": "<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"./static/browser-use-dark.png\">\n  <source media=\"(prefers-color-scheme: light)\" srcset=\"./static/browser-use.png\">\n  <img alt=\"Shows a black Browser Use Logo in light color mode and a white one in dark color mode.\" src=\"./static/browser-use.png\"  width=\"full\">\n</picture>\n\n<h1 align=\"center\">Enable AI to control your browser</h1>\n\n[![Docs](https://img.shields.io/badge/Docs-📕-blue?style=for-the-badge)](https://docs.browser-use.com)\n[![Browser-use cloud](https://img.shields.io/badge/Browser_Use_Cloud-☁️-blue?style=for-the-badge&logo=rocket&logoColor=white)](https://cloud.browser-use.com)\n\n[![Discord](https://img.shields.io/discord/1303749220842340412?color=7289DA&label=Discord&logo=discord&logoColor=white)](https://link.browser-use.com/discord)\n[![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)\n[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00)\n[![Merch store](https://img.shields.io/badge/Merch_store-👕-blue)](https://browsermerch.com)\n[![Weave Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fapp.workweave.ai%2Fapi%2Frepository%2Fbadge%2Forg_T5Pvn3UBswTHIsN1dWS3voPg%2F881458615&labelColor=#EC6341)](https://app.workweave.ai/reports/repository/org_T5Pvn3UBswTHIsN1dWS3voPg/881458615)\n\n\n\n\n\n<!-- Keep these links. Translations will automatically update with the README. -->\n[Deutsch](https://www.readme-i18n.com/browser-use/browser-use?lang=de) |\n[Español](https://www.readme-i18n.com/browser-use/browser-use?lang=es) |\n[français](https://www.readme-i18n.com/browser-use/browser-use?lang=fr) |\n[日本語](https://www.readme-i18n.com/browser-use/browser-use?lang=ja) |\n[한국어](https://www.readme-i18n.com/browser-use/browser-use?lang=ko) |\n[Português](https://www.readme-i18n.com/browser-use/browser-use?lang=pt) |\n[Русский](https://www.readme-i18n.com/browser-use/browser-use?lang=ru) |\n[中文](https://www.readme-i18n.com/browser-use/browser-use?lang=zh)\n\n\n# 🤖 Quickstart\n\nWith uv (Python>=3.11):\n\n```bash\n#  We ship every day - use the latest version!\nuv pip install browser-use\n```\n\nDownload chromium using playwright's shortcut:\n\n```bash\nuvx playwright install chromium --with-deps --no-shell\n```\n\nCreate a `.env` file and add your API key. Don't have one? Start with a [free Gemini key](https://aistudio.google.com/app/u/1/apikey?pli=1).\n\n```bash\nGEMINI_API_KEY=\n```\n\nRun your first agent:\n\n```python\nfrom browser_use import Agent, ChatGoogle\nfrom dotenv import load_dotenv\nload_dotenv()\n\nagent = Agent(\n    task=\"Find the number of stars of the browser-use repo\",\n    llm=ChatGoogle(model=\"gemini-flash-latest\"),\n    # browser=Browser(use_cloud=True),  # Uses Browser-Use cloud for the browser\n)\nagent.run_sync()\n```\n\nCheck out the [library docs](https://docs.browser-use.com) and [cloud docs](https://docs.cloud.browser-use.com) for more settings.\n\n\n## Stealth Browser Infrastructure\n\nWant to bypass Cloudflare, or any other anti-bot protection?\n\nSimply go to [Browser Use Cloud](https://docs.cloud.browser-use.com) grab a `BROWSER_USE_API_KEY` and use the `use_cloud` parameter.\n\n```python\nfrom browser_use import Agent, Browser, ChatOpenAI\n\n# Use Browser-Use cloud browser service\nbrowser = Browser(\n    use_cloud=True,  # Automatically provisions a cloud browser\n)\n\nagent = Agent(\n    task=\"Your task here\",\n    llm=ChatOpenAI(model='gpt-4.1-mini'),\n    browser=browser,\n)\n```\n\n\n\n# Demos\n\n[Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/shopping.py): Add grocery items to cart, and checkout.\n\n[![AI Did My Groceries](https://github.com/user-attachments/assets/a0ffd23d-9a11-4368-8893-b092703abc14)](https://www.youtube.com/watch?v=L2Ya9PYNns8)\n\n<br/><br/>\n\n\n[Task](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/find_and_apply_to_jobs.py): Read my CV & find ML jobs, save them to a file, and then start applying for them in new tabs, if you need help, ask me.\n\nhttps://github.com/user-attachments/assets/171fb4d6-0355-46f2-863e-edb04a828d04\n\n<br/><br/>\n\nSee [more examples](https://docs.browser-use.com/examples) and give us a star!\n\n\n<br/><br/>\n## MCP Integration\n\nThis gives Claude Desktop access to browser automation tools for web scraping, form filling, and more. See the [MCP docs](https://docs.browser-use.com/customize/mcp-server).\n```json\n{\n  \"mcpServers\": {\n    \"browser-use\": {\n      \"command\": \"uvx\",\n      \"args\": [\"browser-use[cli]\", \"--mcp\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"sk-...\"\n      }\n    }\n  }\n}\n```\n\n<div align=\"center\">\n  \n**Tell your computer what to do, and it gets it done.**\n\n<img src=\"https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f\" width=\"400\"/>\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/Magnus?style=social)](https://x.com/intent/user?screen_name=mamagnus00)\n[![Twitter Follow](https://img.shields.io/twitter/follow/Gregor?style=social)](https://x.com/intent/user?screen_name=gregpr07)\n\n</div>\n\n<div align=\"center\">\nMade with ❤️ in Zurich and San Francisco\n </div>\n",
  "bytes": 5151,
  "sha": "78c76b6e9e725aea841fb6f864196850f0f0ad9735997fd634f9dba0ecc11e07",
  "repo_slug": "therealtimex/browser-use",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_therealtimex_browser_use_d7a73795/readme"
}