MCP دستاویزات

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 headerX-API-TOKEN: your_token_here
Authorization: Bearer headerAuthorization: Bearer your_token_here
?token= query parameter/_mcp?token=your_token_here

اپنا API ٹوکن سیٹنگز میں تلاش کریں۔ یہ 64 حروف کی ہیکس سٹرنگ ہے۔

OAuth فلو

OAuth سپورٹ کرنے والے کلائنٹس کے لیے، MCP اینڈ پوائنٹ Google OAuth فلو سے حاصل کردہ معیاری OAuth 2.0 بیئرر ٹوکنز بھی قبول کرتا ہے۔ صارف کی اجازت کے بعد واپس آنے والا ایکسیس ٹوکن صارف ریکارڈ پر محفوظ ہوتا ہے اور بیئرر ٹوکن کے طور پر استعمال کیا جا سکتا ہے۔

سیٹ اپ ہدایات

Claude.ai (Web)

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp?token=<YOUR_API_TOKEN>"
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp",
      "headers": {
        "X-API-TOKEN": "<YOUR_API_TOKEN>"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "better-search-console": {
      "url": "https://api.better-search-console.com/_mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

ریٹ لمٹس

درجہدرخواستیں/منٹدرخواستیں/دن
Free1050
Starter100200
Pro200500
MasterUnlimitedUnlimited

Tool Reference (50 tools)

list-websites

List all websites owned by the authenticated user.

کوئی پیرامیٹرز درکار نہیں۔

get-website

Get detailed information about a specific website.

پیرامیٹرز:

  • website_id
update-website

Update website settings (name, description, category, auto flags).

پیرامیٹرز:

  • website_id
  • name
  • description
  • category
  • auto_indexing
  • auto_sitemap_refresh
  • auto_update_status
list-urls

List URLs for a website with optional filters and pagination.

پیرامیٹرز:

  • website_id
  • coverage_state
  • url_contains
  • indexing_state
  • page
  • limit
delete-url

Delete a single URL from a website.

پیرامیٹرز:

  • url_id
delete-urls-bulk

Delete multiple URLs from a website in bulk.

پیرامیٹرز:

  • website_id
  • urls
get-url-stats

Get URL statistics grouped by coverage state.

پیرامیٹرز:

  • website_id
get-indexation-queue-status

Get the current indexation queue status for a website.

پیرامیٹرز:

  • website_id
list-sitemaps

List all sitemaps for a website.

پیرامیٹرز:

  • website_id
add-sitemap

Add a sitemap URL to a website (validates domain and reachability).

پیرامیٹرز:

  • website_id
  • sitemap_url
process-sitemap

Fetch and parse a sitemap, importing discovered URLs into the database.

پیرامیٹرز:

  • sitemap_id
process-all-sitemaps

Process all sitemaps for a website.

پیرامیٹرز:

  • website_id
delete-sitemap

Delete a sitemap and optionally its associated URLs.

پیرامیٹرز:

  • sitemap_id
queue-google

Queue a URL for Google indexation.

پیرامیٹرز:

  • url
queue-bing

Queue a URL for Bing indexation.

پیرامیٹرز:

  • url
queue-bulk

Queue multiple URLs for Google and/or Bing indexation.

پیرامیٹرز:

  • website_id
  • urls
  • google
  • bing
refresh-bing-crawl-info

Ask 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_id
  • limit
check-indexation

Queue a URL for indexation status check.

پیرامیٹرز:

  • url
check-indexation-bulk

Queue multiple URLs for indexation status check.

پیرامیٹرز:

  • website_id
  • urls
disable-indexation-bulk

Disable indexation for multiple URLs (sets mustBeIndexed to false).

پیرامیٹرز:

  • website_id
  • urls
reenable-indexation-bulk

Re-enable indexation for multiple URLs (sets mustBeIndexed to true).

پیرامیٹرز:

  • website_id
  • urls
update-coverage-state

Manually update the coverage state of a URL.

پیرامیٹرز:

  • url
  • state
plan-indexation

Rank 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_id
  • budget
get-search-analytics

Get Search Console analytics data with flexible dimensions.

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
  • dimensions
  • row_limit
get-top-queries

Get top search queries for a website.

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
  • limit
get-top-pages

Get top pages by search performance.

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
  • limit
get-device-breakdown

Get search performance breakdown by device type.

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
get-country-breakdown

Get search performance breakdown by country.

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
  • limit
compare-periods

Compare search analytics between two time periods with deltas.

پیرامیٹرز:

  • website_id
  • period1_start
  • period1_end
  • period2_start
  • period2_end
  • dimensions
list-prompt-analyses

List all prompt analyses for a website.

پیرامیٹرز:

  • website_id
create-prompt-analysis

Create a new prompt analysis entry.

پیرامیٹرز:

  • website_id
  • prompt
  • models
  • targeted_keywords
update-keywords

Update targeted keywords for a prompt analysis.

پیرامیٹرز:

  • analysis_id
  • targeted_keywords
get-prompt-analysis-results

Get detailed results and keyword statistics for a prompt analysis.

پیرامیٹرز:

  • analysis_id
create-dashboard

Create a custom dashboard (max 3 per website).

پیرامیٹرز:

  • website_id
  • name
  • is_default
update-dashboard

Update a custom dashboard name or default status.

پیرامیٹرز:

  • dashboard_id
  • name
  • is_default
delete-dashboard

Delete a custom dashboard and its widgets.

پیرامیٹرز:

  • dashboard_id
save-dashboard-widgets

Replace all widgets on a dashboard.

پیرامیٹرز:

  • dashboard_id
  • widgets
list-saved-filters

List saved URL filters for a website.

پیرامیٹرز:

  • website_id
create-saved-filter

Create a saved URL filter.

پیرامیٹرز:

  • website_id
  • name
  • search
  • sitemap
  • indexation
delete-saved-filter

Delete a saved filter.

پیرامیٹرز:

  • filter_id
generate-report

Generate a PDF report for a website (requires pro/master subscription).

پیرامیٹرز:

  • website_id
  • start_date
  • end_date
get-report-branding

Get report branding settings for a website.

پیرامیٹرز:

  • website_id
update-report-branding

Update report branding settings (company name, colors, footer).

پیرامیٹرز:

  • website_id
  • company_name
  • primary_color
  • accent_color
  • footer_text
analyze-meta-tags

Fetch a URL and extract SEO meta tags (title, description, OG, robots, h1s).

پیرامیٹرز:

  • url
analyze-keyword-density

Analyze keyword density in a text.

پیرامیٹرز:

  • text
  • keywords
check-url-structure

Check URL structure for SEO issues and return a score.

پیرامیٹرز:

  • url
analyze-readability

Analyze text readability using Flesch Reading Ease and Flesch-Kincaid grade.

پیرامیٹرز:

  • text
generate-sitemap

Crawl a website and generate a sitemap XML file.

پیرامیٹرز:

  • website_url
  • max_urls
generate-robots

Generate a robots.txt from a configuration of user agents and sitemaps.

پیرامیٹرز:

  • user_agents
  • sitemaps
get-profile

Get 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" }

انڈیکسنگ کے لیے URLs جمع کریں:

Tool: submit-urls-for-indexing
Arguments: { "website_id": 1, "url_ids": [10, 11, 12] }

مسائل حل کرنا

مسئلہحل
401 Unauthorizedچیک کریں کہ آپ کا API ٹوکن درست ہے اور درخواست میں شامل ہے۔
429 Too Many Requestsآپ نے اپنی ریٹ لمٹ سے تجاوز کر لیا ہے۔ انتظار کریں یا اپنا پلان اپ گریڈ کریں۔
ٹول نہیں ملاتصدیق کریں کہ ٹول کا نام اوپر دیے گئے حوالے سے بالکل مماثل ہے۔
کنکشن مستردیقینی بنائیں کہ ہوسٹ URL درست ہے اور آپ کے نیٹ ورک سے قابل رسائی ہے۔
غلط پیرامیٹرزچیک کریں کہ مطلوبہ پیرامیٹرز اسکیما سے مماثل ہوں۔ IDs نمبر ہونے چاہئیں۔