{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_55t5kf6u729c","handle":"gsearch-mcp-cli","url":"https://wellknown.network/agents/gsearch-mcp-cli","links":{"self":"https://wellknown.network/agents/gsearch-mcp-cli/record.json","html":"https://wellknown.network/agents/gsearch-mcp-cli","markdown":"https://wellknown.network/agents/gsearch-mcp-cli/record.md","api":"https://wellknown.network/api/v1/agents/gsearch-mcp-cli","status":"https://wellknown.network/api/v1/agents/gsearch-mcp-cli/status","claim":"https://wellknown.network/agents/gsearch-mcp-cli/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gsearch-mcp-cli/claim.json","badge":"https://wellknown.network/agents/gsearch-mcp-cli/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/gsearch-mcp-cli/history","tools":"https://wellknown.network/api/v1/agents/gsearch-mcp-cli/tools"},"ard":{"identifier":"urn:air::server:gsearch-mcp-cli","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gsearch-mcp-cli","summary":"Google Search CLI and MCP server for AI agents","description":"# gsearch-mcp-cli\n\nGoogle Search CLI and MCP server for AI agents. Search Google (regular + AI Mode), fetch web pages as Markdown, with time filtering. No Google account needed.\n\n## Vibe Coding Alert\n\nFull transparency: this project was built by a non-developer using AI coding assistants. If you're an experienced Python developer, you might look at this codebase and wince. That's okay.\n\nThe goal here was to learn — both about building CLI tools in Python and about how modern web applications work under the hood. The code works, but it's very much a learning project released solely for the purpose of research and education, not a polished product.\n\n> [!WARNING]\n> **Unofficial & Unsupported** — This project is **not affiliated with, endorsed by, or supported by Google**. It interacts with Google Search and Google AI Mode through unofficial, undocumented methods that may break at any time without notice if Google changes their internal behavior, DOM structure, or bot detection. Use at your own risk. The author(s) accept no responsibility for any consequences, including but not limited to rate limiting or IP blocking. This project is released strictly for **educational and research purposes only**.\n\n**If you know better, teach us.** PRs, issues, and architectural advice are all welcome. This is open source specifically because human expertise is irreplaceable.\n\n## Install\n\n### pip\n\n```bash\npip install gsearch-mcp-cli\n```\n\n### uv\n\n```bash\nuv tool install gsearch-mcp-cli\n```\n\n### pipx\n\n```bash\npipx install gsearch-mcp-cli\n```\n\n### Run without installing (uvx)\n\n```bash\nuvx --from gsearch-mcp-cli gsearch \"your query\"\n```\n\n**Requirements:** A Chromium-based browser (Chrome, Brave, Edge, Chromium, Vivaldi, or Opera).\n\n## Quick Start\n\n```bash\ngsearch setup                              # one-time profile warmup (~8s)\ngsearch \"what is kubernetes\"               # search Google\ngsearch \"AI news\" --time day               # last 24 hours\ngsearch \"breaking news\" --time 1h          #…","publisher":null,"homepage":"https://github.com/jacob-bd/gsearch-mcp-cli","repository":"https://github.com/jacob-bd/gsearch-mcp-cli/blob/main/CHANGELOG.md","version":"0.1.8","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:gsearch-mcp-cli","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":0.791,"provenance":"derived"}],"categories":["infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"gsearch-mcp-cli","registry":"pypi","observedAt":"2026-11-09T06:27:51.391Z","publishedAt":"2026-10-09T23:38:29.115756Z","latestVersion":"0.1.8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gsearch-mcp-cli","url":"https://pypi.org/project/gsearch-mcp-cli/","firstSeenAt":"2026-09-09T16:25:09.086Z","fetchedAt":"2026-11-09T06:26:31.247Z","normalizedAt":"2026-11-09T06:26:31.247Z"}]},"firstSeenAt":"2026-09-09T16:25:09.086Z","updatedAt":"2026-11-09T06:27:51.391Z"}