Skip to main content
Glama

SEO GSC Wizard MCP

Sitemap URL performance

get_sitemap_performance
Read-only

Fetches a sitemap belonging to the property, extracts its URLs, and joins them with Search Console page performance over a date range. Each URL gets its clicks, impressions, CTR, and average position (zeros if the page has no GSC data). Reports how many sitemap URLs actually received impressions (indexedInGscCount). The warehouse reads the sitemap URLs themselves, so a zero is exact. The live API cannot, so it pages through the property's pages (top 100,000 by clicks at most) until every URL is found; truncated: true means some URLs were not reached, so their zeros are unknown rather than "no impressions" (scanLimit is the rows read). Expands one level of a sitemap index (up to 5 child sitemaps; a child that cannot be read is named in childSitemapNote instead of failing the call), caps extracted URLs at maxUrls (default 500, max 2000), and only fetches http(s) URLs on the property host or a subdomain of it. Served from the ClickHouse warehouse when available, otherwise the live Search Console API (see dataSource). The sitemap is fetched with the user agent "GSCWizard-Bot/1.0 (On-Page SEO Checker)"; if the server blocks it (403/401/429) or no URLs come back, relay the whitelisting advice in the error or crawlNote. Date range is optional: omit startDate/endDate to analyze the last 28 settled days (data lags ~2-3 days).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
endDateNoOptional. Window end as YYYY-MM-DD (e.g. 2026-05-31). You do NOT need to know today's date or the latest available date: omit this and the server uses the latest settled Search Console date (data lags ~2-3 days behind today). Never pass null or the string "null".
maxUrlsNo
siteUrlYes
startDateNoOptional. Window start as YYYY-MM-DD (e.g. 2026-05-03). You do NOT need to know today's date. Omit BOTH startDate and endDate to analyze the last 28 settled days automatically (Search Console data lags ~2-3 days). Never pass null or the string "null".
searchTypeNoweb
sitemapUrlYes

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
noteNo
urlsNo
rangeNo
siteUrlNo
urlCountNo
crawlNoteNo
scanLimitNo
truncatedNo
dataSourceNo
sitemapUrlNo
sitemapNoteNo
dataMaturityNo
settledThroughNo
truncationNoteNo
childSitemapNoteNo
indexedInGscCountNo
failedChildSitemapsNo
warehouseLatestDateNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / childSitemapNote
      Added value: +{
      +  "$ref": "#/properties/siteUrl"
      +}
    • addedOutput schema / properties / failedChildSitemaps
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "$ref": "#/properties/siteUrl"
      +          },
      +          "sitemapUrl": {
      +            "$ref": "#/properties/siteUrl"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / properties / warehouseLatestDate
      Added value: +{
      +  "$ref": "#/properties/siteUrl"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources