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/_mcp3つの認証方法がサポートされています（優先順）：
| メソッド | 例 |
|---|---|
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文字の16進数文字列です。
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は数値である必要があります。 |