Google Alerts MCP Server for fetching topic-based news and information
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"google-alerts-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Google Alerts MCP Server A Google Alerts plugin based on MCP (Model Context Protocol) that retrieves news articles on specific topics by simulating browser workflows. This plugin dynamically extracts state parameters from Google Alerts pages to avoid detection and blocking. ## Features - **Dynamic State Extraction**: Automatically extracts `window.STATE` parameters from Google Alerts pages - **Anti-Detection Mechanism**: Uses fresh tokens and session cookies for each request to avoid blocking - **Multi-Language Support**: Supports searches in Chinese, English, and other languages - **Browser Workflow Simulation**: Fully simulates browser access flow: visit homepage → extract cookies/state → build preview URL - **No Hardcoded Parameters**: All authentication tokens and state parameters are dynamically extracted, no hardcoded values - **URL Cleaning Feature**: Configurable option to remove Google redirect parameters and get direct news links ## Workflow 1. **Get Initial Cookies**: Visit `https://www.google.com/alerts?hl={language}` to get initial cookies 2. **State Parameter Extraction**: Extract `window.STATE` parameters from the page, including authentication tokens 3. **Build Preview URL**: Use extracted parameters and search query to build preview URL 4. **Get Content**: Use correct cookies and state parameters to get preview page 5. **Article Parsing**: Extract article titles, URLs, snippets, and sources from HTML response ## Installation Using UV package manager: ```bash # Clone the project git clone https://github.com/ycrao/google-alerts-mcp.git cd google-alerts-mcp # Install dependencies uv sync # Activate virtual environment source .venv/bin/activate # Windows: .venv\Scripts\activate # Or run directly uv run python src/google_alerts_mcp/server.py ``` ## Usage ### Running as MCP Server Add to your MCP client configuration: ```json { "mcpServers": { "google-alerts": { "command": "uv", "args": [ "--directory", …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.