TrendPulse - Google News & Trends
mcp-trendpulse
TrendPulse ist ein Python-Model-Context-Protocol-(MCP)-Server zur Recherche aktueller Nachrichten- und Suchinteressen-Trends. Er kombiniert das Auffinden von Google News und die Extraktion von Artikeln mit der Google-Trends-Analyse, damit MCP-Clients untersuchen können, was im Trend liegt, Keyword-Momentum vergleichen, verwandte Nachfrage erkunden und Recherche-Workflows um aktuelle Nachrichtenkontexte ergänzen können.
Das Projekt wird derzeit als Community-/Self-hosted-MCP-Server ausgeliefert und enthält außerdem die Implementierung für eine separate gehostete TrendPulse by DigestSEO-Schnittstelle für Remote-MCP-Clients wie ChatGPT und Codex. Die gehostete Ebene verwendet eine kleinere, zielorientierte Tool-Oberfläche, während der Community-Server den Entwicklern den vollständigen Low-Level-Recherche-Werkzeugkasten zur Verfügung hält.
Projektstatus: Der lokale/Community-Server ist heute nutzbar. Das von DigestSEO gehostete MCP und das öffentliche OpenAI-Plugin sind noch nicht veröffentlicht und sollten nicht als verfügbare Endpunkte behandelt werden.
Technischer Kontext: TrendPulse ist Teil des DigestSEO-MCP-Ökosystems. Es ergänzt mcp-gsc für Google-Search-Console-Daten, mcp-geo für KI-Sichtbarkeit und mcp-web-validator für die technische Web-Validierung. Die übergeordnete Architektur ist in der Engineering-Fallstudie zur DigestSEO MCP Suite dokumentiert.
Was TrendPulse kann
Nachrichten-Recherche
Google News nach Keyword, Standort, Thema oder Publisher-Domain durchsuchen.
Top-News-Meldungen abrufen.
Google-News-Links auflösen und Artikelinhalte extrahieren.
Bei schwierigen Seiten von der normalen HTTP-Abfrage auf Playwright/Chromium zurückgreifen.
Artikelttext optional mit MCP-Client-Sampling zusammenfassen, mit lokalem NLP als Fallback.
Trend-Recherche
Aktuelle Trendbegriffe für einen geografischen Markt abrufen.
Google-Trends-Interest-over-Time-Daten für ein oder mehrere Keywords abrufen.
Keyword-Wachstum über benutzerdefinierte Zeitfenster wie 3M oder 1Y berechnen.
Live-Trends nach Volumen oder Wachstum ordnen.
Interesse nach Land, Region, Stadt oder DMA untersuchen, sofern unterstützt.
Verwandte Suchanfragen, verwandte Themen, Vorschläge und Kategorie-IDs erkunden.
Google Search, YouTube Search, News Search, Image Search und Google Shopping Trend-Eigenschaften vergleichen, sofern vom zugrunde liegenden Anbieter unterstützt.
Related MCP server: NewsIQ MCP
Community- und gehostete Architektur
TrendPulse wird mit zwei bewusst gestalteten Schnittstellen entwickelt:
Schnittstelle | Zweck | Status |
Community MCP | Vollständiger Python-MCP-Server für lokale Nutzung, Entwicklung, Self-Hosting und Integrationen mit MCP-kompatiblen Clients. | In diesem Repository verfügbar |
TrendPulse by DigestSEO | Gemanagtes Remote-MCP für ChatGPT/Codex und ein zukünftiges öffentliches OpenAI-Plugin mit einer kleineren, aufgabenorientierten Tool-Oberfläche. | In Entwicklung |
Der Community-Server bleibt unabhängig nützlich. Die gehostete Edition wird dieselben Kernkonzepte der Trendrecherche wiederverwenden und gleichzeitig die Bereitstellung, Zuverlässigkeit, Authentifizierung, Beobachtbarkeit und Produktintegration hinzufügen, die für einen verwalteten Dienst erforderlich sind.
Die implementierte gehostete Tool-Oberfläche ist bewusst auf einer höheren Ebene angesiedelt als die Community-API und konzentriert sich auf Ziele wie:
discover_trendsanalyze_keyword_trendcompare_keyword_trendsdiscover_related_demandget_trend_contextfind_seo_opportunities
Diese Namen beschreiben die gehostete ChatGPT-Apps/MCP-Schnittstelle; sie bleiben getrennt von den aktuellen Community-MCP-Toolnamen.
Installation
Direkt über GitHub mit uvx ausführen (empfohlen)
Das Paket ist noch nicht auf PyPI veröffentlicht, daher ist der direkteste Installationsweg:
uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulseSobald eine PyPI-Veröffentlichung existiert, lautet die kürzere Form:
uvx mcp-trendpulseMit pip aus einem Checkout installieren
git clone https://github.com/AKzar1el/mcp-trendpulse.git
cd mcp-trendpulse
python -m pip install .
python -m mcp_trendpulseBrowser-Fallback
Nachrichten-/Artikeltools können auf Playwright zurückgreifen, wenn die normale Abfrage keinen brauchbaren Artikel extrahieren kann. Die Installation des Python-Pakets playwright installiert Chromium nicht automatisch.
Für lokale Nutzung:
playwright install chromiumFür Linux-Umgebungen, die zusätzlich Browser-Systemabhängigkeiten benötigen:
playwright install --with-deps chromiumReine Trend-Operationen erfordern grundsätzlich kein Chromium.
Client-Konfiguration
Claude Desktop
Verwendung von uvx direkt von GitHub:
{
"mcpServers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}VS Code
{
"mcp": {
"servers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}
}Cursor
Cursor unterstützt globale und projektspezifische MCP-Konfiguration. Fügen Sie den Server der relevanten mcp.json-Konfiguration hinzu:
{
"mcpServers": {
"mcp-trendpulse": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AKzar1el/mcp-trendpulse.git",
"mcp-trendpulse"
]
}
}
}ChatGPT und andere Cloud-MCP-Clients
Das Repository enthält jetzt einen dedizierten zustandslosen Streamable-HTTP-ASGI-Einstiegspunkt unter mcp_trendpulse.asgi:app. Dieser ist getrennt vom Community-stdio-Einstiegspunkt, der unverändert bleibt.
Für kontrollierte lokale/private Tests können Sie die ASGI-App mit Uvicorn ausführen oder den bereitgestellten Container verwenden. Siehe deploy/README.md für den gehärteten Container, Host/Origin-Allowlists, Chromium-Sandbox-Anforderungen, Health-/Readiness-Endpunkte und Reverse-Proxy-Hinweise.
Der von DigestSEO gehostete Endpunkt und die öffentliche ChatGPT-App sind noch nicht veröffentlicht. Gehostete Bereitstellungen unterstützen jetzt eine Clerk-OAuth-Authentifizierung mit Fail-closed-Verhalten; setzen Sie den Remote-Transport nicht öffentlich ein, es sei denn, die Clerk-Issuer-/JWKS-/Audience-Einstellungen, die öffentliche Basis-URL und die Host/Origin-Allowlists sind für diese Bereitstellung konfiguriert.
Konfiguration
TrendPulse lädt Umgebungsvariablen aus der Prozessumgebung und, falls vorhanden, aus einer lokalen .env-Datei.
Nützliche Variablen sind:
HTTP_PROXY=http://your-proxy-address:port
HTTPS_PROXY=http://your-proxy-address:port
GOOGLE_TRENDS_DELAY=2.0GOOGLE_TRENDS_DELAY steuert die Anforderungsverzögerung, die der aktuelle Trends-Anbieter verwendet. Proxy-Variablen können nützlich sein, wenn der vorgelagerte Dienst ein bestimmtes Netzwerk drosselt oder blockiert.
Remote-Bereitstellungen unterstützen außerdem TRENDPULSE_HTTP_PATH, TRENDPULSE_HTTP_ALLOWED_HOSTS, TRENDPULSE_HTTP_ALLOWED_ORIGINS und TRENDPULSE_BROWSER_SANDBOX. Der Container aktiviert die Chromium-Sandbox explizit; lokale Community-Ausführungen behalten die Playwright-kompatible Standardeinstellung bei, sofern Sie nicht ausdrücklich zustimmen.
Committen Sie keine Geheimnisse, privaten Proxy-Zugangsdaten oder maschinenspezifischen .env-Dateien.
MCP-Tools
Der Community-MCP-Server stellt derzeit 16 Tools bereit.
Nachrichten-Tools
Tool | Zweck |
| Findet aktuelle Nachrichtenartikel, die zu einem Keyword passen. |
| Findet aktuelle Nachrichten zu einem Standort. |
| Findet aktuelle Nachrichten für ein unterstütztes Google-News-Thema. |
| Ruft die Top-Google-News-Meldungen ab. |
| Findet aktuelle Nachrichten von einer bestimmten Publisher-Domain. |
| Lädt eine Artikel-URL herunter, validiert, extrahiert und fasst sie optional zusammen. |
Trend-Tools
Tool | Zweck |
| Ruft aktuelle Trendbegriffe für ein geografisches Ziel ab. |
| Ruft Interest-over-Time-Punkte für ein oder mehrere Keywords ab. |
| Berechnet das Suchinteresse-Wachstum über angeforderte Zeitfenster. |
| Ordnet aktuelle Trends nach Wachstum oder Volumen. |
| Ruft einen Top-Trends-Feed ab, ohne ein Keyword anzugeben. |
| Vergleicht das Keyword-Interesse über geografische Regionen hinweg. |
| Ruft die wichtigsten und steigenden verwandten Suchanfragen ab. |
| Ruft die wichtigsten und steigenden verwandten Google-Trends-Themen ab. |
| Löst Autovervollständigungs-/Themenvorschläge für eine Suchanfrage auf. |
| Ruft Google-Trends-Kategorie-IDs und -Namen ab. |
Beispiel: explizites Trend-Zeitfenster
get_trends akzeptiert ein explizites timeframe. Die Angabe eines expliziten Zeitfensters ist vorzuziehen, wenn Sie reproduzierbare Vergleiche benötigen.
{
"keyword": ["technical SEO audit", "AI SEO audit"],
"geo": "US",
"source": "google search",
"timeframe": "today 12-m",
"cat": 0
}Die unterstützten Anbieterbereiche umfassen Standardfenster wie today 12-m und today 5-y, relative Fenster wie today 90-d, all sowie exakte Datumsbereiche wie 2021-01-01 2026-01-01.
Google-Trends-Werte sind normalisierte Interessenwerte. Interpretieren Sie eine 0-100-Interessenreihe nicht als absolutes Suchvolumen.
CLI
Die separate Click-CLI bietet einen kleineren, nachrichtenorientierten Befehlssatz als der MCP-Server:
uv run mcp-trendpulse-cli --helpAktuelle CLI-Befehle:
keyword
location
top
topic
trendingDie CLI- und MCP-Schnittstellen werden bewusst getrennt dokumentiert, da sie nicht denselben Befehlssatz bereitstellen.
Entwicklung
Installieren Sie das Projekt mit seinen Entwicklungsabhängigkeiten in Ihrer bevorzugten Python-Umgebung und führen Sie dann die Unit-Testsuite aus:
python -m pytestDie Standard-pytest-Konfiguration schließt Live-Integrationstests aus.
Führen Sie Live-Anbieter-Tests explizit mit:
python -m pytest tests/integration -m integrationAls Browser gekennzeichnete Integrationstests erfordern installiertes Playwright-Chromium.
Führen Sie Ruff-Prüfungen mit:
ruff check .MCP Inspector
Führen Sie den über GitHub veröffentlichten Server mit dem MCP Inspector aus:
npx @modelcontextprotocol/inspector uvx --from git+https://github.com/AKzar1el/mcp-trendpulse.git mcp-trendpulseFür einen lokalen Checkout:
npx @modelcontextprotocol/inspector uv run mcp-trendpulsePaketierung
Ein GitHub-Actions-Workflow ist bereits vorhanden, um Python-Distributionen über PyPI Trusted Publishing zu erstellen und zu veröffentlichen, wenn ein GitHub-Release veröffentlicht wird. Bis zur ersten Paketveröffentlichung verwenden Sie den oben gezeigten GitHub-Befehl uvx --from ....
Sicherheitshinweise
Der Artikelabruf ist eine ausgehende Netzwerkfunktion und wird als nicht vertrauenswürdige Eingabe behandelt. Die Implementierung validiert HTTP(S)-Ziele, lehnt private und nicht routbare Ziele ab, prüft Redirect-Ziele, erzwingt Antwortgrößen-Limits und wendet bei Verwendung von Playwright eine Browser-Routenvalidierung an.
Wenn Sie TrendPulse remote bereitstellen, behalten Sie diese Kontrollen bei und fügen Sie Ratenbegrenzung, Anforderungs-Timeouts, Beobachtbarkeit und Ressourcenlimits auf Bereitstellungsebene hinzu, anstatt sich nur auf Anwendungsstandards zu verlassen.
Roadmap
Die aktuelle Arbeit an der Produktionsreife konzentriert sich auf:
Dokumentation, Verpackungsmetadaten und generierte MCP-Manifeste konsistent mit der Live-Tool-Oberfläche zu halten.
Kontinuierliche Integration für Unit-Tests und statische Prüfungen hinzuzufügen.
Provider-Zugriff von der Domain-Logik von TrendPulse zu trennen, sodass Provider geändert werden können, ohne die MCP-Schicht neu zu schreiben.
Einen produktiven Remote-HTTP-Transport hinzuzufügen, während der lokale Stdio-Betrieb erhalten bleibt.
Eine kleinere High-Level-Hosted-Tool-Oberfläche für ChatGPT/Codex zu entwerfen.
Den gehosteten Dienst in die DigestSEO-Anwendung und den Betriebs-Stack zu integrieren.
Das gehostete MCP erst nach Produktionsreife des Dienstes als OpenAI-Plugin zu verpacken und zu testen.
Lizenz
MIT. Siehe LICENSE.
Available Tools
16 toolsget_article_contentARead-only
Download and parse one specific news article when you already have an article URL. Use it to retrieve article text or metadata or summarize that URL; do not use it for discovery - use the news search tools instead.
Inputs: url (required), full_data, summarize. Returns: result
get_categoriesARead-only
Return a bounded page of Google Trends category IDs and names for use in the cat parameter of trend tools. Use query to find categories by name and offset/limit to page through broader results; do not guess category IDs.
Inputs: limit, query, offset. Returns: result
get_growthARead-only
Estimate momentum for one or more known keywords across requested growth windows. Use this when percentage growth is the goal; use get_trends when the user needs the underlying historical time series.
Inputs: keyword (required), geo, source, percent_growth. Returns: result
get_interest_by_regionARead-only
Return geographic Google Trends interest for one or more known keywords at country, region, city, or DMA resolution. Use this to compare where demand is strongest; use get_trends for interest over time instead.
Inputs: keywords (required), cat, geo, gprop, +3 more. Returns: result
get_news_by_keywordARead-only
Find recent Google News articles for a free-form keyword or phrase. Use this for ad-hoc subject searches; use get_news_by_topic for a predefined topic category or get_news_by_site for one publisher.
Inputs: keyword (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_locationARead-only
Find recent Google News articles about a place-focused location such as a city, state, or country. Use this when geography is the primary filter; use get_news_by_keyword for general subject searches.
Inputs: location (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_siteARead-only
Find recent Google News articles from one publisher domain. Use this when the user wants source-specific coverage; use get_news_by_keyword for cross-publisher subject search.
Inputs: site (required), period, full_data, summarize, +2 more. Returns: result
get_news_by_topicARead-only
Find recent Google News articles from a predefined Google News topic category. Use this for topic category browsing such as BUSINESS, TECHNOLOGY, or SPORTS; use get_news_by_keyword for a free-form query.
Inputs: topic (required), period, full_data, summarize, +2 more. Returns: result
get_ranked_trendsARead-only
Return ranked terms in the Google Trending Now 24-hour feed by provider-reported recent growth or approximate volume. The growth percentage has no stated comparison baseline and is NOT a week-over-week change. Use get_top_trends for a simpler current feed and get_trends for historical series.
Inputs: geo, sort, limit, source. Returns: result
get_suggestionsARead-only
Return Google Trends autocomplete suggestions for a seed keyword. Use this for lightweight autocomplete or entity candidates; use get_related_queries when you need top or rising demand signals.
Inputs: keyword (required), language. Returns: result
get_top_newsARead-only
Return general headline and top-news stories from Google News without a keyword or topic seed. Use this for a broad news snapshot; use the keyword, location, topic, or site tools when the user gives a filter.
Inputs: period, full_data, summarize, max_results, +1 more. Returns: result
get_top_trendsARead-only
Return a bounded current topic discovery feed from Google Trends RSS, including related news where available. Use this for current top or daily trends; use get_ranked_trends when explicit ranking by growth or volume matters.
Inputs: geo, type, limit. Returns: result
get_trending_termsARead-only
Return terms that are trending now for a geography, optionally with related news metadata. Use this for current trend discovery; use get_trends when the user wants historical interest over time for known keywords.
Inputs: geo, full_data. Returns: result
get_trendsARead-only
Return historical Google Trends interest-over-time points for one or more known keywords. Use this for trajectory and comparisons across a timeframe; values are normalized 0-100 interest scores, not absolute search volume. Use get_trending_terms for what is trending now.
Inputs: keyword (required), cat, geo, source, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
The news tools are cleanly separated by filter (keyword, location, topic, site, top), and trend tools mostly include explicit cross-references to guide selection. The main overlap is among get_ranked_trends, get_top_trends, and get_trending_terms, which all surface current trends, though descriptions provide clear usage cues.
All tools use snake_case with a get_ verb prefix and noun-based names such as get_news_by_topic, get_interest_by_region, and get_related_queries. The pattern is predictable throughout, with only natural variation between get_news_by_* and get_top_* forms.
Sixteen tools cover two related but distinct domains—Google News search and Google Trends analysis—and each maps to a specific query type. The count is slightly above the ideal 3–15 range but remains reasonable for the breadth of functionality.
The surface covers news discovery across keyword, location, topic, site, and top stories, plus article retrieval and a broad Trends lifecycle including historical interest, growth, regional interest, categories, related queries/topics, suggestions, and current trends. Minor gaps include no date-range or language filters for news search and no batch article retrieval, but core workflows are well supported.
Maintenance
Related MCP Connectors
MCP server for Google Veo AI video generation
MCP server for Google search results via SERP API
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.MIT
- FlicenseNot gradedqualityDmaintenanceAn AI-powered news aggregator MCP server that fetches live news from multiple sources, provides AI summaries via Claude, and performs sentiment analysis and trending topic detection.-
- AlicenseNot gradedqualityCmaintenanceA persistent news intelligence MCP server that enables AI agents to fetch, store, deduplicate, embed, and semantically query news from Google News across 141 countries and 41 languages.34 PyPI8MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes Google Trends data via BigQuery, enabling LLMs to query top search terms, rising terms, and compare term interest over time for different countries.-