Sitemaps · Indexación · Referencia de la API

GET/v1/seo/indexation/sitemaps

List the sitemaps of a Search Console property

seo_indexation.sitemaps.list

LecturaIdempotenteDesde 2026-11-01

Lists the sitemaps submitted to a Search Console property connected to the organization (site_url from seo_indexation.properties.list), live from Google: for each one its path (the sitemap URL), last_submitted and last_downloaded (ISO dates), is_pending (Google has not processed it yet), warnings, errors and contents (type, submitted URLs; indexed is deprecated by Google and usually 0). Not paginated. Errors: 404 external_account_not_linked (that site_url is not connected to this organization; Google is not called), 409 integration_not_connected (no Search Console connection: connect it in Integrations), 409 integration_reconnect_required (details.reason: expired, the connection expired or was revoked; missing_permission, it lacks a permission; access_lost, the connected Google account lost access to the property), 429 external_rate_limited, 503 external_unavailable. Spends Google quota. Requires view access to Indexation.

Alcance: seo_indexation:read
Permiso: Ver el módulo
Tool del MCP: seo_indexation_sitemaps_listEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_indexation.sitemaps.list".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (google): cuenta en el cupo de operaciones externas.

Parámetros

site_urlstringqueryrequerido

The 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.

Respuesta

site_urlstring

dataarray<object>

has_morefalse

Always false: every sitemap of the property comes in one answer.

Errores

integration_not_connected integration_reconnect_required external_rejected external_unavailable external_rate_limited external_outcome_unknown external_global_limit sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo/indexation/sitemaps?site_url=SITE_URL" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

POST/v1/seo/indexation/sitemaps

Submit a sitemap to a Search Console property

seo_indexation.sitemaps.submit

EscrituraDesde 2026-11-01

Submits (or resubmits) a sitemap to a Search Console property connected to the organization: site_url from seo_indexation.properties.list and feedpath, the full http(s) URL of the sitemap file (e.g. https://www.example.com/sitemap.xml). Google fetches and processes it afterwards; its status shows later in seo_indexation.sitemaps.list (is_pending, errors, warnings). Submitting one that is already there asks Google to read it again. Changes the property in Google Search Console, not in MB Suite. Errors: 404 external_account_not_linked (Google is not called), 409 external_rejected (Google rejected the sitemap: it must be reachable, be valid XML and live inside the property), 409 integration_not_connected, 409 integration_reconnect_required, 429 external_rate_limited, 503 external_unavailable. Spends Google quota. Requires edit access to Indexation.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance: seo_indexation:write
Permiso: Editar en el módulo
Tool del MCP: seo_indexation_sitemaps_submitEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_indexation.sitemaps.submit".
Eventos que puede emitir: seo_indexation.sitemap.submitted

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (google): cuenta en el cupo de operaciones externas.

Parámetros

site_urlstringcuerporequerido

The 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.

feedpathstringcuerporequerido

The full URL of the sitemap file, e.g. https://www.example.com/sitemap.xml (the path of a sitemap in seo_indexation.sitemaps.list).

Respuesta

oktrue

site_urlstring

pathstring

Errores

confirmation_required integration_not_connected integration_reconnect_required external_rejected external_unavailable external_rate_limited external_outcome_unknown external_global_limit sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo/indexation/sitemaps" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "site_url": "SITE_URL",
  "feedpath": "FEEDPATH",
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.

DELETE/v1/seo/indexation/sitemaps

Remove a sitemap from a Search Console property

seo_indexation.sitemaps.delete

IrreversibleDesde 2026-11-01

Removes a submitted sitemap from a Search Console property connected to the organization: site_url and feedpath (the sitemap's path in seo_indexation.sitemaps.list; over REST both go in the JSON body of the DELETE, since they are URLs). Google stops reading that sitemap; the file on the site is untouched and it can be submitted again with seo_indexation.sitemaps.submit. Nothing goes to MB Suite's trash (the sitemap lives in Google). Outside the screen it always requires a dry run first (dry_run: true reads the property's sitemaps and describes the one to remove, 404 sitemap_not_found if it is not submitted) and then the same body with its confirm_token. Errors: 404 external_account_not_linked, 404 sitemap_not_found, 409 external_rejected, 409 integration_not_connected, 409 integration_reconnect_required, 429 external_rate_limited, 503 external_unavailable. Spends Google quota. Requires edit access to Indexation and, for a credential, deletion enabled.

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance: seo_indexation:write y «Permitir eliminar» (seo_indexation:delete en OAuth)
Permiso: Editar en el módulo
Tool del MCP: seo_indexation_sitemaps_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_indexation.sitemaps.delete".
Eventos que puede emitir: seo_indexation.sitemap.deleted

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (google): cuenta en el cupo de operaciones externas.

Parámetros

site_urlstringcuerporequerido

The 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.

feedpathstringcuerporequerido

The full URL of the sitemap file, e.g. https://www.example.com/sitemap.xml (the path of a sitemap in seo_indexation.sitemaps.list).

Respuesta

oktrue

site_urlstring

pathstring

Errores

delete_not_allowed confirmation_required integration_not_connected integration_reconnect_required external_rejected external_unavailable external_rate_limited external_outcome_unknown external_global_limit sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/seo/indexation/sitemaps" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "site_url": "SITE_URL",
  "feedpath": "FEEDPATH",
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.