Google AI Scraper — AI skill for Claude Code

Google AI Overview Scraper

Scrapes Google AI Overviews via a browser extension relay. Chrome and Firefox extension packages are included, alongside an HTTP API and MCP server for AI agents such as Claude Code, Claude Desktop, and Cursor.

No browser focus stealing. Queries run in background tabs.

MCP Client / HTTP Client
        ↕
   MCP Server (stdio or SSE)
        ↕ httpx
   Shared FastAPI Backend (:15551)
        ↕ polling
 Chrome Extension / Firefox Add-on
        → background tab → scrape → result

Prerequisites

• Python 3.13+
• uv
• Chrome/Chromium or Firefox

Quick Install

uvx google-ai-scraper

Install the published Chrome extension from the Chrome Web Store:

https://chromewebstore.google.com/detail/google-ai-overview-scrape/oidaeopefkgfpeigcjapebhppnbcocpc?authuser=1&hl=en

Or load the Firefox add-on locally from `firefox-extension/manifest.json` via `about:debugging#/runtime/this-firefox`.

In either browser, open the extension/add-on settings and set the server URL to `http://localhost:15551`.

For MCP clients, the simplest config is:

{
  "mcpServers": {
    "google-ai-scraper": {
      "command": "uvx",
      "args": ["google-ai-scraper"]
    }
  }
}

Each MCP client process auto-reuses or auto-starts the shared backend on `127.0.0.1:15551`, so multiple Claude Code windows can use the same config without manual SSE setup.

Local Development Setup

1. Install dependencies

cd server
uv sync

2. Install the browser extension/add-on

Chrome:

https://chromewebstore.google.com/detail/google-ai-overview-scrape/oidaeopefkgfpeigcjapebhppnbcocpc?authuser=1&hl=en

Firefox:

1. Open about:debugging#/runtime/this-firefox
2. Click Load Temporary Add-on
3. Select firefox-extension/manifest.json

Then open the extension/add-on settings and set the server URL to `http://localhost:15551`.

3. Start a local backend for direct HTTP t