{
  "$schema_doc": "https://gtmstacker.com/registry/schema/entry.schema.json",
  "stability": "emerging",
  "generator": "agentic-media-registry",
  "generated_at": "2026-10-23T00:00:00Z",
  "id": "com.gtmstacker.registry/tool/gsearch",
  "type": "tool",
  "slug": "gsearch",
  "canonical_url": "https://gtmstacker.com/registry/tool/gsearch/",
  "title": "Gsearch (real Google Search for AI agents, MCP)",
  "description": "MIT-licensed Python tool and MCP server that lets an AI agent run real Google searches through a locally driven Camoufox browser, positioned by its README as a free, self-hosted alternative to paid SERP APIs such as SerpAPI. Returns real result URLs, AI Overview and People also ask as typed JSON, with no API key. The README warns that automated Google access may breach Google's Terms of Service.",
  "category": "data-scraping",
  "tags": [
    "mcp-agents",
    "data-scraping",
    "seo-research",
    "serp",
    "google-search",
    "self-hostable",
    "open-source"
  ],
  "status": "active",
  "revision": 1,
  "content_hash": "e2e31dfd2760102be5cc408836349b890fb3c10edfd4ab5e68259648ca096f88",
  "date_published": "2026-10-23T00:00:00Z",
  "date_modified": "2026-10-23T00:00:00Z",
  "source": {
    "name": "Show HN: Gsearch – Real Google Search for AI Agents (MCP)",
    "url": "https://github.com/RayenMlayeh/gsearch",
    "author": "RayenMlayeh"
  },
  "license": "MIT",
  "one_liner": "Gsearch gives AI agents real Google results over MCP by driving a local Camoufox browser: an MIT, key-free stand-in for paid SERP APIs like SerpAPI.",
  "open_source": "yes",
  "self_hostable": "yes",
  "pricing_signal": "Free, no API key; an optional user-supplied proxy is the only cost.",
  "pricing_model": "free",
  "who_its_for": "Builders wiring Google results into their own agents or research workflows (via MCP or CLI) who want structured SERP data without paying per query for a hosted SERP API.",
  "who_its_not_for": "Teams that need high-volume, contractually sanctioned search data: default limits are 20 queries/hour and 150/day per IP, and automated Google access may breach Google's Terms of Service.",
  "aliases": [
    "gsearch-agent",
    "RayenMlayeh/gsearch",
    "gsearch-mcp"
  ],
  "alternatives": [
    "openserp"
  ],
  "secondary_categories": [
    "mcp-agents",
    "seo-research"
  ],
  "last_verified": "2026-10-23",
  "evidence": {
    "claim_type": "vendor-claim",
    "source_id": "https://github.com/RayenMlayeh/gsearch",
    "note": "MIT confirmed by the LICENSE file, GitHub API spdx_id MIT and PyPI license_expression MIT (gsearch-agent 0.1.0, project URLs point to this repo). As of 2026-10-23: 6 stars, 1 fork, 9 open issues, 8 commits, created and last pushed 2026-10-18; Python 3.12+. Mechanism, anti-detection and rate-limit defaults are README claims, not reproduced."
  },
  "caveats": "Very new and low-traction: a 5-day-old repo with 6 stars and a single PyPI release. The README itself warns that automated access to Google Search may breach Google's Terms of Service; this is not sanctioned Google access. Setup downloads a ~1 GB Camoufox browser. Rate limits (20/hr, 150/day per IP) and anti-detection behavior are vendor claims.",
  "lead": "**Gsearch** is an **MIT-licensed** Python tool and **MCP server** that gives an AI agent real Google Search results by driving a local **Camoufox** (Firefox-based) browser instead of calling a paid SERP API. Its README positions it as a SerpAPI alternative (repo topic `serpapi-alternative`). It returns real result URLs, Google's AI…",
  "chunks": [
    {
      "index": 0,
      "heading_path": [],
      "est_tokens": 99,
      "text": "**Gsearch** is an **MIT-licensed** Python tool and **MCP server** that gives an AI agent real Google Search results by driving a local **Camoufox** (Firefox-based) browser instead of calling a paid SERP API. Its README positions it as a SerpAPI alternative (repo topic `serpapi-alternative`). It returns real result URLs, Google's AI Overview and People also ask as typed JSON, with no API key."
    },
    {
      "index": 1,
      "heading_path": [
        null,
        "Provenance"
      ],
      "est_tokens": 416,
      "text": "AI agent real Google Search results by driving a local **Camoufox** (Firefox-based) browser instead of calling a paid SERP API. Its README positions it as a SerpAPI alternative (repo topic `serpapi-alternative`). It returns real result URLs, Google's AI Overview and People also ask as typed JSON, with no API key.\n\n- SPDX **MIT**, confirmed three ways: the LICENSE file (\"Copyright (c) 2026 The gsearch contributors\"), the GitHub API (`spdx_id: MIT`) and PyPI (`license_expression: MIT`). Not guessed.\n- Package: PyPI **`gsearch-agent` 0.1.0** (single release); its project URLs point back to `RayenMlayeh/gsearch`. Not a fork; no lookalike or name-squat found.\n- Activity as of 2026-10-23: **6 stars, 1 fork, 9 open issues, 8 commits**; created 2026-10-18, last push 2026-10-18; Python 3.12+.\n- Self-hosting: install with `uv` or `pipx`, then `gsearch setup` downloads Camoufox (~1 GB); Linux servers run it under Xvfb. The MCP server `gsearch-mcp` exposes two tools, `google_search` and `google_search_status`.\n- Pricing: free, no API key; an optional user-supplied proxy is the only cost.\n- **Vendor claims, not reproduced:** the browser mechanism, anti-detection behavior, `/goto` redirect resolution and the default rate limits (20/hr, 150/day per IP) come from the README.\n- **Terms-of-service warning (from the README):** automated access to Google Search may breach Google's Terms of Service.\n- Surfaced via a Show HN post in the 2026-10-23 news pull. The README was treated as untrusted content during verification; no injected instructions were encountered. Curated and verified in run `2026-10-23-registry-update-01` (step-3 verification, 2026-10-23)."
    },
    {
      "index": 2,
      "heading_path": [
        null,
        "Why it matters for a GTM stack"
      ],
      "est_tokens": 250,
      "text": "warning (from the README):** automated access to Google Search may breach Google's Terms of Service. - Surfaced via a Show HN post in the 2026-10-23 news pull. The README was treated as untrusted content during verification; no injected instructions were encountered. Curated and verified in run `2026-10-23-registry-update-01` (step-3 verification, 2026-10-23).\n\nResearch agents, account-intel workflows and SEO monitoring all want live search results, and the usual path is a per-query SERP API bill. Gsearch is the own-your-stack experiment: an MCP server your agent calls directly, backed by a real browser on your own machine, returning structured JSON. The honest read is that it is five days old with six stars, its throughput is capped by design, and the project itself warns that automating Google may breach Google's terms, so it fits low-volume, personal or prototype research rather than production data pipelines. For a broader multi-engine option already in the registry, see OpenSERP."
    }
  ],
  "alternates": {
    "markdown": "https://gtmstacker.com/registry/tool/gsearch/index.md",
    "html": "https://gtmstacker.com/registry/tool/gsearch/",
    "json": "https://gtmstacker.com/registry/tool/gsearch/index.json",
    "server_json": "https://gtmstacker.com/registry/tool/gsearch/server.json"
  },
  "jsonld": {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "WebSite",
        "@id": "https://gtmstacker.com/#website",
        "url": "https://gtmstacker.com/",
        "name": "GTM Stacker Agent Registry",
        "description": "A daily-updated, agent-native registry of open-source tool discoveries, tool updates, and curated news for the go-to-market / RevOps engineering niche. Machine-readable first: agents can discover, parse, page, and delta-sync it without scraping HTML.",
        "inLanguage": "en",
        "publisher": {
          "@id": "https://gtmstacker.com/#organization"
        }
      },
      {
        "@type": "Organization",
        "@id": "https://gtmstacker.com/#organization",
        "name": "GTM Stacker",
        "url": "https://gtmstacker.com",
        "description": "The growth-systems practice of Theo Popov: AI-native enrichment, outbound, content engines and internal tooling for startups and venture programs. Its agent-native media property, the GTM Stacker Agent Registry, maintains a daily-updated catalog of open-source go-to-market and RevOps tools that both people and AI engines can discover, compare, and cite.",
        "foundingDate": "2024-08",
        "knowsAbout": [
          "go-to-market engineering",
          "RevOps",
          "sales automation",
          "marketing operations",
          "open-source software",
          "AI agents"
        ],
        "founder": {
          "@type": "Person",
          "@id": "https://gtmstacker.com/#founder",
          "name": "Theo Popov",
          "jobTitle": "Growth Operations & GTM Systems",
          "url": "https://gtmstacker.com/about/",
          "sameAs": [
            "https://www.linkedin.com/in/theo-popov",
            "https://x.com/Theo_Popov",
            "https://github.com/theopopov"
          ],
          "worksFor": {
            "@id": "https://gtmstacker.com/#organization"
          }
        },
        "sameAs": [
          "https://www.linkedin.com/company/gtmstacker",
          "https://www.youtube.com/@gtmstacker",
          "https://www.instagram.com/gtmstacker/",
          "https://www.tiktok.com/@gtmstacker"
        ],
        "mainEntityOfPage": "https://gtmstacker.com/registry/about/"
      },
      {
        "@type": "SoftwareApplication",
        "@id": "https://gtmstacker.com/registry/tool/gsearch/#software",
        "name": "Gsearch (real Google Search for AI agents, MCP)",
        "identifier": "io.github.RayenMlayeh/gsearch",
        "description": "MIT-licensed Python tool and MCP server that lets an AI agent run real Google searches through a locally driven Camoufox browser, positioned by its README as a free, self-hosted alternative to paid SERP APIs such as SerpAPI. Returns real result URLs, AI Overview and People also ask as typed JSON, with no API key. The README warns that automated Google access may breach Google's Terms of Service.",
        "applicationCategory": "DeveloperApplication",
        "url": "https://gtmstacker.com/registry/tool/gsearch/",
        "datePublished": "2026-10-23T00:00:00Z",
        "dateModified": "2026-10-23T00:00:00Z",
        "isPartOf": {
          "@id": "https://gtmstacker.com/#website"
        },
        "softwareVersion": "0.1.0",
        "license": "https://spdx.org/licenses/MIT.html",
        "codeRepository": "https://github.com/RayenMlayeh/gsearch",
        "keywords": "data-scraping, mcp-agents, seo-research, serp, google-search, self-hostable, open-source",
        "author": {
          "@type": "Organization",
          "name": "RayenMlayeh",
          "url": "https://github.com/RayenMlayeh",
          "sameAs": [
            "https://github.com/RayenMlayeh/gsearch"
          ]
        },
        "offers": {
          "@type": "Offer",
          "price": 0,
          "priceCurrency": "USD"
        },
        "isSimilarTo": [
          {
            "@type": "SoftwareApplication",
            "name": "OpenSERP",
            "url": "https://gtmstacker.com/registry/tool/openserp/",
            "applicationCategory": "DeveloperApplication",
            "offers": {
              "@type": "Offer",
              "price": 0,
              "priceCurrency": "USD"
            }
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "@id": "https://gtmstacker.com/registry/tool/gsearch/#breadcrumb",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "GTM Stacker Registry",
            "item": "https://gtmstacker.com/registry/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Data Scraping",
            "item": "https://gtmstacker.com/registry/category/data-scraping/"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Gsearch (real Google Search for AI agents, MCP)",
            "item": "https://gtmstacker.com/registry/tool/gsearch/"
          }
        ]
      }
    ]
  },
  "tool": {
    "name": "io.github.RayenMlayeh/gsearch",
    "repository": {
      "url": "https://github.com/RayenMlayeh/gsearch",
      "source": "github"
    },
    "version": "0.1.0",
    "packages": [
      {
        "registry_type": "pypi",
        "identifier": "gsearch-agent",
        "version": "0.1.0"
      }
    ]
  }
}