MCP Server

Инструменты AI Rank Lab, внутри вашего ИИ-агента

MCP-сервер AI Rank Lab предоставляет те же инструменты, что и API для разработчиков — полноценный чекер SEO + AEO + GEO, живой поиск Google, поиск AI Overview и AI Mode для любой страны и устройства, исследование ключевых слов, Core Web Vitals, проверки видимости бренда с помощью ИИ, генерация FAQ и llms.txt, а также данные из Google Analytics 4, Search Console, данные о посещениях ботами и цитировании — через Model Context Protocol. Добавьте его в Claude Code, Claude Desktop или Cursor, и ваш агент сможет запускать их напрямую.

Введение

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 (Веб-приложение)

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 URL удаленного MCP-сервера 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 «выполните проверку SEO + AEO + GEO на example.com и кратко изложите критические проблемы» or «кого Google AI Overview цитирует по запросу «лучшая CRM для стартапов» в Индии на мобильных устройствах?» — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.

Claude Desktop

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 Страна and a Устройство— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick Десктоп or Мобильный. 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-checkAsk ChatGPT, Perplexity, Claude and Gemini one question and see who cites you100 per engine
backlinks-listEvery individual backlink, with anchors, authority and spam signals150
seo-aeo-geo-auditFull SEO + AEO + GEO checker — the same three-pillar report as the dashboard50
auditsTechnical + AEO audit of a single URL50
google-searchLive Google SERP for one query, by country and device100
google-ai-overviewGoogle's AI Overview answer and the sources it cites100
google-ai-modeGoogle's AI Mode conversational answer and its sources100
brand-visibilityAsk a live AI engine about a brand100 per engine
keyword-researchKeyword volume, difficulty, intent and live SERP50 typical; billed per lookup
core-web-vitalsCore Web Vitals / PageSpeed scan25
referring-domainsDomains linking to any site, ranked by authority25
anchor-textAnchor text distribution and over-optimization signals25
bulk-domain-authorityAuthority rank for up to 100 domains in one call25
faq-generatorGenerate an FAQ plus FAQPage schema for a page20
llms-txtGenerate an llms.txt manifest20
backlinks-overviewBacklink profile summary for any domain: rank, referring domains, spam score15
backlinks-historyMonth-by-month backlink trend with new and lost links15
backlink-filtersFilter presets, modes and fields the backlink tools acceptFree
gsc-performanceSearch Console clicks, impressions, CTR and positionFree
gsc-sitesYour verified Search Console propertiesFree
ga4-reportAny GA4 metrics and dimensions over your propertyFree
ga4-realtimeGA4 activity in the last 30 minutesFree
ga4-propertiesYour connected GA4 propertiesFree
tracking-statsAI bot visit stats for your domainFree
citationsWhere AI engines cite your siteFree
search-locationsCountries, languages and devices the search tools acceptFree
keyword-research-estimatePreview a keyword-research cost before running itFree
creditsCurrent credit balanceFree

Долго выполняющиеся инструменты

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, вставьте один блок конфигурации, и ваш ИИ-агент сможет запускать настоящие маркетинговые инструменты.

Get your API key