Google Trends MCP

Ein lokaler MCP-Server, der Claude (oder jedem anderen MCP-Client) erlaubt, Google Trends direkt abzufragen — Suchinteresse im Zeitverlauf, verwandte Suchanfragen und Themen, regionale Aufschlüsselungen und Trend-Suchen in Echtzeit. So können Sie Marktforschung direkt in einem Gespräch betreiben, statt zu trends.google.com zu wechseln und Screenshots wieder einzufügen.

Entwickelt für persönliche Marktforschung. Kein API-Schlüssel erforderlich — Google Trends hat keine offizielle öffentliche API, daher kapselt dieses Projekt pytrends, den üblichen inoffiziellen Python-Client, in einen MCP-Server.

Werkzeuge

Alle Werkzeuge verwenden standardmäßig geo="IN" (Indien), sofern nicht anders angegeben — für weltweite Suchanfragen geo="E" (weltweit) setzen oder einen beliebigen ISO-Ländercode angeben ("US", "GB", usw.). timeframe akzeptiert das Pytrends-Format, z. B. "today 12-m", "today 5-y", "now 7-d" oder einen expliziten Zeitraum "2024-01-01 2024-06-01".

interest_over_time(time, timeframe="today 12-m", geo="IN")

Relatives Suchinteresse (0–100) im Zeitverlauf für bis zu 5 Suchbegriffe, nebeneinander verglichen. Weitere Suchbegriffe über den ersten fünf hinaus werden stillschweigend verworfen. Jeder Datensatz enthält isPartial – wenn dieser beim aktuellsten Datenpunkt true ist, bedeutet das, dass dieser Zeitraum noch nicht abgeschlossen ist und der Wert vorläufig; werten Sie einen Abfall an diesem Punkt nicht als echte Trendänderung.

related_queries(keyword, timeframe="today 12-m", geo="IN")

Top- und steigende verwandte Suchanfragen für ein einzelnes Keyword. Gibt {"top": [...], "rising": [... ]} zurück, jeweils eine Liste von Einträgen der Form {"query": ... , "value": ...}. top-Werte sind relatives Interesse von 0–100. rising-Werte sind die prozentuale Zunahme — **außer bei** einem Wert von 5000%`, der Googles „Breakout"-Marker für explosives Wachstum von einer Basis nahe null ist, und keine wörtliche Prozentangabe darstellt.

related_topics(keyword, timeframe="today 12-m", geo="IN")

Wie related_queries, nur mit Themen-Clustern (Googles eigenen Themen-Gruppierungen) anstelle roher Suchanfrage-Strings — Einträge enthalten topic_title und topic_type zusätzlich zu value. Für rising gilt die gleiche Breakout-Konvention.

interest_by_region(keyword, timeframe="today 12-m", geo="IN")

Suchinteresse für ein Keyword, nach Bundesland/Region innerhalb des angegebenen geo aufgeschlüsselt. Gibt eine Liste von Einträgen {"geoName": ..., "<keyword>": 0-100} zurück, einen pro Region.

trending_now(geo="india")

Die heutigen Top-Trendsuchen für ein Land. Beachten Sie: Das geo-Format ist hier anders – es ist ein vollständiger Ländername in Kleinbuchstaben ("india", "united_states"), nicht ein ISO-Code wie bei den anderen vier Werkzeugen. Dies ist eine echte Inkonsistenz in Googles eigenen Endpunkten, kein Bug.

Bekannte Einschränkung: Standjetzt schlägt trending_now mit HTTP 404 fehl. Google scheint die Legacy-Endpunkte (hottrends/dailytrends/realtimetrends), von denen pytrends' Trend-Suchmethoden abhängen, eingestellt zu haben – bestätigt durch Tests aller drei Varianten, die pytrends anbietio. Dies ist ein Upstream-Problem und in dieser Codebasis nicht behebbar; es meldet sich sauber mit einer lesbaren Fehlerzeichenfolge statt mit einem Crash. Die anderen vier Werkzeuge verwenden eine andere, weiterhin funktionale Endpunkt-Familie und sind nicht betroffen. Wenn Google den Endpunkt wiederherstellt oder pytrends einen Workaround liefert, wird dies ohne Änderungen hier wieder funktionieren.

Alle Werkzeuge fangen Fehler ab (Rate Limits, Netzwerkfehler, all das oben Genannte) und einen klaren Fehlerstring statt eines Crashes — Google Trends is a scraped endpoint, not a stable API, so this is expected behavior, not an exception.

Setup

Erfordert Python 3.10+ und uv.

git clone https://github.com/jain-eshan/google-trends-mcp.git
cd google-trends-mcp
uv sync

Bei Claude Code registrieren

claude mcp add google-trends -- uv run --directory /absolute/path/to/google-trends-mcp server.py

Verifizieren Sie die Verbindung:

claude mcp list

Sie sollten google-trends als ✔ Connected sehen. Starten Sie nach der Registrierung eine neue Claude-Code-Konversation — bereits laufende Sessions werden einen neu hinzugefügten Server nicht übernehmen.

Verwenung

Sobald registriert, einfach Claude sagen, es zu nutzen — z.B.:

„Nutze den google-trends MCP, um das Interesse an ‚lab grown diamonds' im Vergleich zu ‚diamond jewellery' in Indien über die letzten 12 Monaten zu vergleichen, und zeig mir verwandte Suchanfragen."

Optional: die /trends-Fähigkeit

Dieses Repository bietet eine Claude-Code-Fähigkeit unter .claude/skills/trends/SKILL.md, die die Rohwerkzeuge in einen Recherche-und-Synthese-Workflow einbindet – sie entscheidet, welche Werkzeuge für dein Thema relevant sind, und schreibt eine verständliche Zusammenfassung statt roher JSON-Ausgabe. Wenn Sie Claude Code verwenden, wird diese Fähigkeit automatisch aus diesem Repository übernommen; führen Sie einfach:

/trends <your topic>

Hinweise zum Design

• Nur Daten, keine Synthese im Server. Jedes Werkzeug liefert rohe, strukturierte Daten — die Interpretation (ist dieserTrend garantiert, was bedeutet eine Breakout-Markierung hier, was sollte hervorgehoben werden) passiert in der aufrufenden Konversation, nicht im Server. Das hält den Server einfach and lässt dem Aufrufer (Claude oder einem anderen MCP-Client) sein eigenes Urteil.

• Keine Abhängigkeiten über mcp[cli] und pytrends hinaus. Keine Datenbank, keino Konfigurations-datei, kein API-Schlüssel.

• Keine formale Testsuite. Das umhüllt einen gescrapten Drittanbieter-Endpunkt; eine Testsuite würde hauptsächlich pytrends und Googles aktuelle Antwortformat testen, nicht diesen Code. Stattdessen wurde jedes Werkzeug während der Entwicklung mit echten Google-Trends:-Daten verifiziert.

Lizenz

MIT — siehe LICENSE.