Rapid Indexer

rapid-indexer-mcp

Model Context Protocol に対応した、Rapid Indexer 用サーバーです。Claude、Cursor、ChatGPT、Claude Code など、あらゆる MCP ホストから URL を Googlebot に送信し、ページがインデックス登録されているかを確認し、タスクの結果を読み取り、Rapid Indexer の API キーを使ってトラフィック／CTR キャンペーンを開始できます。

公式の TypeScript SDK v2（@modelcontextprotocol/server）を使用して構築されています。stdio（ローカル、1 アカウント）または Streamable HTTP（ホスト型、マルチテナント：リクエストごとに独自の API キーを付与）で動作します。

要件

• Node.js 20+
• Rapid Indexer の API キー：ログインし、アカウントメニュー → API Access（https://rapid-indexer.com/api_access）を開きます。

クイックスタート（stdio）

Cursor

Linux の ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）：

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "npx",
      "args": ["-y", "rapid-indexer-mcp"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Linux の ~/.config/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "npx",
      "args": ["-y", "rapid-indexer-mcp"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add rapid-indexer -e RAPID_INDEXER_API_KEY=YOUR_API_KEY -- npx -y rapid-indexer-mcp

ローカルのチェックアウトから実行する場合（npm への公開前）

cd mcp
npm install
npm run build

次に、ホストがビルド済み CLI を参照するように設定します：

{
  "mcpServers": {
    "rapid-indexer": {
      "command": "node",
      "args": ["/absolute/path/to/Rapid-Indexer-main/mcp/dist/cli.js"],
      "env": { "RAPID_INDEXER_API_KEY": "YOUR_API_KEY" }
    }
  }
}

ホスト型モード（Streamable HTTP）

1 つのプロセスですべての顧客にサービスを提供します。API キーは各リクエストに付与されます。

RAPID_INDEXER_BASE_URL=https://rapid-indexer.com \
node dist/cli.js --http --host 0.0.0.0 --port 3333 --path /mcp

クライアントは https://your-host/mcp に接続し、Authorization: Bearer <api key> を送信します（X-API-Key: <key>、または URL の ?api_key= も使用できます）。GET /healthz は稼働状態を示す JSON を返します。

リモートサーバー用の Cursor の例：

{
  "mcpServers": {
    "rapid-indexer": {
      "url": "https://mcp.rapid-indexer.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

TLS（nginx/Caddy）の背後に配置し、systemd または pm2 で実行してください。サーバーはステートレスなので、複数のレプリカを実行できます。HTTP モードの --api-key／RAPID_INDEXER_API_KEY は、キーを持たないリクエストに対するフォールバックとしてのみ使用されます（単一テナントのセルフホスト）。

ツール

ツール	クレジットを消費	機能
get_account	いいえ	アカウント ID、メールアドレス、クレジット残高（＋米ドル）。
get_pricing	いいえ	URL あたりの最新クレジット数（standard／VIP／checker）、訪問者 1,000 人あたりのトラフィック料金、クレジットあたりの米ドル額。
estimate_cost	いいえ	N 件の URL を indexer/checker（＋VIP）として処理する費用と、残高で足りるかどうか。
submit_urls_for_indexing	はい	インデックス登録タスクを作成します（standard または VIP キュー、オプションで drip feed）。最大 10,000 件の URL。
check_index_status	はい（約 0.1 クレジット／URL）	インデックス確認タスクを作成し、URL ごとにインデックス登録済み／未登録を確認します。
list_tasks	いいえ	インデックス登録済み／未登録／保留中／エラーの件数を含むページ分割されたタスクリスト。種類／ステータスで絞り込めます。
get_task	いいえ	1 件のタスクのステータスと進捗を更新して返します。
get_task_links	いいえ	ステータスで絞り込める、ページ分割された URL ごとの結果。
create_traffic_campaign	はい	URL への AI 訪問者（地域、デバイス、リファラー、行動）。
create_ctr_campaign	はい	訪問者が Google/Bing/… でキーワードを検索し、検索結果をクリックします。
list_search_engines	いいえ	CTR キャンペーンで有効な search_engine の値。
check_service_health	いいえ	API バージョン、有効な機能、キーが有効であることの確認。

すべてのツールは、人間が読み取れるテキストに加え、出力スキーマで検証された structuredContent を返します。API エラーは、API のメッセージとヒント（クレジット不足時のチャージリンク、401 時のキーの場所）を含む isError 結果として返されます。

プロンプト：index_and_verify — 見積もり → 送信 → 検証のガイド付きワークフロー。

環境変数／フラグ

変数	フラグ	デフォルト	備考
RAPID_INDEXER_API_KEY	--api-key	–	stdio では必須です。HTTP モードではフォールバックとしてのみ使用されます。
RAPID_INDEXER_BASE_URL	--base-url	https://rapid-indexer.com/api/v1/index.php	サイトのオリジンも指定できます。その場合、ルーターのパスが追加されます。
HOST	--host	127.0.0.1	HTTP モード。
PORT	--port	3333	HTTP モード。
MCP_PATH	--path	/mcp	HTTP モード。

開発

npm install
npm run build          # tsc → dist/
npm run dev            # run src/cli.ts with tsx (stdio)
npm run inspect        # MCP Inspector against dist/cli.js

IPv6 に問題のあるマシンで npm install がハングする場合は、次の設定を指定して実行してください。 NODE_OPTIONS="--no-network-family-autoselection --dns-result-order=ipv4first"。

公開

npm version patch
npm publish --access public

prepublishOnly は dist/ をビルドします。パッケージには dist/、README.md、LICENSE のみが含まれます。

API の対応範囲

このサーバーは、https://rapid-indexer.com/api-docs に記載されている公開 REST API と通信します。list_tasks と pricing は、このサーバーとともに API に追加されました。サイトの旧ビルドを実行しているホストでは、API が再デプロイされるまで、これら 2 つのツールは「Invalid action」エラーになります。

ライセンス

MIT