Skip to content

jmanek/google-news-trends-mcp

Repository files navigation

Google News Trends MCP

An MCP server that slurps data from Google News and Google Trends RSS endpoints, optionally distills it with LLM/NLP, and barfs out structured results.

Features

  • Trawl Google News RSS feeds for articles based on keyword, location, topic
  • Ingest top news stories from Google News
  • Snag trending search terms from Google Trends based on geographic input
  • Plug in LLM/NLP pipelines to condense article payloads and extract key concepts

Installation

Using uv/uvx (recommended)

When using uv no specific installation is needed. We will use uvx to directly run google-news-trends-mcp.

Using PIP

pip install google-news-trends-mcp

After installation, you can run it as a script using:

python -m google_news_trends_mcp

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx
{
  "mcpServers": {
    "google-news-trends": {
      "command": "uvx",
      "args": ["google-news-trends-mcp@latest"]
    }
  }
}
Using pip installation
{
  "mcpServers": {
    "google-news-trends": {
      "command": "python",
      "args": ["-m", "google_news_trends_mcp"]
    }
  }
}

Configure for VS Code

Using uvx
{
  "mcp": {
    "servers": {
      "google-news-trends": {
        "command": "uvx",
        "args": ["google-news-trends-mcp@latest"]
      }
    }
  }
}
Using pip installation
{
  "mcp": {
    "servers": {
      "google-news-trends": {
        "command": "python",
        "args": ["-m", "google_news_trends_mcp"]
      }
    }
  }
}

Tools

The following MCP tools are available:

Tool Name Description
get_news_by_keyword Search for news using specific keywords.
get_news_by_location Retrieve news relevant to a particular location.
get_news_by_topic Get news based on a chosen topic.
get_top_news Fetch the top news stories from Google News.
get_trending_keywords Return trending keywords from Google Trends for a specified location.

All of the news related tools have an option to summarize the text of the article using LLM Sampling (if supported) or NLP

CLI

All tools can be accessed from the command line using uv

uv run google-news-trends
Usage: google-news-trends [OPTIONS] COMMAND [ARGS]...

  Find and download news articles using Google News.

Options:
  --help  Show this message and exit.

Commands:
  keyword   Find articles by keyword using Google News.
  location  Find articles by location using Google News.
  top       Get top news stories from Google News.
  topic     Find articles by topic using Google News.
  trending  Returns google trends for a specific geo location.

Debugging

npx @modelcontextprotocol/inspector uvx google-news-trends-mcp

To run from within locally installed project

cd path/to/google/news/tends/mcp
npx @modelcontextprotocol/inspector uv run google-news-trends-mcp

Testing

cd path/to/google/news/tends/mcp
python -m pytest

About

MCP server for Google News and Google Trends

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages