Run a coverage analysis of a Search Console property
seo_indexation.coverage.run
Runs a new coverage analysis of a Search Console property connected to the organization and saves it: it reads the property's sitemaps and the pages with Search impressions in the last 90 days (up to 5,000) from Google, downloads the sitemaps themselves from the site (sitemap indexes followed, .xml, .xml.gz or .txt; up to 25 sitemaps and 50,000 URLs; only the property's own site) and crosses both lists. Returns the analysis: coverage_score (0–100; starts at 100 and loses up to 30 points for the share of orphan pages and up to 30 for the share of dead pages), total_sitemap_urls, sitemap_urls_read, total_pages_with_impressions, orphan_pages (pages with impressions that no sitemap lists, most impressions first, up to 100; orphan_count is the total) and dead_pages (URLs a sitemap lists with no impressions in 90 days, up to 100; dead_count is the total). estimated is true when a sitemap could not be read (sitemap_read_errors says which and why), a cap cut the list, or Search Analytics hit its 5,000 pages; when no sitemap could be read, method is folder_prefix: a page counts as listed when it starts with a sitemap's folder and there are no dead pages. One analysis per property every 5 minutes. To read the last one without spending Google quota, use seo_indexation.coverage.latest. Errors: 409 integration_not_connected (Search Console is not connected at all), 404 external_account_not_linked (connected, but that property is not assigned to the organization; Google is not called), 429 cooldown_active (with retry_after), 409 integration_not_connected, 409 integration_reconnect_required, 429 external_rate_limited, 503 external_unavailable. Requires edit access to Indexation.
- Escopo
seo_indexation:write- Permissão
- Editar no módulo
- Tool do MCP
seo_indexation_coverage_runNa superfície completa; na compacta,mb_execute_operationcomid: "seo_indexation.coverage.run".- Eventos que pode emitir
- seo_indexation.coverage.completed
Custo declarado: até 5 leituras e 1 escritas por chamada (contam na cota diária). Usa uma plataforma externa (google): conta na cota de operações externas.
Parâmetros
site_urlstringcorpoThe Search Console property, as seo_indexation.properties.list returns it: a URL-prefix property (https://www.example.com/) or a domain property (sc-domain:example.com). It must be connected to the organization in Data Sources; a trailing slash or the host's letter case may differ.
Resposta
idstringsite_urlstringcreated_atnumbercreated_by_idstringcoverage_scorenumber0–100: starts at 100 and loses up to 30 points for the share of orphan pages and up to 30 for the share of dead pages. Read it with estimated.
total_sitemap_urlsnumberURLs submitted across the property's sitemaps, as Search Console counts them.
total_indexed_urlsnumberIndexed URLs as the sitemaps report them (deprecated by Google: usually 0).
total_pages_with_impressionsnumberPages with Search impressions in the last 90 days (up to 5,000).
orphan_pagesarray<object>Pages with impressions that no sitemap lists, most impressions first (up to 100; orphan_count is the total).
dead_pagesarray<object>URLs a sitemap lists with no impressions in 90 days (up to 100; dead_count is the total).
sitemap_errorsarray<object>Reserved: always empty (the sitemaps that could not be read are in sitemap_read_errors).
methodenumsitemap_urls: compared with the URLs read from the sitemaps themselves. folder_prefix: no sitemap could be read, so a page counts as listed when it starts with a sitemap's folder and there are no dead pages. Missing in analyses saved before 2026-10-14 (they were all folder_prefix: their dead pages were never found).
Valores: sitemap_urls, folder_prefix
sitemap_urls_readnumberURLs read from the sitemaps (sitemap indexes followed; up to 25 sitemaps and 50,000 URLs).
orphan_countnumberTotal orphan pages.
dead_countnumberTotal dead pages.
estimatedbooleantrue when the result is an estimate: a sitemap could not be read, a cap cut the list, or Search Analytics hit its 5,000 pages (a listed URL without a row may still have impressions).
sitemap_read_errorsarray<object>The sitemaps that could not be read, with the reason (up to 20).
Erros
Exemplo
curl -X POST "https://api.mb-suite.com/v1/seo/indexation/coverage/run" \
-H "Authorization: Bearer $MB_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"site_url": "SITE_URL"
}'Testar com a sua API key de teste
Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar. Na prática esta operação não é simulada (usa outra plataforma): responde 409 sandbox_external_unavailable.