IndexMachine

IndexMachine MCP 服务

在你的 AI 助手中查看自己网站的 Google 收录情况并请求编入索引，还可使用 IndexNow。

此 MCP 服务可让 Claude Code、Cursor、VS Code、Claude Desktop 和 claude.ai 操作你连接到 IndexMachine 的网站：列出网站和页面、检查 URL 是否已被 Google 收录、排队请求点击“请求编入索引”（也可重新编入已收录的页面），并通知 Bing 和其他 IndexNow 搜索引擎。它使用你的密钥调用 IndexMachine API，不会执行 API 不支持的操作。

请求的实际流程

IndexMachine 使用你自己的 Google Search Console 中的“请求编入索引”功能和 IndexNow，不使用链接农场。因此，请求不会立即生效，服务每次都会说明这一点：

1. request_indexing 将点击请求加入队列。它本身不会向 Google 发送请求。
2. IndexMachine Chrome 扩展会在下次与服务通信时获取请求。扩展需在你的 Chrome 浏览器中运行，并登录拥有该资源的 Google 账号：1.2.0 及更新版本约每 5 分钟检查一次，旧版本每 30 分钟检查一次。Chrome 必须保持运行。如果扩展已有 40 分钟未检查，则无法预估完成时间，请求会留在队列中。
3. 扩展会在你的 Search Console 中点击请求编入索引，也就是你自己会点击的那个按钮。
4. Google 每个网站每天大约接受 10 次此类请求，每天在太平洋时间午夜重置。这个次数是观察所得；Google 并未公布。你加入队列的请求会优先于扩展为其他页面执行的日常工作，并共用这 10 次额度。网站当天的额度用完后，预计时间会延至太平洋时间午夜之后。
5. 随后由 Google 决定是否以及何时编入该页面，通常要过几天。预计时间仅针对点击操作，并不代表编入索引的时间；只有 check_url 能说明页面是否已被编入索引。

重新编入已被 Google 收录的页面（force: true）需要使用 1.2.0 或更新版本的扩展。IndexNow 会直接通知 Bing、Yandex 和其他 IndexNow 搜索引擎；需要先放置该网站的 IndexNow 密钥文件，每个网站每天最多提交 20 次，并且不会触达 Google。

你需要准备什么

• 一个已连接你的网站的 IndexMachine 账号：app.indexmachine.co。注册免费，并会显示哪些页面尚未被 Google 收录。请求编入索引需要为网站购买付费方案（价格）。
• 已安装并登录的 IndexMachine Chrome 扩展，用于执行“请求编入索引”点击操作。
• 一个 API 密钥（在 claude.ai 中，你可以将其作为请求标头添加，参见远程服务）。

创建 API 密钥

1. 打开 IndexMachine 控制面板，在个人资料菜单中选择设置，或直接访问 app.indexmachine.co/settings。
2. 在API 密钥下点击创建密钥，并为密钥设置标签，例如 Claude Code。
3. 选择完整权限（还可将请求加入队列、取消请求并提交到 IndexNow），或选择只读（网站、页面、检查和请求）。
4. 复制密钥。密钥以 im_live_ 开头，且只会显示一次。

你可以随时在同一页面轮换或撤销密钥；每个账号最多可拥有 10 个有效密钥。

安装

该软件包通过 npx 在你的计算机上运行（需要 Node.js 20 或更高版本）。请将密钥保存在用户级配置中，切勿放入仓库中的文件。

Claude Code（用户范围，因此密钥不会写入项目的 .mcp.json）

claude mcp add --scope user indexmachine --env INDEXMACHINE_API_KEY=im_live_... -- npx -y indexmachine-mcp

Cursor（~/.cursor/mcp.json，用户级文件）

{
  "mcpServers": {
    "indexmachine": {
      "command": "npx",
      "args": ["-y", "indexmachine-mcp"],
      "env": { "INDEXMACHINE_API_KEY": "im_live_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code 会提示你输入密钥，并确保密钥不会写入文件。

{
  "inputs": [
    { "type": "promptString", "id": "indexmachine-key", "description": "IndexMachine API key", "password": true }
  ],
  "servers": {
    "indexmachine": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "indexmachine-mcp"],
      "env": { "INDEXMACHINE_API_KEY": "${input:indexmachine-key}" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：使用与 Cursor 相同的代码块，放在 mcpServers 下。

其他 MCP 客户端：在环境中设置 INDEXMACHINE_API_KEY 后运行 npx -y indexmachine-mcp，或使用下方的远程服务。

远程服务

远程服务 https://mcp.indexmachine.co/mcp 无需安装。客户端在请求头中发送 API 密钥：

URL:    https://mcp.indexmachine.co/mcp
Header: Authorization: Bearer <your key>   (X-API-Key: <your key> works too)

Claude Code

claude mcp add --transport http indexmachine https://mcp.indexmachine.co/mcp \
  --header "Authorization: Bearer $INDEXMACHINE_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "indexmachine": {
      "url": "https://mcp.indexmachine.co/mcp",
      "headers": { "Authorization": "Bearer im_live_..." }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "inputs": [
    { "type": "promptString", "id": "indexmachine-key", "description": "IndexMachine API key", "password": true }
  ],
  "servers": {
    "indexmachine": {
      "type": "http",
      "url": "https://mcp.indexmachine.co/mcp",
      "headers": { "Authorization": "Bearer ${input:indexmachine-key}" }
    }
  }
}

claude.ai：自定义连接器

1. 在 claude.ai 中，打开 自定义 > 连接器，点击 + 添加，然后点击 添加自定义连接器。
2. 输入名称 IndexMachine 和 URL https://mcp.indexmachine.co/mcp。
3. 在 请求头下添加 Authorization，值为 Bearer im_live_...，然后点击 添加。
4. 在聊天中，打开 +，然后点击 连接器，并开启 IndexMachine。

IndexMachine 和 Submitator 连接器可以在同一聊天中同时开启：它们没有共用工具名称。

此服务内置了使用 IndexMachine 账户而非密钥登录的功能（OAuth），但在 IndexMachine 的 API 发放登录令牌之前，该功能会保持关闭。在此之前，服务不会提供登录选项，所有客户端都必须发送密钥。

远程服务不会在请求之间保留任何内容：它会将密钥传递给 IndexMachine API，然后将其遗忘。

工具

工具	功能
account_status	你的套餐、密钥权限和每小时额度、Chrome 扩展程序是否在线，以及今天各网站的请求次数与 Google 每日配额的对比
list_sites	你已连接的 Search Console 资源及其页面数量、是否启用了 Google 索引、付费套餐是否涵盖这些资源，以及 IndexNow 是否已就绪
site_summary	单个网站的今日 Request indexing 配额、从首次请求到建立索引的中位天数，以及 30 天的计数
list_pages	按状态（indexed、not_indexed、awaiting、requested、rejected、needs_fix、excluded、not_found）或 URL 的一部分列出网站页面；每次调用最多 50 个
check_url	检查 URL 是否已建立索引以及索引时间，或确认该 URL 尚不在记录中（从未检查过）；live: true 会立即向 Google 查询，每个网站每天会消耗 50 次实时检查额度中的 1 次
request_indexing	将一次 Request indexing 点击加入队列，也适用于尚非该网站页面的 URL；force: true 可重新为已建立索引的页面编入索引。返回队列位置和如实的预计等待时间
get_indexing_request、list_indexing_requests	跟踪请求：查看进行中的请求及其队列位置和预计等待时间，以及已关闭请求和 Search Console 的回复
cancel_indexing_request	将进行中的请求移出队列
submit_indexnow	通知 Bing、Yandex 和其他 IndexNow 搜索引擎单个网站最多 100 个 URL

提示词：index_url 会检查 URL，在其尚未建立索引时将请求加入队列，并报告当前预计等待时间。

密钥与安全

• request_indexing 会在排队前预览。如果要重新索引已被 Google 收录的页面、网站地图中没有的 URL，或这是你的网站当天最后一次请求，它会先征求你的同意；拒绝后不会排队。能够询问用户的客户端（MCP 引导）会自行显示问题，你的回答不会经过模型；如果没有收到回答，也不会排队。无法询问的客户端，以及远程服务上使用 2026-07-28 之前 MCP 协议的客户端，会先收到拒绝响应，其中包含原因和一个 confirm 令牌：该令牌由你的 API 密钥生成 HMAC，仅适用于该请求和当天，且不会改变你网站的配额。模型无法伪造令牌，因此调用总是会先收到拒绝响应。助手随后是否会在发回令牌前向你展示原因，取决于助手以及客户端对工具调用的批准设置；服务端无法看到这一过程。 submit_indexnow 在 URL 数量超过 10 个时也会执行相同操作，并提供一个仅适用于这些 URL 和太平洋时区当天的令牌。
• cancel_indexing_request 标记为具有破坏性（destructiveHint: true），其他工具均未标记：它会撤销请求。仅用于读取的工具标记为只读，因此客户端可以直接运行，无需征求同意。
• npx 包会从环境中读取密钥，并且只将密钥发送到 https://api.indexmachine.co。INDEXMACHINE_API_URL 可以将其指向本地开发服务器，但不能指向其他位置。
• 只读密钥适用于只进行检查的助手：检查网站、页面、URL 和请求。
• 每次调用都会携带一个以 mcp- 开头的请求 ID。你可以随时在 Settings 页面撤销密钥。
• 如需报告漏洞，请发送电子邮件至 [email protected]，不要在公开议题中报告 （SECURITY.md）。

开发

npm install
npm test               # unit, contract and protocol tests (it builds dist/ first)
npm run build
npm run sync:openapi   # refresh openapi/v1.json and src/v1.d.ts from https://api.indexmachine.co/v1/openapi.json
npm run check:pack     # pack, install in an empty folder, run the stdio handshake
npm run release:check  # what a release needs, then the publishing commands

openapi/v1.json 是 /v1 契约，API 也会在 /v1/openapi.json 提供同一文档。API 发布新版本时，运行 npm run sync:openapi 和 npm test，即可查看哪些新增操作需要添加工具或写入 EXCLUDED（src/tools/index.ts）。

远程服务通过 Vercel（vercel.json、api/）部署在域名 mcp.indexmachine.co 下。设置 MCP_OAUTH=1 和 MCP_OAUTH_KEYS 即可启用 OAuth；这些密钥用于加密 IndexMachine API 的访问令牌。

许可证

MIT