Google News MCP Server A Model Context Protocol (MCP) server implementation that provides Google News search capabilities via SerpAPI integration. Automatically categorizes news results and supports multiple languages and regions. Comprehensive search capabilities including query-based search, topic search, publication filtering and story coverage. Supports multiple languages and regions through c
Add this skill
npx mdskills install ChanMeng666/server-google-newsWell-documented MCP server providing Google News search with automatic categorization and multi-language support
1[](https://mseep.ai/app/chanmeng666-server-google-news)23<div align="center">4 <h1><img src="public/server-google-news.svg" width="80px"><br/>Google News MCP Server</h1>5 <a href="https://github.com/ChanMeng666/server-google-news/stargazers"><img src="https://img.shields.io/github/stars/ChanMeng666/server-google-news.svg?style=social"></a>6 <img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white"/>7 <img src="https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white"/>8 <img src="https://img.shields.io/badge/MCP-Server-blue?style=flat"/>9 <img src="https://img.shields.io/badge/License-MIT-brightgreen?style=flat"/>10</div>1112<br/>1314<div align="center">15 <a href="https://www.pulsemcp.com/servers/chanmeng666-google-news"><img src="https://www.pulsemcp.com/badge/top-pick/chanmeng666-google-news" width="400" alt="PulseMCP Badge"></a>16</div>171819<br/>2021A Model Context Protocol (MCP) server implementation that provides Google News search capabilities via SerpAPI integration. Automatically categorizes news results and supports multiple languages and regions.2223<a href="https://glama.ai/mcp/servers/dbx6imq4ef"><img width="380" height="200" src="https://glama.ai/mcp/servers/dbx6imq4ef/badge" alt="Google News Server MCP server" /></a>2425<br/>2627[](https://smithery.ai/server/@chanmeng666/google-news-server)2829<br/>3031https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779323334353637383940414243# โจ Features4445### ๐ Flexible Search Options46Comprehensive search capabilities including query-based search, topic search, publication filtering and story coverage.4748### ๐ Global Coverage49Supports multiple languages and regions through configurable language and country codes.5051### ๐ Smart Categorization52Automatically categorizes news results into topics like AI & Technology, Business, Science & Research, and Healthcare.5354### ๐ Multiple Result Types55Handles various news result types including headlines, stories, related topics and menu links.5657### ๐ ๏ธ Robust Error Handling58Comprehensive error handling for API failures and invalid inputs, with helpful error messages.5960### ๐ Language Support61Automatic fallback to English for unsupported language codes with appropriate user notifications.6263# ๐ SerpApi Setup Guide6465Before getting started, you'll need to obtain a SerpApi key. Here's how:66671. Visit [SerpApi website](https://serpapi.com/) and create an account68692. After registration, go to your Dashboard:70 - Locate the "API Key" section71 - Copy your API key72 - New users get 250 free API calls73743. API Usage Details:75 - Free tier: 250 searches per month76 - Paid plans start at $75/month for 5000 searches77 - Billing based on successful API calls78 - Multiple payment methods: Credit Card, PayPal, etc.79804. Usage Limits:81 - Request Rate: 2 requests/second82 - IP Restrictions: None83 - Concurrent Requests: 584 - Response Cache Time: 1 hour8586# ๐ฉโ๐ง Solution for MCP Servers Connection Issues with NVM/NPM8788Click to view my configuration solution ๐ https://github.com/modelcontextprotocol/servers/issues/768990# ๐ Quick Start91921. Install dependencies:93```bash94npm install95```96972. Build the server:98```bash99npm run build100```1011023. Configure environment:103Modify your `claude_desktop_config.json` with the following content (adjust paths according to your system):104```json105 "google-news": {106 "command": "D:\\Program\\nvm\\node.exe",107 "args": [108 "D:\\github_repository\\path_to\\dist\\index.js"109 ],110 "env": {111 "SERP_API_KEY": "your-api-key"112 }113 }114```1151164. Start the server:117```bash118npm start119```120121## Troubleshooting1221231. Invalid API Key124- Verify API key configuration in `claude_desktop_config.json`125- Confirm API key is active in SERP API dashboard1261272. Request Failures128- Check network connectivity129- Verify API call quota hasn't been exceeded130- Validate request parameter format131132133134## Running evals135136The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).137138```bash139OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts140```141# ๐ฆ Installation142143## Installing via Smithery144145To install Google News for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@chanmeng666/google-news-server):146147```bash148npx -y @smithery/cli install @chanmeng666/google-news-server --client claude149```150151[](https://archestra.ai/mcp-catalog/chanmeng666__server-google-news)152[](https://smithery.ai/server/@chanmeng666/google-news-server)153154## Installing via mcp-get155156```bash157npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server158```159160> If you are using an old version of Windows PowerShell, you may need to run `Set-ExecutionPolicy Bypass -Scope Process` before this command.161162## Manual Installation163164<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-news-server">@chanmeng666/google-news-server</a>165166```bash167# Using npm168npm i @chanmeng666/google-news-server169# or170npm install @chanmeng666/google-news-server171172# Using yarn173yarn add @chanmeng666/google-news-server174175# Using pnpm176pnpm add @chanmeng666/google-news-server177```178179# ๐ป Tech Stack180181182183184# ๐ API Documentation185186The server implements the Model Context Protocol and exposes a Google News search tool with the following parameters:187188- `q`: Search query string189- `gl`: Country code (e.g., 'us', 'uk')190- `hl`: Language code (e.g., 'en', 'es')191- `topic_token`: Token for specific news topics192- `publication_token`: Token for specific publishers193- `story_token`: Token for full coverage of a story194- `section_token`: Token for specific sections195196# ๐ง Development197198```bash199# Run in development mode with hot reload200npm run dev201202# Run linting203npm run lint204205# Run tests206npm run test207```208209# ๐ License210211This project is [MIT licensed](./LICENSE).212213# ๐โโ Author214215Created and maintained by [Chan Meng](https://chanmeng.org/).216[](https://github.com/ChanMeng666)217[](https://www.linkedin.com/in/chanmeng666/)218219---220221<details>222<summary>๐ค AI Agent Instructions & GEO Optimization</summary>223224## For AI Agents and LLM Crawlers225226This MCP server is optimized for AI agent usage with comprehensive instructions and structured data.227228### Quick AI Usage Guide229230```json231{232 "tool": "google_news_search",233 "parameters": {234 "q": "artificial intelligence latest developments",235 "gl": "us",236 "hl": "en"237 }238}239```240241### AI-Friendly Features242- **Automatic Categorization**: News results are automatically sorted into relevant categories243- **Structured Output**: Returns formatted data optimized for AI processing244- **Multi-language Support**: Supports various languages with automatic fallbacks245- **Error Handling**: Comprehensive error messages and graceful degradation246247### Response Format248The server returns categorized news with the following structure:249- **Categories**: AI & Technology, Business, Science & Research, Healthcare, General250- **Article Fields**: title, source, link, date, snippet, authors251- **Metadata**: timestamp, menu_links for related topics252253### Best Practices for AI Agents2541. Use specific, descriptive keywords for better results2552. Leverage automatic categorization for topic-based workflows2563. Implement proper error handling and retry logic2574. Respect API rate limits (2 requests/second)2585. Parse structured responses for better context understanding259260### Advanced Usage Patterns261- **News Monitoring**: Use company names or stock symbols for business news262- **Research Exploration**: Leverage topic tokens for field-specific searches263- **Breaking News**: Use "breaking news" or "latest news" queries264- **Multi-language**: Combine appropriate gl and hl parameters265266### Error Handling267- Invalid API key: Check SERP_API_KEY environment variable268- Unsupported language: Server auto-falls back to English269- Rate limiting: Respect 2 requests/second limit270- Invalid parameters: Validate parameter types before calling271272273</details>274275<details>276<summary>๐ GEO Metrics & Monitoring</summary>277278## Generative Engine Optimization (GEO) Features279280This server includes comprehensive monitoring and optimization for AI agent usage.281282### Key Metrics Tracked283- **Citation Success Rate**: Percentage of successful tool calls284- **AI Traffic Conversion Rate**: Percentage of AI agents successfully using the tool285- **Query Coverage Rate**: Percentage of queries returning relevant results286- **Response Time**: Average response time for tool calls287- **Categorization Accuracy**: Accuracy of automatic news categorization288- **Link Carry Rate**: Percentage of responses including source links289290### Monitoring Configuration291```typescript292interface GEOMonitoringConfig {293 trackingEnabled: boolean;294 metricsEndpoint: string;295 reportingInterval: number; // minutes296 alertThresholds: {297 errorRate: number;298 responseTime: number;299 successRate: number;300 satisfactionScore: number;301 };302}303```304305### Performance Optimization306- Real-time metrics collection307- Automated alerting for performance issues308- Query pattern analysis for optimization309- Agent usage tracking and analytics310311### Data-Driven Improvements312- Continuous monitoring of AI agent satisfaction313- Query success rate analysis314- Response time optimization315- Categorization accuracy improvements316317For technical implementation details, see [src/geo-metrics.ts](./src/geo-metrics.ts).318319</details>320321<details>322<summary>๐ Structured Data & Metadata</summary>323324## AI-Optimized Metadata325326This server provides comprehensive structured data for AI agents and search engines.327328### JSON-LD Structured Data329The server includes structured data following Schema.org standards:330- Software application metadata331- Feature descriptions and capabilities332- Technical requirements and dependencies333- Usage patterns and integration guidelines334335### MCP Protocol Compliance336- **Protocol Version**: 1.0.0337- **Tool Name**: `google_news_search`338- **Response Format**: Structured text with categorized results339- **Rate Limits**: 2 requests/second, 5 concurrent requests340341### AI Discovery Features342- **llms.txt**: Comprehensive AI usage guide at root level343- **Structured Metadata**: Enhanced manifest.json with AI-specific information344- **Error Handling**: AI-friendly error messages and fallbacks345- **Documentation**: Detailed usage examples and best practices346347### Integration Guidelines348- Designed for seamless integration with other MCP servers349- Optimized for AI agent workflows350- Supports various AI platforms and frameworks351- Provides clear error handling and debugging information352353For complete structured data, see [structured-data.json](./structured-data.json).354355</details>356357
Full transparency โ inspect the skill content before installing.