# 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`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *google-news-trends-mcp*.
### Using PIP
```bash
pip install google-news-trends-mcp
```
After installation, you can run it as a script using:
```bash
python -m google_news_trends_mcp
```
## Configuration
### Configure for Claude.app
Add to your Claude settings:
<details>
<summary>Using uvx</summary>
```json
{
"mcpServers": {
"google-news-trends": {
"command": "uvx",
"args": ["google-news-trends-mcp@latest"]
}
}
}
```
</details>
<details>
<summary>Using pip installation</summary>
```json
{
"mcpServers": {
"google-news-trends": {
"command": "python",
"args": ["-m", "google_news_trends_mcp"]
}
}
}
```
</details>
### Configure for VS Code
<details>
<summary>Using uvx</summary>
```json
{
"mcp": {
"servers": {
"google-news-trends": {
"command": "uvx",
"args": ["google-news-trends-mcp@latest"]
}
}
}
}
```
</details>
<details>
<summary>Using pip installation</summary>
```json
{
"mcp": {
"servers": {
"google-news-trends": {
"command": "python",
"args": ["-m", "google_news_trends_mcp"]
}
}
}
}
```
</details>
## 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`
```bash
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
```bash
npx @modelcontextprotocol/inspector uvx google-news-trends-mcp
```
To run from within locally installed project
```bash
cd path/to/google/news/tends/mcp
npx @modelcontextprotocol/inspector uv run google-news-trends-mcp
```
## Testing
```bash
cd path/to/google/news/tends/mcp
python -m pytest
```
Raw data
{
"_id": null,
"home_page": null,
"name": "google-news-trends-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10.18",
"maintainer_email": null,
"keywords": "google, news, rss, trends, mcp, fastmcp, llm, nlp",
"author": null,
"author_email": "Jesse Manek <jesse.manek@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/db/54/c5c53a68527b576b5157e19f5bf7ecce72fe6cdf41da7ea55dec6a3ef98f/google_news_trends_mcp-0.2.6.tar.gz",
"platform": null,
"description": "# Google News Trends MCP\n\nAn MCP server that slurps data from Google News and Google Trends RSS endpoints, optionally distills it with LLM/NLP, and barfs out structured results.\n\n## Features\n\n- Trawl Google News RSS feeds for articles based on keyword, location, topic\n- Ingest top news stories from Google News\n- Snag trending search terms from Google Trends based on geographic input\n- Plug in LLM/NLP pipelines to condense article payloads and extract key concepts\n\n## Installation\n\n### Using uv/uvx (recommended)\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will\nuse [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *google-news-trends-mcp*.\n\n### Using PIP\n\n```bash\npip install google-news-trends-mcp\n```\nAfter installation, you can run it as a script using:\n\n```bash\npython -m google_news_trends_mcp\n```\n\n## Configuration\n\n### Configure for Claude.app\n\nAdd to your Claude settings:\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n{\n \"mcpServers\": {\n \"google-news-trends\": {\n \"command\": \"uvx\",\n \"args\": [\"google-news-trends-mcp@latest\"]\n }\n }\n}\n```\n</details>\n\n<details>\n<summary>Using pip installation</summary>\n\n```json\n{\n \"mcpServers\": {\n \"google-news-trends\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"google_news_trends_mcp\"]\n }\n }\n}\n```\n</details>\n\n### Configure for VS Code\n\n<details>\n<summary>Using uvx</summary>\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"google-news-trends\": {\n \"command\": \"uvx\",\n \"args\": [\"google-news-trends-mcp@latest\"]\n }\n }\n }\n}\n```\n</details>\n\n<details>\n<summary>Using pip installation</summary>\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"google-news-trends\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"google_news_trends_mcp\"]\n }\n }\n }\n}\n```\n</details>\n\n\n## Tools\n\nThe following MCP tools are available:\n\n| Tool Name | Description |\n|--------------------------|--------------------------------------------------------------------|\n| **get_news_by_keyword** | Search for news using specific keywords. |\n| **get_news_by_location** | Retrieve news relevant to a particular location. |\n| **get_news_by_topic** | Get news based on a chosen topic. |\n| **get_top_news** | Fetch the top news stories from Google News. |\n| **get_trending_keywords**| Return trending keywords from Google Trends for a specified location.|\n\nAll of the news related tools have an option to summarize the text of the article using LLM Sampling (if supported) or NLP\n\n\n## CLI\nAll tools can be accessed from the command line using `uv`\n\n```bash\nuv run google-news-trends\nUsage: google-news-trends [OPTIONS] COMMAND [ARGS]...\n\n Find and download news articles using Google News.\n\nOptions:\n --help Show this message and exit.\n\nCommands:\n keyword Find articles by keyword using Google News.\n location Find articles by location using Google News.\n top Get top news stories from Google News.\n topic Find articles by topic using Google News.\n trending Returns google trends for a specific geo location.\n```\n\n## Debugging\n\n```bash\nnpx @modelcontextprotocol/inspector uvx google-news-trends-mcp\n```\n\nTo run from within locally installed project\n\n```bash\ncd path/to/google/news/tends/mcp\nnpx @modelcontextprotocol/inspector uv run google-news-trends-mcp\n```\n\n## Testing\n\n```bash\ncd path/to/google/news/tends/mcp\npython -m pytest\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "An MCP server to access RSS feeds of Google News and Google Trends",
"version": "0.2.6",
"project_urls": {
"Homepage": "https://github.com/jmanek/google-news-trends-mcp",
"Issues": "https://github.com/jmanek/google-news-trends-mcp/issues",
"Repository": "https://github.com/jmanek/google-news-trends-mcp"
},
"split_keywords": [
"google",
" news",
" rss",
" trends",
" mcp",
" fastmcp",
" llm",
" nlp"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5e0737c006325e3a606b18366eb222558215879c31748b1d74b9680039c931b1",
"md5": "3c345a64edb80d2353fcd55c40c94467",
"sha256": "a7aeff3b76eca5a6ff30ca350f4ca7d89a9fb2117aa92ba0d4b8dbf719f91d0d"
},
"downloads": -1,
"filename": "google_news_trends_mcp-0.2.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c345a64edb80d2353fcd55c40c94467",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.18",
"size": 12386,
"upload_time": "2025-08-01T08:29:02",
"upload_time_iso_8601": "2025-08-01T08:29:02.692974Z",
"url": "https://files.pythonhosted.org/packages/5e/07/37c006325e3a606b18366eb222558215879c31748b1d74b9680039c931b1/google_news_trends_mcp-0.2.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "db54c5c53a68527b576b5157e19f5bf7ecce72fe6cdf41da7ea55dec6a3ef98f",
"md5": "8dd361be9a373b7e7b6caec423b9a45a",
"sha256": "0f4168fa4aa31cb90789586aa3add94a659f85aea79bb73e6f58255da04f8b86"
},
"downloads": -1,
"filename": "google_news_trends_mcp-0.2.6.tar.gz",
"has_sig": false,
"md5_digest": "8dd361be9a373b7e7b6caec423b9a45a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.18",
"size": 13027,
"upload_time": "2025-08-01T08:29:03",
"upload_time_iso_8601": "2025-08-01T08:29:03.452157Z",
"url": "https://files.pythonhosted.org/packages/db/54/c5c53a68527b576b5157e19f5bf7ecce72fe6cdf41da7ea55dec6a3ef98f/google_news_trends_mcp-0.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 08:29:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jmanek",
"github_project": "google-news-trends-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "google-news-trends-mcp"
}
JSON
