{"id":51333841,"url":"https://github.com/browserless/gemini-extension","last_synced_at":"2026-07-02T01:03:26.356Z","repository":{"id":368300322,"uuid":"1191856611","full_name":"browserless/gemini-extension","owner":"browserless","description":"A Gemini CLI extension that gives Gemini direct access to the REST APIs","archived":false,"fork":false,"pushed_at":"2026-06-29T23:36:54.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T01:19:26.473Z","etag":null,"topics":["gemini-cli-extension"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browserless.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T16:47:29.000Z","updated_at":"2026-06-29T23:36:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/browserless/gemini-extension","commit_stats":null,"previous_names":["browserless/gemini-extension"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/browserless/gemini-extension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserless%2Fgemini-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserless%2Fgemini-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserless%2Fgemini-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserless%2Fgemini-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browserless","download_url":"https://codeload.github.com/browserless/gemini-extension/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserless%2Fgemini-extension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35028649,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gemini-cli-extension"],"created_at":"2026-07-02T01:03:25.424Z","updated_at":"2026-07-02T01:03:26.347Z","avatar_url":"https://github.com/browserless.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Browserless Extension for Gemini CLI\n\nA Gemini CLI extension that connects Gemini to [Browserless.io](https://browserless.io) through the hosted **Browserless MCP server**. It gives Gemini an interactive web agent plus scraping, web search, crawling, site mapping, custom Puppeteer, Lighthouse audits, and export — all from natural language, with no local browser infrastructure to manage.\n\n## Installation\n\nClone the repo and link the extension:\n\n```bash\ngit clone https://github.com/browserless/gemini-extension.git\ncd gemini-extension\ngemini extensions link .\n```\n\n## Setup\n\n### 1. Get a Browserless API token\n\nSign up for free at [browserless.io](https://www.browserless.io) and grab your API token.\n\n### 2. Configure the token\n\nWhen you enable the extension, Gemini CLI prompts for the **API Token** setting and stores it as `BROWSERLESS_TOKEN`. Alternatively, set it in your shell before launching:\n\n```bash\nexport BROWSERLESS_TOKEN=your-token-here\n```\n\nThe token is sent as a `Bearer` header to `https://mcp.browserless.io/mcp`. That's the whole setup — the browser tools are served over MCP and appear automatically.\n\n### 3. Start using it\n\nJust ask. Gemini picks the right tool:\n\n```\nGo to news.ycombinator.com, open the top story, and summarize the linked article.\nTake a screenshot of https://example.com.\nFind recent AI news from the last week.\nCrawl https://browserless.io and list every page.\n```\n\n## Tools\n\nThese are exposed by the Browserless MCP server (the live set is loaded from the server at runtime):\n\n| Tool | Description |\n|------|-------------|\n| `browserless_agent` | Interactive web agent — drives a persistent browser session through a multi-step ReAct loop (navigate, click, type, snapshot). Handles multi-tab workflows, captcha solving, residential proxies, and file upload/download. |\n| `browserless_skill` | On-demand recipes for tricky page mechanics (cookie banners, modals, shadow DOM, dynamic content). Companion to the agent. |\n| `browserless_smartscraper` | Scrape a page with cascading strategies (HTTP fetch → proxy → headless browser → captcha solving). Returns markdown, HTML, or links. |\n| `browserless_search` | Structured web, news, and image search. |\n| `browserless_crawl` | Follow links from a seed URL to a configurable depth, scraping each page. |\n| `browserless_map` | Discover every URL on a site (sitemaps, pages, subdomains). |\n| `browserless_function` | Run custom Puppeteer JavaScript in a cloud browser. |\n| `browserless_performance` | Lighthouse audit (performance, accessibility, best practices, SEO). |\n| `browserless_export` | Export a page in its native format, optionally bundling assets into a ZIP. |\n\n## Extension Structure\n\n```\ngemini-extension/\n  gemini-extension.json     # Manifest — MCP server pointer + token setting\n  GEMINI.md                 # Context loaded at session start\n```\n\n## License\n\nSSPL-1.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserless%2Fgemini-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserless%2Fgemini-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserless%2Fgemini-extension/lists"}