AI Rank Lab ツール、AIエージェントに組み込む

はじめに

エンドポイントと認証

POST https://www.airanklab.com/api/v1/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.

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

Claude Code

コマンド一つでサーバーをClaude Code (CLI v1.x 以降) に追加できます:

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 Overviewは、インドでモバイル版の「スタートアップ向けベストCRM」について誰を引用していますか？」 — it will call the SEO・AEO・GEO監査 and Google AI概要 tools for you.

Claude Desktop

Add this to your Claude Desktop configuration (設定 → 開発者 → 設定を編集, file claude_desktop_config.json), then restart the app:

{
  "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:

{
  "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.

実行時間の長いツール

レート制限

MCP requests count against the same per-key limit as the REST API: 1分あたり60リクエスト by default. A 429 response includes Retry-After. Need a higher limit? お問い合わせ.

関連リソース

• REST APIリファレンス — full endpoint documentation with request/response samples.
• OpenAPI仕様 (JSON) — machine-readable schema for codegen.
• Postmanコレクション — ready-made requests for every endpoint.
• APIプレイグラウンド — try every endpoint live from the dashboard.