Skip to main content
Glama
TrendPulse - Google News & Trends

TrendPulse - Google News & Trends

mcp-trendpulse

MCP Python License

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_trends

  • analyze_keyword_trend

  • compare_keyword_trends

  • discover_related_demand

  • get_trend_context

  • find_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-trendpulse

Sobald eine PyPI-Veröffentlichung existiert, lautet die kürzere Form:

uvx mcp-trendpulse

Mit pip aus einem Checkout installieren

git clone https://github.com/AKzar1el/mcp-trendpulse.git
cd mcp-trendpulse
python -m pip install .
python -m mcp_trendpulse

Browser-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 chromium

Für Linux-Umgebungen, die zusätzlich Browser-Systemabhängigkeiten benötigen:

playwright install --with-deps chromium

Reine 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.0

GOOGLE_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

get_news_by_keyword

Findet aktuelle Nachrichtenartikel, die zu einem Keyword passen.

get_news_by_location

Findet aktuelle Nachrichten zu einem Standort.

get_news_by_topic

Findet aktuelle Nachrichten für ein unterstütztes Google-News-Thema.

get_top_news

Ruft die Top-Google-News-Meldungen ab.

get_news_by_site

Findet aktuelle Nachrichten von einer bestimmten Publisher-Domain.

get_article_content

Lädt eine Artikel-URL herunter, validiert, extrahiert und fasst sie optional zusammen.

Trend-Tools

Tool

Zweck

get_trending_terms

Ruft aktuelle Trendbegriffe für ein geografisches Ziel ab.

get_trends

Ruft Interest-over-Time-Punkte für ein oder mehrere Keywords ab.

get_growth

Berechnet das Suchinteresse-Wachstum über angeforderte Zeitfenster.

get_ranked_trends

Ordnet aktuelle Trends nach Wachstum oder Volumen.

get_top_trends

Ruft einen Top-Trends-Feed ab, ohne ein Keyword anzugeben.

get_interest_by_region

Vergleicht das Keyword-Interesse über geografische Regionen hinweg.

get_related_queries

Ruft die wichtigsten und steigenden verwandten Suchanfragen ab.

get_related_topics

Ruft die wichtigsten und steigenden verwandten Google-Trends-Themen ab.

get_suggestions

Löst Autovervollständigungs-/Themenvorschläge für eine Suchanfrage auf.

get_categories

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 --help

Aktuelle CLI-Befehle:

keyword
location
top
topic
trending

Die 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 pytest

Die Standard-pytest-Konfiguration schließt Live-Integrationstests aus.

Führen Sie Live-Anbieter-Tests explizit mit:

python -m pytest tests/integration -m integration

Als 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-trendpulse

Für einen lokalen Checkout:

npx @modelcontextprotocol/inspector uv run mcp-trendpulse

Paketierung

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:

  1. Dokumentation, Verpackungsmetadaten und generierte MCP-Manifeste konsistent mit der Live-Tool-Oberfläche zu halten.

  2. Kontinuierliche Integration für Unit-Tests und statische Prüfungen hinzuzufügen.

  3. Provider-Zugriff von der Domain-Logik von TrendPulse zu trennen, sodass Provider geändert werden können, ohne die MCP-Schicht neu zu schreiben.

  4. Einen produktiven Remote-HTTP-Transport hinzuzufügen, während der lokale Stdio-Betrieb erhalten bleibt.

  5. Eine kleinere High-Level-Hosted-Tool-Oberfläche für ChatGPT/Codex zu entwerfen.

  6. Den gehosteten Dienst in die DigestSEO-Anwendung und den Betriebs-Stack zu integrieren.

  7. Das gehostete MCP erst nach Produktionsreife des Dienstes als OpenAI-Plugin zu verpacken und zu testen.

Lizenz

MIT. Siehe LICENSE.

Available Tools

16 tools
get_article_contentA
Read-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_categoriesA
Read-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_growthA
Read-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_regionA
Read-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_keywordA
Read-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_locationA
Read-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_siteA
Read-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_topicA
Read-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_suggestionsA
Read-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_newsA
Read-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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server providing news article mention volume data, weekly series, growth percentages, and a live Google News feed as an AI tool.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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 PyPI
      8
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -