MCP Server

AI Rank Lab 工具，在你的 AI 代理中

AI Rank Lab MCP 服务器提供与开发者 API 相同的工具 — 完整的 SEO + AEO + GEO 检测器、实时 Google 搜索、适用于任何国家和设备的 AI 概览和 AI 模式查询、关键词研究、核心网页指标、AI 品牌可见性检查、FAQ 和 llms.txt 生成，以及你的 Google Analytics 4、 Search Console、机器人访问和引用数据 — 通过 Model Context Protocol。将其添加到 Claude Code、Claude Desktop 或 Cursor，你的代理即可直接运行它们。

Get your API key REST API 参考

简介

The 模型上下文协议 (MCP) is an open standard that lets AI assistants call external tools. Our MCP server is a thin layer over the /api/v1 REST API: same tools, same credit billing, same account — but callable by Claude, Cursor, or any other MCP-compatible client as part of a conversation.

The server uses the 可流式传输的 HTTP transport in stateless mode, so there is nothing to install or host — you point your client at the endpoint with your API credentials.

端点与认证

服务器位于单个端点：

POST https://www.airanklab.com/api/v1/mcp

Every request must carry the same two headers as the REST API: x-api-key and x-api-secret. Generate both from 控制面板 → API 与集成.

你的 MCP 客户端配置将密钥以纯文本形式存储在你的机器上。请将配置文件排除在版本控制之外，如果密钥对泄露，请从控制面板轮换。

Claude.ai (Web 应用)

To connect the MCP server directly in the Claude.ai web interface, open the 添加自定义连接器 dialog. Claude.ai does not support custom headers, so your credentials go in the URL query string instead.

Paste the following URL into the 远程 MCP 服务器 URL field, replacing the placeholders with your actual API key and secret. Leave the Advanced OAuth fields blank.

Remote MCP server URL

https://www.airanklab.com/api/v1/mcp?x-api-key=YOUR_API_KEY&x-api-secret=YOUR_API_SECRET

由于 Claude.ai 不支持自定义请求头，你必须在 URL 查询参数中包含你的凭据。请注意，这可能导致它们出现在我们的服务器访问日志中。

Use the URL exactly as shown — the www. host and no /sse suffix. Claude.ai connects over Streamable HTTP and posts to the exact URL you paste; a different host or path returns an error, and Claude then falls back to an OAuth sign-in flow that this server does not offer.

Claude Code

一个命令即可将服务器添加到 Claude Code（CLI v1.x 或更高版本）：

Terminal

claude mcp add --transport http airanklab https://www.airanklab.com/api/v1/mcp \
  --header "x-api-key: YOUR_API_KEY" \
  --header "x-api-secret: YOUR_API_SECRET"

Then ask Claude Code things like “对 example.com 运行 SEO + AEO + GEO 检查并总结关键问题” or “Google 的 AI 概览在印度移动端上，针对‘最适合初创公司的 CRM’引用了谁？” — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.

Claude 桌面版

Add this to your Claude Desktop configuration (设置 → 开发者 → 编辑配置, file claude_desktop_config.json), then restart the app:

claude_desktop_config.json

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

Cursor

Add the same block to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

mcp.json

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

可用工具与定价

MCP 工具与 REST 工具端点一对一映射，并消耗相同的积分余额 — 无论您是从仪表板、REST API 还是 MCP 调用工具，其成本都是相同的。数据读取免费；失败的工具调用会自动退款。

The three Google tools (google-search, google-ai-overview, google-ai-mode) take a country and a device— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick desktop or mobile. Results differ markedly between the two, so measure the one your buyers actually use. The search-locations tool lists every supported market. The GA4 and Search Console tools are free because they read your own Google data — connect those accounts in the dashboard first.

ai-citation-check asks ChatGPT, Perplexity, Claude and Gemini the same question in one call and reports which of them cite you — it is billed per engine, so naming fewer engines costs less. The backlink tools (backlinks-overview, backlinks-history, backlinks-list, 引荐域, 锚文本, 批量域名权威度) work on 任意domain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free 外链筛选器 tool lists the presets, modes and fields the filtered backlink queries accept.

工具	描述	每次调用积分
`ai-citation-check`	Ask ChatGPT, Perplexity, Claude and Gemini one question and see who cites you	100 per engine
`backlinks-list`	Every individual backlink, with anchors, authority and spam signals	150
`seo-aeo-geo-audit`	Full SEO + AEO + GEO checker — the same three-pillar report as the dashboard	50
`audits`	Technical + AEO audit of a single URL	50
`google-search`	Live Google SERP for one query, by country and device	100
`google-ai-overview`	Google's AI Overview answer and the sources it cites	100
`google-ai-mode`	Google's AI Mode conversational answer and its sources	100
`brand-visibility`	Ask a live AI engine about a brand	100 per engine
`keyword-research`	Keyword volume, difficulty, intent and live SERP	50 typical; billed per lookup
`core-web-vitals`	Core Web Vitals / PageSpeed scan	25
`referring-domains`	Domains linking to any site, ranked by authority	25
`anchor-text`	Anchor text distribution and over-optimization signals	25
`bulk-domain-authority`	Authority rank for up to 100 domains in one call	25
`faq-generator`	Generate an FAQ plus FAQPage schema for a page	20
`llms-txt`	Generate an llms.txt manifest	20
`backlinks-overview`	Backlink profile summary for any domain: rank, referring domains, spam score	15
`backlinks-history`	Month-by-month backlink trend with new and lost links	15
`backlink-filters`	Filter presets, modes and fields the backlink tools accept	Free
`gsc-performance`	Search Console clicks, impressions, CTR and position	Free
`gsc-sites`	Your verified Search Console properties	Free
`ga4-report`	Any GA4 metrics and dimensions over your property	Free
`ga4-realtime`	GA4 activity in the last 30 minutes	Free
`ga4-properties`	Your connected GA4 properties	Free
`tracking-stats`	AI bot visit stats for your domain	Free
`citations`	Where AI engines cite your site	Free
`search-locations`	Countries, languages and devices the search tools accept	Free
`keyword-research-estimate`	Preview a keyword-research cost before running it	Free
`credits`	Current credit balance	Free

长时间运行工具

Heavier tools (audits, brand visibility) normally finish within the request. Each call has a 120秒预算: if the work isn't done in time, the tool returns a jobId with polling instructions instead of the result.

Poll GET /api/v1/jobs/{jobId} (REST, same headers) until the status is 已完成 — see 异步任务 in the API reference.

速率限制

MCP requests count against the same per-key limit as the REST API: 每分钟60次请求 by default. A 429 response includes Retry-After. Need a higher limit? 联系我们.

连接您的代理

生成您的 API 密钥和密匙，粘贴一段配置代码，您的 AI 代理即可运行真正的营销工具。

Get your API key