{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_msu9bvtk5aq7","handle":"google-alerts-mcp","url":"https://wellknown.network/agents/google-alerts-mcp","links":{"self":"https://wellknown.network/agents/google-alerts-mcp/record.json","html":"https://wellknown.network/agents/google-alerts-mcp","markdown":"https://wellknown.network/agents/google-alerts-mcp/record.md","api":"https://wellknown.network/api/v1/agents/google-alerts-mcp","status":"https://wellknown.network/api/v1/agents/google-alerts-mcp/status","claim":"https://wellknown.network/agents/google-alerts-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/google-alerts-mcp/claim.json","badge":"https://wellknown.network/agents/google-alerts-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/google-alerts-mcp/history","tools":"https://wellknown.network/api/v1/agents/google-alerts-mcp/tools"},"ard":{"identifier":"urn:air::server:google-alerts-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"google-alerts-mcp","summary":"Google Alerts MCP Server for fetching topic-based news and information","description":"# Google Alerts MCP Server\n\nA 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.\n\n## Features\n\n- **Dynamic State Extraction**: Automatically extracts `window.STATE` parameters from Google Alerts pages\n- **Anti-Detection Mechanism**: Uses fresh tokens and session cookies for each request to avoid blocking\n- **Multi-Language Support**: Supports searches in Chinese, English, and other languages\n- **Browser Workflow Simulation**: Fully simulates browser access flow: visit homepage → extract cookies/state → build preview URL\n- **No Hardcoded Parameters**: All authentication tokens and state parameters are dynamically extracted, no hardcoded values\n- **URL Cleaning Feature**: Configurable option to remove Google redirect parameters and get direct news links\n\n## Workflow\n\n1. **Get Initial Cookies**: Visit `https://www.google.com/alerts?hl={language}` to get initial cookies\n2. **State Parameter Extraction**: Extract `window.STATE` parameters from the page, including authentication tokens\n3. **Build Preview URL**: Use extracted parameters and search query to build preview URL\n4. **Get Content**: Use correct cookies and state parameters to get preview page\n5. **Article Parsing**: Extract article titles, URLs, snippets, and sources from HTML response\n\n## Installation\n\nUsing UV package manager:\n\n```bash\n# Clone the project\ngit clone https://github.com/ycrao/google-alerts-mcp.git\ncd google-alerts-mcp\n\n# Install dependencies\nuv sync\n\n# Activate virtual environment\nsource .venv/bin/activate  # Windows: .venv\\Scripts\\activate\n# Or run directly\nuv run python src/google_alerts_mcp/server.py\n```\n\n## Usage\n\n### Running as MCP Server\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-alerts\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        …","publisher":null,"homepage":"https://github.com/ycrao/google-alerts-mcp","repository":"https://github.com/ycrao/google-alerts-mcp","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["google-alerts","mcp","model-context-protocol","news"],"pricing":null,"endpoints":[{"url":"pypi:google-alerts-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"communication.notifications","name":"Notifications","confidence":1,"provenance":"derived"},{"slug":"data.news","name":"News & Feeds","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["communication","data","dev"],"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":"google-alerts-mcp","registry":"pypi","observedAt":"2026-10-28T02:26:38.249Z","publishedAt":"2025-12-29T10:32:32.306621Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"google-alerts-mcp","url":"https://pypi.org/project/google-alerts-mcp/","firstSeenAt":"2026-09-09T16:24:24.309Z","fetchedAt":"2026-10-28T02:24:27.825Z","normalizedAt":"2026-10-28T02:24:27.825Z"}]},"firstSeenAt":"2026-09-09T16:24:24.309Z","updatedAt":"2026-10-28T02:26:38.249Z"}