google-news-trends-mcp 0.1.0__tar.gz

google_news_trends_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jesse Manek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

google_news_trends_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: google-news-trends-mcp
+Version: 0.1.0
+Summary: Add your description here
+Author-email: Jesse Manek <jesse.manek@gmail.com>
+License: MIT
+Requires-Python: >=3.10.18
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: asyncio>=3.4.3
+Requires-Dist: click>=8.2.1
+Requires-Dist: cloudscraper>=1.2.71
+Requires-Dist: fastmcp>=2.9.2
+Requires-Dist: gnews>=0.4.1
+Requires-Dist: googlenewsdecoder>=0.1.7
+Requires-Dist: lxml[html-clean]>=6.0.0
+Requires-Dist: newspaper4k>=0.9.3.1
+Requires-Dist: nltk>=3.9.1
+Requires-Dist: playwright>=1.53.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pytest>=8.4.1
+Requires-Dist: pytest-asyncio>=1.0.0
+Requires-Dist: trendspy>=0.1.6
+Dynamic: license-file
+
+# Google News Trends MCP
+
+An MCP server to access Google News and Google Trends.  Does not rely on any paid APIs.  
+The returned data currently uses a lot of tokens, so it is recommended to always use limits when making requests.  
+
+## Features
+
+- Search Google News articles based on keyword, location, topic
+- Get top news stories from Google News
+- Google Trends keywords base on location
+- Optional NLP processing to summarize articles and extract keywords
+
+## 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"]
+    }
+  }
+}
+```
+</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"]
+      }
+    }
+  }
+}
+```
+</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 NLP (nltk)
+
+
+## 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
+```

google_news_trends_mcp-0.1.0/README.md

@@ -0,0 +1,157 @@
+# Google News Trends MCP
+
+An MCP server to access Google News and Google Trends.  Does not rely on any paid APIs.  
+The returned data currently uses a lot of tokens, so it is recommended to always use limits when making requests.  
+
+## Features
+
+- Search Google News articles based on keyword, location, topic
+- Get top news stories from Google News
+- Google Trends keywords base on location
+- Optional NLP processing to summarize articles and extract keywords
+
+## 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"]
+    }
+  }
+}
+```
+</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"]
+      }
+    }
+  }
+}
+```
+</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 NLP (nltk)
+
+
+## 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
+```

google_news_trends_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "google-news-trends-mcp"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.10.18"
+authors = [
+    { name = "Jesse Manek", email = "jesse.manek@gmail.com" },
+]
+license = { text = "MIT" }
+dependencies = [
+    "asyncio>=3.4.3",
+    "click>=8.2.1",
+    "cloudscraper>=1.2.71",
+    "fastmcp>=2.9.2",
+    "gnews>=0.4.1",
+    "googlenewsdecoder>=0.1.7",
+    "lxml[html-clean]>=6.0.0",
+    "newspaper4k>=0.9.3.1",
+    "nltk>=3.9.1",
+    "playwright>=1.53.0",
+    "pydantic>=2.11.7",
+    "pytest>=8.4.1",
+    "pytest-asyncio>=1.0.0",
+    "trendspy>=0.1.6",
+]
+
+[project.scripts]
+google-news-trends-mcp = "google_news_trends_mcp.server:main"
+google-news-trends = "google_news_trends_mcp.cli:cli"
+
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[dependency-groups]
+dev = [
+    "anyio>=4.9.0",
+    "pytest-asyncio>=1.0.0",
+]
+
+
+[tool.pytest.ini_options]
+addopts = [
+    "--import-mode=importlib",
+]
+asyncio_mode = "auto"
+pythonpath = "src"

google_news_trends_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

google_news_trends_mcp-0.1.0/src/google_news_trends_mcp/__main__.py

@@ -0,0 +1,5 @@
+from google_news_trends_mcp.server import main
+
+
+if __name__ == "__main__":
+    main()

google_news_trends_mcp-0.1.0/src/google_news_trends_mcp/cli.py

@@ -0,0 +1,149 @@
+import click
+import asyncio
+from google_news_trends_mcp.news import (
+    get_news_by_keyword,
+    get_news_by_location,
+    get_news_by_topic,
+    get_trending_terms,
+    get_top_news,
+    save_article_to_json,
+)
+
+
+@click.group()
+def cli():
+    pass
+
+
+@cli.command(help=get_news_by_keyword.__doc__)
+@click.argument("keyword")
+@click.option(
+    "--period", type=int, default=7, help="Period in days to search for articles."
+)
+@click.option(
+    "--max-results",
+    "max_results",
+    type=int,
+    default=10,
+    help="Maximum number of results to return.",
+)
+@click.option(
+    "--no-nlp", is_flag=True, default=False, help="Disable NLP processing for articles."
+)
+def keyword(keyword, period, max_results, no_nlp):
+    articles = asyncio.run(
+        get_news_by_keyword(
+            keyword, period=period, max_results=max_results, nlp=not no_nlp
+        )
+    )
+    # asyncio.run(articles)  # Ensure the articles are fetched asynchronously
+    print_articles(articles)
+
+
+@cli.command(help=get_news_by_location.__doc__)
+@click.argument("location")
+@click.option(
+    "--period", type=int, default=7, help="Period in days to search for articles."
+)
+@click.option(
+    "--max-results",
+    "max_results",
+    type=int,
+    default=10,
+    help="Maximum number of results to return.",
+)
+@click.option(
+    "--no-nlp", is_flag=True, default=False, help="Disable NLP processing for articles."
+)
+def location(location, period, max_results, no_nlp):
+    articles = asyncio.run(
+        get_news_by_location(
+            location, period=period, max_results=max_results, nlp=not no_nlp
+        )
+    )
+    print_articles(articles)
+
+
+@cli.command(help=get_news_by_topic.__doc__)
+@click.argument("topic")
+@click.option(
+    "--period", type=int, default=7, help="Period in days to search for articles."
+)
+@click.option(
+    "--max-results",
+    "max_results",
+    type=int,
+    default=10,
+    help="Maximum number of results to return.",
+)
+@click.option(
+    "--no-nlp", is_flag=True, default=False, help="Disable NLP processing for articles."
+)
+def topic(topic, period, max_results, no_nlp):
+    articles = asyncio.run(
+        get_news_by_topic(topic, period=period, max_results=max_results, nlp=not no_nlp)
+    )
+    print_articles(articles)
+
+
+@cli.command(help=get_trending_terms.__doc__)
+@click.option(
+    "--geo", type=str, default="US", help="Country code, e.g. 'US', 'GB', 'IN', etc."
+)
+@click.option(
+    "--full-data", is_flag=True, default=False, help="Return full data for each trend."
+)
+@click.option(
+    "--max-results",
+    "max_results",
+    type=int,
+    default=100,
+    help="Maximum number of results to return.",
+)
+def trending(geo, full_data, max_results):
+    trending_terms = asyncio.run(
+        get_trending_terms(geo=geo, full_data=full_data, max_results=max_results)
+    )
+    if trending_terms:
+        print("Trending terms:")
+        for term in trending_terms:
+            print(f"- {term}")
+    else:
+        print("No trending terms found.")
+
+
+@cli.command(help=get_top_news.__doc__)
+@click.option(
+    "--period", type=int, default=3, help="Period in days to search for top articles."
+)
+@click.option(
+    "--max-results",
+    "max_results",
+    type=int,
+    default=10,
+    help="Maximum number of results to return.",
+)
+@click.option(
+    "--no-nlp", is_flag=True, default=False, help="Disable NLP processing for articles."
+)
+def top(period, max_results, no_nlp):
+    articles = asyncio.run(
+        get_top_news(max_results=max_results, period=period, nlp=not no_nlp)
+    )
+    print_articles(articles)
+    print(f"Found {len(articles)} top articles.")
+
+
+def print_articles(articles):
+    for article in articles:
+        print(f"Title: {article.title}")
+        print(f"URL: {article.original_url}")
+        print(f"Authors: {article.authors}")
+        print(f"Publish Date: {article.publish_date}")
+        print(f"Top Image: {article.top_image}")
+        print(f"Summary: {article.summary}\n")
+        save_article_to_json(article)
+
+
+if __name__ == "__main__":
+    cli()