server-google-news

# Google News MCP Server - AI Usage Guide

## Service Overview
This is a Model Context Protocol (MCP) server specifically designed to provide Google News search capabilities for AI agents.

## Core Features
- **Smart News Search**: Supports keyword, topic, publication, and story-based search methods
- **Automatic Categorization**: Automatically categorizes news results into AI & Technology, Business, Science & Research, Healthcare, and other relevant categories
- **Multi-language Support**: Supports multiple languages and regional settings
- **Structured Output**: Provides formatted news data that's easy for AI to understand and process

## Usage Instructions
1. Call the `google_news_search` tool via MCP protocol
2. Supported parameters: q (query), gl (country), hl (language), topic_token (topic), publication_token (publication), etc.
3. Returns categorized news articles, each containing title, source, link, date, snippet, and other metadata

## Best Practices
- Use specific search keywords for more accurate results
- Leverage topic_token for deep searches on specific topics
- Combine gl and hl parameters for localized searches
- Utilize returned categorization information for topic-related follow-up analysis

## Technical Architecture
- Built with TypeScript and Node.js
- Uses SerpAPI as data source
- Implements MCP protocol standards
- Supports Docker containerization

## Integration Examples
- News monitoring and analysis workflows
- Research assistance and fact-checking
- Content curation and aggregation
- Market intelligence gathering
- Real-time news alerts and notifications

## Error Handling
- Automatic fallback to English for unsupported languages
- Comprehensive error messages for API failures
- Rate limiting compliance (2 requests/second)
- Graceful handling of invalid parameters