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.
Le serveur MCP est disponible à :
https://api.better-search-console.com/_mcpTrois méthodes sont prises en charge (par ordre de priorité) :
| Méthode | Exemple |
|---|---|
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 |
Trouvez votre jeton API dans les paramètres. C'est une chaîne hexadécimale de 64 caractères.
Pour les clients prenant en charge OAuth, le point d'accès MCP accepte aussi les jetons Bearer OAuth 2.0 standard obtenus via le flux OAuth Google. Le jeton d'accès renvoyé après autorisation de l'utilisateur est stocké sur l'enregistrement utilisateur et peut être utilisé comme jeton 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>"
}
}
}
}| Niveau | Requêtes/min | Requêtes/jour |
|---|---|---|
| Free | 10 | 50 |
| Starter | 100 | 200 |
| Pro | 200 | 500 |
| Master | Unlimited | Unlimited |
List all websites owned by the authenticated user.
Aucun paramètre requis.
Get detailed information about a specific website.
Paramètres :
website_idUpdate website settings (name, description, category, auto flags).
Paramètres :
website_idnamedescriptioncategoryauto_indexingauto_sitemap_refreshauto_update_statusList URLs for a website with optional filters and pagination.
Paramètres :
website_idcoverage_stateurl_containsindexing_statepagelimitDelete a single URL from a website.
Paramètres :
url_idDelete multiple URLs from a website in bulk.
Paramètres :
website_idurlsGet URL statistics grouped by coverage state.
Paramètres :
website_idGet the current indexation queue status for a website.
Paramètres :
website_idList all sitemaps for a website.
Paramètres :
website_idAdd a sitemap URL to a website (validates domain and reachability).
Paramètres :
website_idsitemap_urlFetch and parse a sitemap, importing discovered URLs into the database.
Paramètres :
sitemap_idProcess all sitemaps for a website.
Paramètres :
website_idDelete a sitemap and optionally its associated URLs.
Paramètres :
sitemap_idQueue a URL for Google indexation.
Paramètres :
urlQueue a URL for Bing indexation.
Paramètres :
urlQueue multiple URLs for Google and/or Bing indexation.
Paramètres :
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.
Paramètres :
website_idlimitQueue a URL for indexation status check.
Paramètres :
urlQueue multiple URLs for indexation status check.
Paramètres :
website_idurlsDisable indexation for multiple URLs (sets mustBeIndexed to false).
Paramètres :
website_idurlsRe-enable indexation for multiple URLs (sets mustBeIndexed to true).
Paramètres :
website_idurlsManually update the coverage state of a URL.
Paramètres :
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.
Paramètres :
website_idbudgetGet Search Console analytics data with flexible dimensions.
Paramètres :
website_idstart_dateend_datedimensionsrow_limitGet top search queries for a website.
Paramètres :
website_idstart_dateend_datelimitGet top pages by search performance.
Paramètres :
website_idstart_dateend_datelimitGet search performance breakdown by device type.
Paramètres :
website_idstart_dateend_dateGet search performance breakdown by country.
Paramètres :
website_idstart_dateend_datelimitCompare search analytics between two time periods with deltas.
Paramètres :
website_idperiod1_startperiod1_endperiod2_startperiod2_enddimensionsList all prompt analyses for a website.
Paramètres :
website_idCreate a new prompt analysis entry.
Paramètres :
website_idpromptmodelstargeted_keywordsUpdate targeted keywords for a prompt analysis.
Paramètres :
analysis_idtargeted_keywordsGet detailed results and keyword statistics for a prompt analysis.
Paramètres :
analysis_idCreate a custom dashboard (max 3 per website).
Paramètres :
website_idnameis_defaultUpdate a custom dashboard name or default status.
Paramètres :
dashboard_idnameis_defaultDelete a custom dashboard and its widgets.
Paramètres :
dashboard_idReplace all widgets on a dashboard.
Paramètres :
dashboard_idwidgetsList saved URL filters for a website.
Paramètres :
website_idCreate a saved URL filter.
Paramètres :
website_idnamesearchsitemapindexationDelete a saved filter.
Paramètres :
filter_idGenerate a PDF report for a website (requires pro/master subscription).
Paramètres :
website_idstart_dateend_dateGet report branding settings for a website.
Paramètres :
website_idUpdate report branding settings (company name, colors, footer).
Paramètres :
website_idcompany_nameprimary_coloraccent_colorfooter_textFetch a URL and extract SEO meta tags (title, description, OG, robots, h1s).
Paramètres :
urlAnalyze keyword density in a text.
Paramètres :
textkeywordsCheck URL structure for SEO issues and return a score.
Paramètres :
urlAnalyze text readability using Flesch Reading Ease and Flesch-Kincaid grade.
Paramètres :
textCrawl a website and generate a sitemap XML file.
Paramètres :
website_urlmax_urlsGenerate a robots.txt from a configuration of user agents and sitemaps.
Paramètres :
user_agentssitemapsGet the authenticated user profile and subscription info.
Aucun paramètre requis.
Lister vos sites web :
Tool: list-websites
Arguments: {}Vérifier l'indexation d'une URL :
Tool: check-url-indexation
Arguments: { "website_id": 1, "url": "https://example.com/page" }Soumettre des URL pour l'indexation :
Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }| Problème | Solution |
|---|---|
| 401 Unauthorized | Vérifiez que votre jeton API est correct et inclus dans la requête. |
| 429 Too Many Requests | Vous avez dépassé votre limite de débit. Patientez ou mettez à niveau votre forfait. |
| Outil introuvable | Vérifiez que le nom de l'outil correspond exactement à la référence ci-dessus. |
| Connexion refusée | Vérifiez que l'URL de l'hôte est correcte et accessible depuis votre réseau. |
| Paramètres invalides | Vérifiez que les paramètres requis correspondent au schéma. Les ID doivent être des nombres. |