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.
Server MCP tersedia di:
https://api.better-search-console.com/_mcpTiga metode didukung (dalam urutan prioritas):
| Metode | Contoh |
|---|---|
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 |
Temukan token API Anda di Pengaturan. Token berupa string hex 64 karakter.
Untuk klien yang mendukung OAuth, endpoint MCP juga menerima token Bearer OAuth 2.0 standar yang diperoleh melalui alur Google OAuth. Token akses yang dikembalikan setelah pengguna mengotorisasi disimpan di catatan pengguna dan dapat digunakan sebagai 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>"
}
}
}
}| Tingkat | Permintaan/menit | Permintaan/hari |
|---|---|---|
| Free | 10 | 50 |
| Starter | 100 | 200 |
| Pro | 200 | 500 |
| Master | Unlimited | Unlimited |
List all websites owned by the authenticated user.
Tidak ada parameter yang diperlukan.
Get detailed information about a specific website.
Parameter:
website_idUpdate website settings (name, description, category, auto flags).
Parameter:
website_idnamedescriptioncategoryauto_indexingauto_sitemap_refreshauto_update_statusList URLs for a website with optional filters and pagination.
Parameter:
website_idcoverage_stateurl_containsindexing_statepagelimitDelete a single URL from a website.
Parameter:
url_idDelete multiple URLs from a website in bulk.
Parameter:
website_idurlsGet URL statistics grouped by coverage state.
Parameter:
website_idGet the current indexation queue status for a website.
Parameter:
website_idList all sitemaps for a website.
Parameter:
website_idAdd a sitemap URL to a website (validates domain and reachability).
Parameter:
website_idsitemap_urlFetch and parse a sitemap, importing discovered URLs into the database.
Parameter:
sitemap_idProcess all sitemaps for a website.
Parameter:
website_idDelete a sitemap and optionally its associated URLs.
Parameter:
sitemap_idQueue a URL for Google indexation.
Parameter:
urlQueue a URL for Bing indexation.
Parameter:
urlQueue multiple URLs for Google and/or Bing indexation.
Parameter:
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.
Parameter:
website_idlimitQueue a URL for indexation status check.
Parameter:
urlQueue multiple URLs for indexation status check.
Parameter:
website_idurlsDisable indexation for multiple URLs (sets mustBeIndexed to false).
Parameter:
website_idurlsRe-enable indexation for multiple URLs (sets mustBeIndexed to true).
Parameter:
website_idurlsManually update the coverage state of a URL.
Parameter:
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.
Parameter:
website_idbudgetGet Search Console analytics data with flexible dimensions.
Parameter:
website_idstart_dateend_datedimensionsrow_limitGet top search queries for a website.
Parameter:
website_idstart_dateend_datelimitGet top pages by search performance.
Parameter:
website_idstart_dateend_datelimitGet search performance breakdown by device type.
Parameter:
website_idstart_dateend_dateGet search performance breakdown by country.
Parameter:
website_idstart_dateend_datelimitCompare search analytics between two time periods with deltas.
Parameter:
website_idperiod1_startperiod1_endperiod2_startperiod2_enddimensionsList all prompt analyses for a website.
Parameter:
website_idCreate a new prompt analysis entry.
Parameter:
website_idpromptmodelstargeted_keywordsUpdate targeted keywords for a prompt analysis.
Parameter:
analysis_idtargeted_keywordsGet detailed results and keyword statistics for a prompt analysis.
Parameter:
analysis_idCreate a custom dashboard (max 3 per website).
Parameter:
website_idnameis_defaultUpdate a custom dashboard name or default status.
Parameter:
dashboard_idnameis_defaultDelete a custom dashboard and its widgets.
Parameter:
dashboard_idReplace all widgets on a dashboard.
Parameter:
dashboard_idwidgetsList saved URL filters for a website.
Parameter:
website_idCreate a saved URL filter.
Parameter:
website_idnamesearchsitemapindexationDelete a saved filter.
Parameter:
filter_idGenerate a PDF report for a website (requires pro/master subscription).
Parameter:
website_idstart_dateend_dateGet report branding settings for a website.
Parameter:
website_idUpdate report branding settings (company name, colors, footer).
Parameter:
website_idcompany_nameprimary_coloraccent_colorfooter_textFetch a URL and extract SEO meta tags (title, description, OG, robots, h1s).
Parameter:
urlAnalyze keyword density in a text.
Parameter:
textkeywordsCheck URL structure for SEO issues and return a score.
Parameter:
urlAnalyze text readability using Flesch Reading Ease and Flesch-Kincaid grade.
Parameter:
textCrawl a website and generate a sitemap XML file.
Parameter:
website_urlmax_urlsGenerate a robots.txt from a configuration of user agents and sitemaps.
Parameter:
user_agentssitemapsGet the authenticated user profile and subscription info.
Tidak ada parameter yang diperlukan.
Daftarkan situs web Anda:
Tool: list-websites
Arguments: {}Periksa indeksasi untuk URL:
Tool: check-url-indexation
Arguments: { "website_id": 1, "url": "https://example.com/page" }Kirim URL untuk indeksasi:
Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }| Masalah | Solusi |
|---|---|
| 401 Unauthorized | Periksa token API Anda sudah benar dan disertakan dalam permintaan. |
| 429 Too Many Requests | Anda telah melampaui batas laju. Tunggu atau tingkatkan paket Anda. |
| Alat tidak ditemukan | Pastikan nama alat cocok persis dengan referensi di atas. |
| Koneksi ditolak | Pastikan URL host sudah benar dan dapat diakses dari jaringan Anda. |
| Parameter tidak valid | Periksa parameter wajib sesuai skema. ID harus berupa angka. |