The Model Context Protocol (MCP) allows AI assistants like Claude, GPT, and Cursor to interact directly with your Better Search Console data. Your assistant can list websites, check indexation status, analyze prompts, manage sitemaps, and much more — all through a standardized tool-calling interface.
El servidor MCP está disponible en:
https://api.better-search-console.com/_mcpSe admiten tres métodos (en orden de prioridad):
| Método | Ejemplo |
|---|---|
X-API-TOKEN header | X-API-TOKEN: your_token_here |
Authorization: Bearer header | Authorization: Bearer your_token_here |
?token= query parameter | /_mcp?token=your_token_here |
Encuentre su token de API en Ajustes. Es una cadena hexadecimal de 64 caracteres.
Para clientes que admiten OAuth, el endpoint MCP también acepta tokens Bearer estándar de OAuth 2.0 obtenidos mediante el flujo OAuth de Google. El token de acceso devuelto tras la autorización del usuario se almacena en el registro del usuario y puede usarse como token Bearer.
{
"mcpServers": {
"better-search-console": {
"url": "https://api.better-search-console.com/_mcp?token=<YOUR_API_TOKEN>"
}
}
}{
"mcpServers": {
"better-search-console": {
"url": "https://api.better-search-console.com/_mcp",
"headers": {
"X-API-TOKEN": "<YOUR_API_TOKEN>"
}
}
}
}{
"mcpServers": {
"better-search-console": {
"url": "https://api.better-search-console.com/_mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_TOKEN>"
}
}
}
}| Nivel | Solicitudes/min | Solicitudes/día |
|---|---|---|
| Free | 10 | 50 |
| Starter | 100 | 200 |
| Pro | 200 | 500 |
| Master | Unlimited | Unlimited |
List all websites owned by the authenticated user.
No se requieren parámetros.
Get detailed information about a specific website.
Parámetros:
website_idUpdate website settings (name, description, category, auto flags).
Parámetros:
website_idnamedescriptioncategoryauto_indexingauto_sitemap_refreshauto_update_statusList URLs for a website with optional filters and pagination.
Parámetros:
website_idcoverage_stateurl_containsindexing_statepagelimitDelete a single URL from a website.
Parámetros:
url_idDelete multiple URLs from a website in bulk.
Parámetros:
website_idurlsGet URL statistics grouped by coverage state.
Parámetros:
website_idGet the current indexation queue status for a website.
Parámetros:
website_idList all sitemaps for a website.
Parámetros:
website_idAdd a sitemap URL to a website (validates domain and reachability).
Parámetros:
website_idsitemap_urlFetch and parse a sitemap, importing discovered URLs into the database.
Parámetros:
sitemap_idProcess all sitemaps for a website.
Parámetros:
website_idDelete a sitemap and optionally its associated URLs.
Parámetros:
sitemap_idQueue a URL for Google indexation.
Parámetros:
urlQueue a URL for Bing indexation.
Parámetros:
urlQueue multiple URLs for Google and/or Bing indexation.
Parámetros:
website_idurlsgooglebingAsk Bing what its crawler knows about a website's URLs (discovery date, last crawl, document size) and store it. This is not the same as bing_status, which reports whether a URL appears in Bing search results. Paced at about one URL per second and skips readings taken in the last week.
Parámetros:
website_idlimitQueue a URL for indexation status check.
Parámetros:
urlQueue multiple URLs for indexation status check.
Parámetros:
website_idurlsDisable indexation for multiple URLs (sets mustBeIndexed to false).
Parámetros:
website_idurlsRe-enable indexation for multiple URLs (sets mustBeIndexed to true).
Parámetros:
website_idurlsManually update the coverage state of a URL.
Parámetros:
urlstateRank URLs by how much a Google indexation request would help, and report which ones cannot be helped and why. Read-only: it spends no quota and queues nothing. Use it to decide what to submit before calling queue-google or queue-bulk.
Parámetros:
website_idbudgetGet Search Console analytics data with flexible dimensions.
Parámetros:
website_idstart_dateend_datedimensionsrow_limitGet top search queries for a website.
Parámetros:
website_idstart_dateend_datelimitGet top pages by search performance.
Parámetros:
website_idstart_dateend_datelimitGet search performance breakdown by device type.
Parámetros:
website_idstart_dateend_dateGet search performance breakdown by country.
Parámetros:
website_idstart_dateend_datelimitCompare search analytics between two time periods with deltas.
Parámetros:
website_idperiod1_startperiod1_endperiod2_startperiod2_enddimensionsList all prompt analyses for a website.
Parámetros:
website_idCreate a new prompt analysis entry.
Parámetros:
website_idpromptmodelstargeted_keywordsUpdate targeted keywords for a prompt analysis.
Parámetros:
analysis_idtargeted_keywordsGet detailed results and keyword statistics for a prompt analysis.
Parámetros:
analysis_idCreate a custom dashboard (max 3 per website).
Parámetros:
website_idnameis_defaultUpdate a custom dashboard name or default status.
Parámetros:
dashboard_idnameis_defaultDelete a custom dashboard and its widgets.
Parámetros:
dashboard_idReplace all widgets on a dashboard.
Parámetros:
dashboard_idwidgetsList saved URL filters for a website.
Parámetros:
website_idCreate a saved URL filter.
Parámetros:
website_idnamesearchsitemapindexationDelete a saved filter.
Parámetros:
filter_idGenerate a PDF report for a website (requires pro/master subscription).
Parámetros:
website_idstart_dateend_dateGet report branding settings for a website.
Parámetros:
website_idUpdate report branding settings (company name, colors, footer).
Parámetros:
website_idcompany_nameprimary_coloraccent_colorfooter_textFetch a URL and extract SEO meta tags (title, description, OG, robots, h1s).
Parámetros:
urlAnalyze keyword density in a text.
Parámetros:
textkeywordsCheck URL structure for SEO issues and return a score.
Parámetros:
urlAnalyze text readability using Flesch Reading Ease and Flesch-Kincaid grade.
Parámetros:
textCrawl a website and generate a sitemap XML file.
Parámetros:
website_urlmax_urlsGenerate a robots.txt from a configuration of user agents and sitemaps.
Parámetros:
user_agentssitemapsGet the authenticated user profile and subscription info.
No se requieren parámetros.
Listar sus sitios web:
Tool: list-websites
Arguments: {}Verificar indexación de una URL:
Tool: check-url-indexation
Arguments: { "website_id": 1, "url": "https://example.com/page" }Enviar URLs para indexación:
Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }| Problema | Solución |
|---|---|
| 401 Unauthorized | Verifique que su token de API sea correcto y esté incluido en la solicitud. |
| 429 Too Many Requests | Ha excedido su límite de uso. Espere o mejore su plan. |
| Herramienta no encontrada | Verifique que el nombre de la herramienta coincida exactamente con la referencia anterior. |
| Conexión rechazada | Asegúrese de que la URL del host sea correcta y accesible desde su red. |
| Parámetros inválidos | Verifique que los parámetros coincidan con el esquema. Los IDs deben ser números. |