Yandex Wordstat MCP

Yandex Wordstat MCP verbindet eine KI-Anwendung mit der Statistik der Suchanfragen von Yandex. Fragen Sie, wie oft eine Phrase gesucht wird, in welchen Monaten das Interesse steigt und in welchen Städten das Thema beliebter ist – der Assistent sammelt die Wordstat-Daten und erklärt das Ergebnis. Der Server arbeitet über die Yandex Cloud Search API und benötigt daher keinen Zugriff auf das Werbekonto von Direct.

• Fünf Werkzeuge. Top- und ähnliche Anfragen, Nachfragedynamik, Verteilung nach Regionen, Regionenverzeichnis und technische Anfrage an die API.

• Nur lesen. Die Wordstat-API erstellt keine Kampagnen, Anzeigen, Schlüsselphrasen oder andere Objekte.

• Nachfrage und Saisonalität. Top-Anfragen und Regionen zeigen die letzten 30 Tage; die Dynamik wird nach Tagen, Wochen oder Monaten für den gewünschten Zeitraum erstellt.

• Region und Gerät. Berichte können auf eine Region eingegrenzt und die Nachfrage auf Computern, Telefonen und Tablets verglichen werden.

• Ohne Direct-OAuth. Benötigt werden ein API-Schlüssel und die Katalog-ID von Yandex Cloud für die Search API.

Beginnen Sie mit einer sicheren Anfrage:

Wie oft wird „Fahrrad kaufen“ pro Monat gesucht und welche ähnlichen Anfragen gibt es?

Server verbinden · Szenarien ansehen · Technische Dokumentation öffnen

In einer Minute in Aktion sehen

Related MCP server: yandex-searchapi-mcp

Inhalt

• Schnellstart

• Was kann man aufgeben

• So lesen Sie Nachfragedaten

• So erhalten Sie Zugriff

• Was kann die Daten ändern

• Daten, Limits und Hintergrundarbeit

• Technische Dokumentation

• Support

Schnellstart

Benötigt werden Node.js 20 oder neuer, ein API-Schlüssel von Yandex Cloud für die Search API und die Katalog-ID von Yandex Cloud.

1. Erhalten Sie Zugriff und fügen Sie den Server in die KI-Anwendung ein – Anleitungen für fünf Anwendungen unten.

2. Fragen Sie: „Wie oft wird ‚Fahrrad kaufen‘ pro Monat gesucht und welche ähnlichen Anfragen gibt es?“

Über die Anwendungsoberfläche:

1. Öffnen Sie Settings → Plugins → MCP servers.

2. Klicken Sie auf Add server.

3. Fügen Sie den Startbefehl npx -y mcp-yandex-wordstat@latest und die Umgebungsvariablen WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID hinzu.

Über die Befehlszeile:

codex mcp add yandex-wordstat \
  --env WORDSTAT_API_KEY=ваш_ключ \
  --env WORDSTAT_FOLDER_ID=ваш_folder_id \
  -- npx -y mcp-yandex-wordstat@latest

Verbindung prüfen:

codex mcp list

Offizielle Codex-Anleitung

claude mcp add \
  --env WORDSTAT_API_KEY=ваш_ключ \
  --env WORDSTAT_FOLDER_ID=ваш_folder_id \
  --transport stdio \
  --scope user \
  yandex-wordstat \
  -- npx -y mcp-yandex-wordstat@latest

Server prüfen:

claude mcp list

Claude-Code-Dokumentation

Öffnen Sie Settings → Developer → Edit Config und fügen Sie den Server in claude_desktop_config.json ein:

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-wordstat@latest"],
      "env": {
        "WORDSTAT_API_KEY": "ваш_ключ",
        "WORDSTAT_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

Wenn Edit Config nicht verfügbar ist, bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json auf macOS oder %APPDATA%\Claude\claude_desktop_config.json auf Windows.

Für alle Projekte erstellen Sie ~/.cursor/mcp.json; nur für das aktuelle Projekt – .cursor/mcp.json:

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-wordstat@latest"],
      "env": {
        "WORDSTAT_API_KEY": "ваш_ключ",
        "WORDSTAT_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

Cursor-Dokumentation

Öffnen Sie die Befehlspalette und führen Sie MCP: Open User Configuration aus. Fügen Sie in mcp.json ein:

{
  "servers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-wordstat@latest"],
      "env": {
        "WORDSTAT_API_KEY": "${input:wordstat_api_key}",
        "WORDSTAT_FOLDER_ID": "${input:wordstat_folder_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "wordstat_api_key",
      "description": "API-ключ Yandex Cloud",
      "password": true
    },
    {
      "type": "promptString",
      "id": "wordstat_folder_id",
      "description": "ID каталога Yandex Cloud"
    }
  ]
}

Prüfen Sie den Start mit dem Befehl MCP: List Servers.

VS-Code-Dokumentation

Was kann man aufgeben

Anfragen auswählen und Nachfrage bewerten

• „Wie oft wird diese Phrase pro Monat gesucht und welche ähnlichen Anfragen gibt es?“

• „Suche Anfragen rund um ‚Pizza-Lieferung‘ mit ihrer Häufigkeit.“

• „Zeige Anfragen, die meine Phrase enthalten, getrennt von semantisch ähnlichen.“

Saisonalität verstehen

• „Zeige die Nachfrage nach ‚Ski‘ nach Monaten für ein Jahr.“

• „In welchen Wochen steigt oder fällt die Nachfrage nach dieser Dienstleistung?“

• „Vergleiche die Dynamik der Anfrage auf Telefonen und Computern.“

Regionen vergleichen

• „In welchen Städten ist das Interesse an ‚Wohnungsrenovierung‘ überdurchschnittlich?“

• „Vergleiche die Nachfrage in Moskau und Sankt Petersburg.“

• „Finde die ID der gewünschten Region und grenze den nächsten Bericht darauf ein.“

So lesen Sie Nachfragedaten

top_requests zeigt beliebte Anfragen, die die angegebene Phrase enthalten, sowie semantisch ähnliche Anfragen. Der gesamte totalCount bezieht sich auf die letzten 30 Tage.

dynamics liefert eine Reihe {date, count, share} mit täglicher, wöchentlicher oder monatlicher Detaillierung. regions verteilt die Nachfrage der letzten 30 Tage auf Regionen, und ein affinityIndex über 100% bedeutet überdurchschnittliches Interesse. Zählerwerte können als Zeichenfolgen kommen: Yandex überträgt große ganze Zahlen in JSON in dieser Form.

Ein Aufruf erstellt Daten nur für eine Phrase. Für eine große Liste von Schlüsselwörtern ist es besser, die Liste zuerst einzugrenzen, anstatt alle Anfragen nacheinander auszuführen: Das Kontingent der Yandex Cloud Search API ist für einen Schlüssel gemeinsam.

So erhalten Sie Zugriff

1. Erstellen Sie in Yandex Cloud ein Dienstkonto mit der Rolle search-api.webSearch.user.

2. Stellen Sie dafür einen API-Schlüssel mit dem Scope yc.search-api.execute aus – die Schritte sind in der Dokumentation von AI Studio beschrieben.

3. Finden Sie die Katalog-ID (folderId) in der Yandex-Cloud-Konsole auf der Katalogseite und in der Seiten-URL.

4. Übergeben Sie den Schlüssel als WORDSTAT_API_KEY und den Katalog als WORDSTAT_FOLDER_ID.

Der Server greift auf die Yandex Cloud Search API v2 zu. Die alte separate Wordstat-API mit OAuth wird nicht verwendet. Der API-Schlüssel wird in der Konfiguration des MCP-Clients im Klartext gespeichert – behandeln Sie ihn wie ein Passwort.

Was kann die Daten ändern

Nichts in Yandex Wordstat. Alle fünf Werkzeuge, einschließlich raw_request, arbeiten nur lesend. Technisch verwendet die API POST, aber Wordstat hat keine Schreib-Endpunkte; der Server erlaubt zusätzlich nicht, dass eine beliebige Anfrage an einen anderen Host geht.

Daten, Limits und Hintergrundarbeit

• Aggregierte Daten. Der Server erhält Statistiken zur Suchnachfrage, nicht Daten eines bestimmten Werbekontos.

• Cache des Regionenverzeichnisses. In einem langlebigen Prozess wird der Regionsbaum einmal geladen und in den folgenden Anfragen wiederverwendet.

• Wiederholungen bei temporären Fehlern. Das Timeout einer einzelnen Anfrage beträgt 60 Sekunden. Der Server macht bis zu drei Wiederholungen nach 429, 5xx, Netzwerkfehler oder Timeout; er berücksichtigt Retry-After, und die Verzögerung überschreitet 30 Sekunden nicht.

• Keine Hintergrundbeobachtung. Der Server arbeitet, wenn die KI-Anwendung ihn aufruft. Wenn die Anwendung geplante Aufgaben unterstützt, kann darin ein periodischer Bericht für ausgewählte Phrasen eingerichtet werden.

• Anonyme Telemetrie. Standardmäßig sendet der Server eine zufällige Installations-ID, den Namen des Ereignisses oder Werkzeugs, die Versionen von Server, Node.js, Betriebssystem und KI-Client. Darin landen weder API-Schlüssel, Werkzeugargumente, Ihre Nachrichten, Nachfragedaten noch Werte von Umgebungsvariablen. Deaktivieren Sie sie für MCP-Server von Ask Ads: ASKADS_TELEMETRY=0.

Technische Dokumentation

• Katalog der MCP-Fähigkeiten – Seiten zu Benutzeraufgaben für jedes Werkzeug.

• Alle Werkzeuge und Parameter

• Entwicklungsdokumentation

• Veröffentlichungsdokumentation

• Dokumentation der Yandex Cloud Search API

Support

Einen Fehler gefunden oder ein Szenario fehlt? Erstellen Sie ein Issue oder schreiben Sie an Telegram.