Rapid Indexer

rapid-indexer-mcp

面向 Rapid Indexer 的 Model Context Protocol 服务。它允许 Claude、Cursor、ChatGPT、Claude Code 和任何其他 MCP 主机使用你的 Rapid Indexer API 密钥向 Googlebot 提交 URL、检查页面是否已编入索引、读取任务结果，以及发起流量 / CTR 活动。

基于官方 TypeScript SDK v2（@modelcontextprotocol/server）构建。支持通过 stdio（本地，单个账户）或 Streamable HTTP（托管，多租户：每个请求都携带自己的 API 密钥）提供服务。

要求

• Node.js 20+
• Rapid Indexer API 密钥：登录后打开账户菜单 → API Access（https://rapid-indexer.com/api_access）。

快速开始（stdio）

Cursor

~/.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）

一个进程为所有客户提供服务；每个请求都会携带 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、电子邮件、额度余额（+ USD）。
get_pricing	否	每个 URL 的实时额度价格（standard / VIP / checker）、每 1,000 名访客的流量价格、每额度的 USD 价格。
estimate_cost	否	估算 N 个 URL 作为索引器 / 检查器（+VIP）的成本，以及余额是否足以支付。
submit_urls_for_indexing	是	创建索引任务（standard 或 VIP 队列，可选分批投放）。最多 10,000 个 URL。
check_index_status	是（约 0.1 额度 / URL）	创建索引检查任务：逐个 URL 检查是否已编入索引。
list_tasks	否	分页任务列表，包含已编入索引 / 未编入索引 / 待处理 / 错误数量；可按类型 / 状态筛选。
get_task	否	刷新并返回单个任务的状态和进度。
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 错误会以 isError 结果返回，其中包含 API 错误消息和提示（额度不足时提供充值链接，401 时指出密钥位置）。

提示词：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 中的；运行旧版网站的主机上，这两个工具会因“Invalid action”而失败，直到重新部署该 API。

许可证

MIT