ComposioHQ/google-search-console-automation

Google Search Console Automatisierung über Rube MCP

Suchanalysen abfragen, URLs prüfen, Sitemaps verwalten und die Suchperformance überwachen – alles über Rube MCP (Composio) und die Google Search Console.

Toolkit-Dokumentation: composio.dev/toolkits/google_search_console

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_search_console
• Nachweis der Seiteninhaberschaft oder entsprechende Berechtigungen in der Google Search Console
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemas zu erhalten

Einrichtung

Rube MCP beziehen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu, und es funktioniert.

1. Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit dem Toolkit google_search_console auf
3. Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie, dass der Verbindungsstatus AKTIV anzeigt, bevor Sie Workflows ausführen

Kern-Workflows

1. Alle verifizierten Websites auflisten

Verwenden Sie GOOGLE_SEARCH_CONSOLE_LIST_SITES, um alle Websites abzurufen, die der authentifizierte Benutzer besitzt oder auf die er Zugriff hat.

Tool: GOOGLE_SEARCH_CONSOLE_LIST_SITES
Parameter: (keine erforderlich)
Rückgabe: Liste der Seiteneinträge mit siteUrl und permissionLevel

2. Suchanalysen abfragen

Verwenden Sie GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY, um Daten zur Suchperformance abzurufen, einschließlich Klicks, Impressionen, CTR und Position.

Tool: GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY
Parameter:
  - site_url (erforderlich): Seiten-URL (z. B. "https://www.example.com/" oder "sc-domain:example.com")
  - start_date (erforderlich): Startdatum im Format YYYY-MM-DD
  - end_date (erforderlich): Enddatum im Format YYYY-MM-DD
  - dimensions: Gruppieren nach ["query", "page", "country", "device", "date", "searchAppearance"]
  - search_type: "web" (Standard), "image", "video", "news", "discover", "googleNews"
  - dimension_filter_groups: Filter für Dimensionen (Operatoren: equals, notEquals, contains, notContains, includingRegex, excludingRegex)
  - row_limit: Maximale Zeilen (1-25000, Standard 1000)
  - start_row: Paginierungs-Offset (Standard 0)
  - aggregation_type: "auto", "byPage", "byProperty", "byNewsShowcasePanel"
  - data_state: "final" (Standard), "all", "hourly_all"

3. Eine URL prüfen

Verwenden Sie GOOGLE_SEARCH_CONSOLE_INSPECT_URL, um den Indexierungsstatus und Probleme für eine bestimmte URL zu überprüfen.

Tool: GOOGLE_SEARCH_CONSOLE_INSPECT_URL
Parameter:
  - inspection_url (erforderlich): Vollständige URL zur Prüfung (z. B. "https://www.example.com/seite")
  - site_url (erforderlich): Eigenschafts-URL (z. B. "https://www.example.com/")
  - language_code: BCP-47-Sprache (Standard: "en-US")

4. Sitemaps auflisten

Verwenden Sie GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS, um alle für eine Website eingereichten Sitemaps abzurufen.

Tool: GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS
Parameter:
  - site_url (erforderlich): Seiten-URL (z. B. "https://www.example.com/")
  - sitemap_index: Bestimmte Sitemap-Index-URL, um Sitemaps daraus aufzulisten

5. Eine Sitemap einreichen

Verwenden Sie GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP, um eine Sitemap zur Indexierung zu registrieren oder erneut einzureichen.

Tool: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP
Parameter:
  - site_url (erforderlich): Seiten-URL oder Domain-Eigenschaft (z. B. "sc-domain:example.com")
  - feedpath (erforderlich): Vollständige Sitemap-URL (z. B. "https://www.example.com/sitemap.xml")

6. Sitemap-Details abrufen

Verwenden Sie GOOGLE_SEARCH_CONSOLE_GET_SITEMAP, um Informationen zu einer bestimmten eingereichten Sitemap abzurufen.

Tool: GOOGLE_SEARCH_CONSOLE_GET_SITEMAP
Parameter:
  - site_url (erforderlich): Seiten-URL
  - feedpath (erforderlich): Sitemap-URL, für die Details abgerufen werden sollen

Häufige Muster

• Performance-Überwachung: Verwenden Sie GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY mit dimensions: ["date"] über einen Datumsbereich, um tägliche Trends der Suchperformance zu verfolgen.
• Top-Abfragen-Bericht: Verwenden Sie GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY mit dimensions: ["query"], um die am häufigsten geklickten Suchbegriffe zu finden.
• Seitenebenen-Analyse: Verwenden Sie dimensions: ["page"], um die leistungsstärksten Seiten zu identifizieren, dann dimensions: ["query", "page"], um zu sehen, welche Abfragen Traffic auf jede Seite lenken.
• Indexierungs-Audit: Verwenden Sie GOOGLE_SEARCH_CONSOLE_INSPECT_URL, um den Indexierungsstatus wichtiger Seiten zu überprüfen.
• Sitemap-Verwaltung: Verwenden Sie GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS, um eingereichte Sitemaps zu überprüfen, und dann GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP, um neue oder aktualisierte einzureichen.
• Länder-/Geräte-Aufschlüsselung: Verwenden Sie dimensions: ["country", "device"], um die geografische und gerätebezogene Verteilung des Suchverkehrs zu verstehen.
• Filtern nach bestimmten Abfragen: Verwenden Sie dimension_filter_groups mit den Operatoren contains oder includingRegex, um sich auf bestimmte Keyword-Gruppen zu konzentrieren.

Bekannte Fallstricke

• Das Format der Seiten-URL ist wichtig: URL-Präfix-Eigenschaften verwenden die vollständige URL mit Protokoll und abschließendem Schrägstrich (z. B. https://www.example.com/). Domain-Eigenschaften verwenden das Präfix sc-domain: (z. B. sc-domain:example.com). Die Verwendung des falschen Formats führt zu leeren Ergebnissen oder Fehlern.
• Datumsbereichsgrenzen: Daten sind in der Regel mit einer Verzögerung von 2-3 Tagen verfügbar. data_state: "all" enthält neuere Daten, die sich noch ändern können. hourly_all funktioniert nur für Daten innerhalb der letzten 3 Tage.
• Paginierung des Zeilenlimits: Die API gibt die besten Ergebnisse sortiert nach Klicks (oder nach Datum, wenn nach Datum gruppiert wird) zurück. Für vollständige Daten paginieren Sie mit start_row in Kombination mit row_limit.
• Maximal 25.000 Zeilen pro Anfrage: Selbst mit Paginierung gibt jede Anfrage höchstens 25.000 Zeilen zurück. Bei sehr großen Datensätzen verengen Sie den Datumsbereich oder fügen Dimensionsfilter hinzu.
• Die zu prüfende URL muss zur Website gehören: Die inspection_url muss eine Seite unter der site_url-Eigenschaft sein. Überprüfungen über verschiedene Eigenschaften hinweg schlagen fehl.
• Sitemap muss erreichbar sein: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP erfordert, dass die Sitemap-Datei unter der angegebenen URL öffentlich zugänglich und korrekt als XML formatiert ist.
• Ergebnisse nach Klicks sortiert: Standardmäßig werden Analyseergebnisse absteigend nach Klickzahl sortiert, außer bei Gruppierung nach date (dann aufsteigend nach Datum sortiert).

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Websites auflisten	GOOGLE_SEARCH_CONSOLE_LIST_SITES	(keine)
Suchanalysen	GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY	site_url, start_date, end_date, dimensions
URL prüfen	GOOGLE_SEARCH_CONSOLE_INSPECT_URL	inspection_url, site_url
Sitemaps auflisten	GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS	site_url
Sitemap einreichen	GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP	site_url, feedpath
Sitemap-Info abrufen	GOOGLE_SEARCH_CONSOLE_GET_SITEMAP	site_url, feedpath

---

Bereitgestellt durch Composio