Zum Inhalt

MCP

Google Search Console MCPTool-Dokumentation

8 Tool Calls, ihre Eingaben und die Grenzen dieser Verbindung. Stand der Implementierung: 8. Oktober 2026.

Die vollständige Tool-Referenz.

6 Lese-Tools und 2 Schreib-Tools. Öffne ein Tool für Parameter und vollständiges JSON Schema. Unbekannte Felder werden abgelehnt.

list_sitesFreigegebene Properties auflisten
Lesen

Liefert nur die für diese Verbindung ausgewählten Search-Console-Properties und ihre Google-Berechtigungen.

Eingabeparameter

Keine Parameter. Übergib ein leeres Objekt: {}.

Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_siteProperty lesen
Lesen

Liest die Berechtigungsstufe einer ausgewählten Property.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    }
  },
  "required": [
    "site_url"
  ],
  "additionalProperties": false
}
query_search_analyticsSuchleistung abfragen
Lesen

Liest Klicks, Impressionen, CTR und Position. Maximal 93 Tage aggregiert, 31 Tage mit Seite oder Suchanfrage, 7 Tage und 5.000 Zeilen mit beiden. Filter zählen mit. Datumsangaben beziehen sich auf Pacific Time; Dimensionen müssen eindeutig sein. Top-Zeilen, kein vollständiger Export. Weitere Seiten über start_row.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
start_datePflichtfeld
string · date
end_datePflichtfeld
string · date
dimensionsOptional
array · Max. Einträge: 7 · Einträge: string (country | device | page | query | searchAppearance | date | hour)
typeOptional
string · web | image | video | news | discover | googleNews
data_stateOptional
string · final | all | hourly_all
aggregation_typeOptional
string · auto | byPage | byProperty | byNewsShowcasePanel
row_limitOptional
integer · Standard: 1000 · min. 1 · max. 25000
start_rowOptional
integer · Standard: 0 · min. 0 · max. 50000
dimension_filter_groupsOptional
array · Max. Einträge: 10 · Einträge: object
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "dimensions": {
      "maxItems": 7,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "country",
          "device",
          "page",
          "query",
          "searchAppearance",
          "date",
          "hour"
        ]
      }
    },
    "type": {
      "type": "string",
      "enum": [
        "web",
        "image",
        "video",
        "news",
        "discover",
        "googleNews"
      ]
    },
    "data_state": {
      "type": "string",
      "enum": [
        "final",
        "all",
        "hourly_all"
      ]
    },
    "aggregation_type": {
      "type": "string",
      "enum": [
        "auto",
        "byPage",
        "byProperty",
        "byNewsShowcasePanel"
      ]
    },
    "row_limit": {
      "default": 1000,
      "type": "integer",
      "minimum": 1,
      "maximum": 25000
    },
    "start_row": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 50000
    },
    "dimension_filter_groups": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "groupType": {
            "type": "string",
            "const": "and"
          },
          "filters": {
            "minItems": 1,
            "maxItems": 30,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "dimension": {
                  "type": "string",
                  "enum": [
                    "country",
                    "device",
                    "page",
                    "query",
                    "searchAppearance"
                  ]
                },
                "operator": {
                  "type": "string",
                  "enum": [
                    "contains",
                    "equals",
                    "notContains",
                    "notEquals",
                    "includingRegex",
                    "excludingRegex"
                  ]
                },
                "expression": {
                  "type": "string",
                  "maxLength": 4096
                }
              },
              "required": [
                "dimension",
                "expression"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "groupType",
          "filters"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "site_url",
    "start_date",
    "end_date"
  ],
  "additionalProperties": false
}
inspect_urlIndexstatus einer URL prüfen
Lesen

Liest den gespeicherten URL-Prüfbericht von Google. Kein Live-Crawl und keine Anforderung einer Indexierung.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
inspection_urlPflichtfeld
string · Max. Zeichen: 4096
language_codeOptional
string · Max. Zeichen: 35
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "inspection_url": {
      "type": "string",
      "maxLength": 4096
    },
    "language_code": {
      "type": "string",
      "maxLength": 35,
      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$"
    }
  },
  "required": [
    "site_url",
    "inspection_url"
  ],
  "additionalProperties": false
}
list_sitemapsSitemaps auflisten
Lesen

Liest die eingereichten Sitemaps einer ausgewählten Property; optional auf einen Sitemap-Index begrenzt.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
sitemap_indexOptional
string · Max. Zeichen: 4096
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "sitemap_index": {
      "type": "string",
      "maxLength": 4096
    }
  },
  "required": [
    "site_url"
  ],
  "additionalProperties": false
}
get_sitemapSitemap lesen
Lesen

Liest Status und Informationen einer eingereichten Sitemap.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
sitemap_urlPflichtfeld
string · Max. Zeichen: 4096
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "sitemap_url": {
      "type": "string",
      "maxLength": 4096,
      "description": "Sitemap URL within the selected property."
    }
  },
  "required": [
    "site_url",
    "sitemap_url"
  ],
  "additionalProperties": false
}
submit_sitemapSitemap einreichen
Ändern

Reicht eine Sitemap-URL innerhalb der ausgewählten Property bei Google ein. Erfordert einen ausdrücklichen Änderungsauftrag; garantiert keine Indexierung.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
sitemap_urlPflichtfeld
string · Max. Zeichen: 4096
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "sitemap_url": {
      "type": "string",
      "maxLength": 4096,
      "description": "Sitemap URL within the selected property."
    }
  },
  "required": [
    "site_url",
    "sitemap_url"
  ],
  "additionalProperties": false
}
delete_sitemapSitemap-Einreichung entfernen
Ändern

Entfernt die Sitemap-Einreichung aus Search Console. Die XML-Datei und die Website bleiben bestehen. Erfordert einen ausdrücklichen Löschauftrag.

Ändert bestehende Konfiguration oder den Kampagnenstatus. Ein ausdrücklicher Nutzerauftrag ist erforderlich.

Eingabeparameter

site_urlPflichtfeld
string · Max. Zeichen: 2048
sitemap_urlPflichtfeld
string · Max. Zeichen: 4096
Vollständiges Eingabeschema (JSON)
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "site_url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Exact selected Search Console property, e.g. sc-domain:example.com or https://example.com/."
    },
    "sitemap_url": {
      "type": "string",
      "maxLength": 4096,
      "description": "Sitemap URL within the selected property."
    }
  },
  "required": [
    "site_url",
    "sitemap_url"
  ],
  "additionalProperties": false
}

Ein konkreter Tool Call.

JSON-RPC-Aufruf nach der MCP-Initialisierung. Beispiel-IDs und Datumswerte: Ersetze sie durch deine ausgewählte Ressource und deinen Berichtszeitraum. Der KI-Client übernimmt Transport und Autorisierung.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "query_search_analytics",
    "arguments": {
      "site_url": "sc-domain:example.com",
      "start_date": "2026-09-01",
      "end_date": "2026-09-07",
      "dimensions": [
        "query"
      ],
      "row_limit": 100
    }
  }
}

So kommen Ergebnisse zurück.

structuredContent
Enthält das Tool-Ergebnis als JSON-Objekt. Google-Feldnamen bleiben erhalten. Dasselbe JSON wird zusätzlich als Textblock in content zurückgegeben.
Daten je Tool
Suchleistung liefert bei verfügbaren Daten rows mit keys, clicks, impressions, ctr und position. URL-Prüfung liefert inspectionResult. Property-Listen verwenden siteEntry. Sitemap-Einreichung/Entfernung liefert status: submitted oder removed.
isError: true
Tool-Fehler liefern structuredContent.error und request_id, optional retry_after_seconds. Beispiele: scope_missing bei fehlendem Zugriff oder service_unavailable bei einem nicht erreichbaren Dienst. Einen unsicheren Schreibauftrag nicht blind wiederholen.

Zugriff und technische Grenzen.

Suchleistung: höchstens 93 Tage aggregiert, 31 Tage mit page oder query, 7 Tage und 5.000 Zeilen mit beiden. Auch Filterdimensionen zählen; Dimensionen müssen eindeutig sein. Standardlimit 1.000, maximal 25.000 Zeilen bei anderen Abfragen; weitere Zeilen über start_row. Google liefert Top-Zeilen, keinen vollständigen Export. Datumsangaben gelten in Pacific Time. URL-Prüfung liest gespeicherten Indexstatus; kein Live-Crawl und keine Indexierungsanfrage. Schreib-Tools verwenden hier keine operation_id.

Die Verbindung verwendet MCP Streamable HTTP mit Bearer-Autorisierung. Der Server prüft Lese-/Schreibrechte und die ausgewählte Ressource bei jedem Call. Sowohl deine Google-Berechtigungen als auch die Zugriffsrechte deiner MCP-Verbindung müssen die Aktion erlauben. Clients entdecken Tools über tools/list; diese Seiten dokumentieren das Tool-Verzeichnis.

Lese-Scope: mcp:gsc:read. Schreib-Scope: mcp:gsc:write.

Sitemap-Änderungen benötigen einen ausdrücklichen Nutzerauftrag. Schreibzugriffe werden nicht automatisch wiederholt.

Zurück zum MCP-ServerInstallation