{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_u9xksbqe9cza","handle":"gsearch-mcp","url":"https://wellknown.network/agents/gsearch-mcp","links":{"self":"https://wellknown.network/agents/gsearch-mcp/record.json","html":"https://wellknown.network/agents/gsearch-mcp","markdown":"https://wellknown.network/agents/gsearch-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gsearch-mcp","status":"https://wellknown.network/api/v1/agents/gsearch-mcp/status","claim":"https://wellknown.network/agents/gsearch-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gsearch-mcp/claim.json","badge":"https://wellknown.network/agents/gsearch-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/gsearch-mcp/history","tools":"https://wellknown.network/api/v1/agents/gsearch-mcp/tools"},"ard":{"identifier":"urn:air::server:gsearch-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gsearch-mcp","summary":"MCP tools over Google Search through a dedicated logged-in browser profile: personalized organic results, ads stripped, the full advanced-operator surface, and pagination","description":"# google-search-mcp\n\nMCP tools over Google Search, through a dedicated logged-in browser profile. Personalized\norganic results, ads stripped, the full advanced-operator surface, and pagination.\n\nPublished on PyPI as **`gsearch-mcp`** (`google-search-mcp` was already taken, by an\nunrelated Custom Search API wrapper). Import package and repo keep the longer name.\n\nThree-layer shape: all site knowledge in `client.py`, a CLI that mirrors the tools 1:1 as the\ndebugging surface, and a thin MCP wrapper.\n\n## Why this exists\n\nNo official Google Search API serves this intent. The Custom Search JSON API returns results\nfrom a *configured subset* of the web with no personalization, is **closed to new customers**,\nand **sunsets 1 Jan 2027**. That is a §0 Q1 negative on all three sub-questions.\n\nWhat you get that a keyword search API does not:\n\n- **The advanced-operator surface** — `site:`, `filetype:`, exact phrase, exclusions,\n  `before:`/`after:` bounds, freshness windows down to the **past hour**, **verbatim**\n  (no synonyms or stemming), every Google vertical, region and language bias. All\n  server-side, all free once the transport works. This is the strongest reason to use it;\n  no keyword API has an equivalent.\n- **Better sources on technical queries.** Measured head-to-head against the harness\n  `WebSearch` and the Brave API on `MCP stateless server migration`: this returned the\n  Google and Cloudflare engineering blogs, the spec's own GitHub issue and the Spring\n  docs, where both alternatives returned a page of SEO blogspam paraphrasing the same\n  announcement. Full comparison in `docs/ROADMAP.md`.\n- **Personalized ranking.** Measured at **~3.4× the run-to-run noise floor**: disabling it moved\n  roughly a third of the top-10. Qualitatively it resolves ambiguous technical queries toward the\n  domain sense — `spring` returns Spring Framework rather than the film, `mcp server` returns\n  Cloudflare's engineering blog rather than a content farm. Full method and caveats in\n …","publisher":null,"homepage":"https://github.com/esinecan/google-search-mcp","repository":"https://github.com/esinecan/google-search-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["agent","google","mcp","model-context-protocol","playwright","search"],"pricing":null,"endpoints":[{"url":"pypi:gsearch-mcp","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":1,"provenance":"declared"},{"slug":"data.web-search","name":"Web Search","confidence":0.894,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["data","dev","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","registry":"pypi","observedAt":"2026-10-28T02:26:47.439Z","publishedAt":"2026-08-09T09:54:26.531191Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gsearch-mcp","url":"https://pypi.org/project/gsearch-mcp/","firstSeenAt":"2026-09-09T16:25:08.827Z","fetchedAt":"2026-10-28T02:25:17.039Z","normalizedAt":"2026-10-28T02:25:17.039Z"}]},"firstSeenAt":"2026-09-09T16:25:08.827Z","updatedAt":"2026-10-28T02:26:47.439Z"}