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, 봇 방문 및 인용 데이터까지 모델 컨텍스트 프로토콜을 통해 제공됩니다. 이를 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 (웹 앱)

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 “모바일에서 인도의 ‘스타트업을 위한 최고의 CRM’에 대해 Google의 AI Overview가 인용한 출처는 어디인가요?” — it will call the SEO-AEO-GEO 감사 and Google AI 개요 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 검색, Google AI 개요, Google AI 모드) 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 검색 위치 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 인용 확인 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 (백링크 개요, 백링크 기록, 백링크 목록, 연결 도메인, 앵커 텍스트, 대량 도메인 권한) 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 작업 ID 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