Google Alerts Mcp

by ycrao

2 stars

242 downloads

Not rated

GitHub Website

Other

About

Google Alerts Mcp is an MCP (Model Context Protocol) server that fetches news articles from Google Alerts for a given topic. It simulates a browser workflow to dynamically extract state parameters and tokens, avoiding detection and blocking. It is intended for developers who…

Details

Author: ycrao
GitHub stars: 2
Downloads: 242
Categories: Other

- Dynamic extraction of Google Alerts page state parameters and tokens
- Anti‑detection using fresh cookies and session headers per request
- Multi‑language search support (e.g., Chinese, English)
- Automatic cleaning of Google redirect URLs to direct article links
- No hard‑coded authentication values – all parameters are extracted dynamically

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Google Alerts Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

From the repository

Install dependencies with uv sync, then run the server or configure it as an MCP tool in your client. The server provides a search_google_alerts tool that accepts query (required), and optional language, region, and clean_urls parameters.

`search_google_alerts`

Search Google Alerts for news articles about a specific topic by simulating the browser workflow

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google alerts mcp": {
            "google-alerts": {
                "command": "uvx",
                "args": [
                    "google-alerts-mcp"
                ],
                "env": []
            }
        }
    }
}

McpServers

{
    "google-alerts": {
        "command": "uvx",
        "args": [
            "google-alerts-mcp"
        ],
        "env": []
    }
}

Google Alerts MCP Server

English README

一个基于 MCP (Model Context Protocol) 的 Google Alerts 插件，通过模拟浏览器工作流程来获取特定主题的新闻资讯。该插件能够动态提取 Google Alerts 页面的状态参数，避免被检测和封锁。

本 MCP Server 需要访问 Google 服务，某些地区需要科学上网环境。

功能特性

- 动态状态提取：自动从 Google Alerts 页面提取 window.STATE 参数
- 防检测机制：每次请求使用新鲜的令牌和会话 cookies 避免被封锁
- 多语言支持：支持中文、英文等多种语言搜索
- 浏览器工作流程模拟：完全模拟浏览器访问流程：访问主页 → 提取 cookies/状态 → 构建预览 URL
- 无硬编码参数：所有认证令牌和状态参数都动态提取，不使用硬编码值
- URL清理功能：可配置是否移除Google重定向参数，直接获取目标新闻链接

工作流程

1. 获取初始 cookies：访问 https://www.google.com/alerts?hl={language} 获取初始 cookies
2. 状态参数提取：从页面中提取 window.STATE 参数，包括认证令牌
3. 构建预览 URL：使用提取的参数和搜索查询构建预览 URL
4. 获取内容：使用正确的 cookies 和状态参数获取预览页面
5. 文章解析：从 HTML 响应中提取文章标题、URL、摘要和来源

安装

使用 UV 包管理器：

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search_google_alerts

Claude Desktop / Cursor

McpServers

Google Alerts MCP Server

功能特性

工作流程

安装

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`search_google_alerts`