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.
MCP 服务器地址：
https://api.better-search-console.com/_mcp支持以下三种方法（按优先级排列）：
| 方法 | 示例 |
|---|---|
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 |
在设置中找到您的 API 令牌，它是一个 64 位十六进制字符串。
对于支持 OAuth 的客户端，MCP 端点也接受通过 Google OAuth 流程获取的标准 OAuth 2.0 Bearer 令牌。用户授权后返回的访问令牌存储在用户记录中，可用作 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>"
}
}
}
}| 等级 | 请求次数/分钟 | 请求次数/天 |
|---|---|---|
| Free | 10 | 50 |
| Starter | 100 | 200 |
| Pro | 200 | 500 |
| Master | Unlimited | Unlimited |
List all websites owned by the authenticated user.
无需参数。
Get detailed information about a specific website.
参数：
website_idUpdate website settings (name, description, category, auto flags).
参数：
website_idnamedescriptioncategoryauto_indexingauto_sitemap_refreshauto_update_statusList URLs for a website with optional filters and pagination.
参数：
website_idcoverage_stateurl_containsindexing_statepagelimitDelete a single URL from a website.
参数：
url_idDelete multiple URLs from a website in bulk.
参数：
website_idurlsGet URL statistics grouped by coverage state.
参数：
website_idGet the current indexation queue status for a website.
参数：
website_idList all sitemaps for a website.
参数：
website_idAdd a sitemap URL to a website (validates domain and reachability).
参数：
website_idsitemap_urlFetch and parse a sitemap, importing discovered URLs into the database.
参数：
sitemap_idProcess all sitemaps for a website.
参数：
website_idDelete a sitemap and optionally its associated URLs.
参数：
sitemap_idQueue a URL for Google indexation.
参数：
urlQueue a URL for Bing indexation.
参数：
urlQueue multiple URLs for Google and/or Bing indexation.
参数：
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.
参数：
website_idlimitQueue a URL for indexation status check.
参数：
urlQueue multiple URLs for indexation status check.
参数：
website_idurlsDisable indexation for multiple URLs (sets mustBeIndexed to false).
参数：
website_idurlsRe-enable indexation for multiple URLs (sets mustBeIndexed to true).
参数：
website_idurlsManually update the coverage state of a URL.
参数：
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.
参数：
website_idbudgetGet Search Console analytics data with flexible dimensions.
参数：
website_idstart_dateend_datedimensionsrow_limitGet top search queries for a website.
参数：
website_idstart_dateend_datelimitGet top pages by search performance.
参数：
website_idstart_dateend_datelimitGet search performance breakdown by device type.
参数：
website_idstart_dateend_dateGet search performance breakdown by country.
参数：
website_idstart_dateend_datelimitCompare search analytics between two time periods with deltas.
参数：
website_idperiod1_startperiod1_endperiod2_startperiod2_enddimensionsList all prompt analyses for a website.
参数：
website_idCreate a new prompt analysis entry.
参数：
website_idpromptmodelstargeted_keywordsUpdate targeted keywords for a prompt analysis.
参数：
analysis_idtargeted_keywordsGet detailed results and keyword statistics for a prompt analysis.
参数：
analysis_idCreate a custom dashboard (max 3 per website).
参数：
website_idnameis_defaultUpdate a custom dashboard name or default status.
参数：
dashboard_idnameis_defaultDelete a custom dashboard and its widgets.
参数：
dashboard_idReplace all widgets on a dashboard.
参数：
dashboard_idwidgetsList saved URL filters for a website.
参数：
website_idCreate a saved URL filter.
参数：
website_idnamesearchsitemapindexationDelete a saved filter.
参数：
filter_idGenerate a PDF report for a website (requires pro/master subscription).
参数：
website_idstart_dateend_dateGet report branding settings for a website.
参数：
website_idUpdate report branding settings (company name, colors, footer).
参数：
website_idcompany_nameprimary_coloraccent_colorfooter_textFetch a URL and extract SEO meta tags (title, description, OG, robots, h1s).
参数：
urlAnalyze keyword density in a text.
参数：
textkeywordsCheck URL structure for SEO issues and return a score.
参数：
urlAnalyze text readability using Flesch Reading Ease and Flesch-Kincaid grade.
参数：
textCrawl a website and generate a sitemap XML file.
参数：
website_urlmax_urlsGenerate a robots.txt from a configuration of user agents and sitemaps.
参数：
user_agentssitemapsGet the authenticated user profile and subscription info.
无需参数。
列出您的网站：
Tool: list-websites
Arguments: {}检查 URL 的索引状态：
Tool: check-url-indexation
Arguments: { "website_id": 1, "url": "https://example.com/page" }提交 URL 进行索引：
Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }| 问题 | 解决方案 |
|---|---|
| 401 Unauthorized | 检查您的 API 令牌是否正确并包含在请求中。 |
| 429 Too Many Requests | 您已超出速率限制。请等待或升级您的计划。 |
| 未找到工具 | 请确认工具名称与上方参考完全一致。 |
| 连接被拒绝 | 确保主机 URL 正确且可从您的网络访问。 |
| 参数无效 | 检查必填参数是否匹配架构。ID 必须为数字。 |