RevorRevor

REVOR AI MCP

REVOR AI MCP 可以把目标企业与人物发现、企业研究、联系人搜索、海关贸易数据和授权触达能力接入支持 MCP 的 AI 客户端。连接后，你可以直接用自然语言发起任务，客户端会在需要时调用相应工具。

连接地址

https://revor.ai/api/mcp

这是远程服务地址，不需要下载本地程序。使用 API Key 安装：先在 API Keys 页面创建 Key，再把它保存到客户端私密的 x-api-key Header 中。

如果你希望让 AI 助手代为安装，请把 AI 安装指南 发给它。该页面包含 API Key 获取入口、Header 配置和安装后的验收步骤。

开始使用

  1. 前往 API Keys 页面创建或选择一把 REVOR AI API Key。
  2. 在支持远程 MCP 的客户端中新增 MCP 服务。
  3. 填写服务名称 REVOR AI 和连接地址 https://revor.ai/api/mcp。
  4. 在客户端私密的 Header 或 Secret 设置中添加 x-api-key: sk-revor-...。
  5. 保存连接，刷新工具列表，并调用 revor_whoami 验证账户和权限。

客户端必须支持安全的 Header 或 Secret 设置；如果不支持，请更换支持自定义 Header 的 MCP 客户端。

不同客户端的入口名称可能是“MCP”“工具”“连接器”或“自定义服务”，但只需要填写同一个连接地址。

详细步骤参阅 连接到 MCP 客户端。

也可以直接把下面这句话发送给支持操作 MCP 设置的 AI 助手：

Text
请阅读 https://revor.ai/zh/docs/mcp/install，并严格按照页面说明安装 REVOR AI MCP。服务器 URL 使用 https://revor.ai/api/mcp；如果还没有 API Key，前往 https://revor.ai/my-api-keys 创建。不要让我在聊天中发送 API Key；优先让我填写客户端私密的 x-api-key Secret 输入框。如果只能使用单用户设备上的本机私有配置文件，请写入占位符并告诉我在本机替换，同时确保文件不在 Git、共享目录或云同步目录中。安装后请调用 revor_whoami 验证连接。

可以完成什么

  • 根据自然语言目标画像创建企业或人物潜客名单，并分页读取匹配结果。
  • 查看 credits 与可发送的已连接账户，在确认后执行单条触达或 LinkedIn 互动。
  • 从公开信息中研究企业、市场和近期动态。
  • 按企业域名和职位方向查找业务联系人。
  • 按商品、国家和时间发现进口商或出口商，也可确认已知企业名称并查询交易对手、商品类别、贸易趋势和国家分布。
  • 创建综合海关贸易报告。
  • 查询异步任务的进度、结果和积分用量。

完整列表参阅 MCP 工具说明。

账户、权限与数据隔离

MCP 使用 API Key 所属的 REVOR AI 账户。客户端只能访问该账户有权使用的能力和该账户拥有的任务，不能读取其他用户的数据。

你可以随时撤销或轮换 API Key。撤销后，客户端必须配置新的有效 Key 才能继续使用。

积分与套餐

MCP 与开放 API 复用相同的功能、权限和积分规则：

  • 付费工具按照对应开放 API 的计价规则消耗 credits。
  • 查找海关企业候选名称目前不收费。
  • 海关查询按实际返回行数结算；返回 0 行时最终消耗 0 credits。创建任务时仍会按请求的 page_size 临时检查并预留余额，结算后释放未使用部分。
  • 工具返回的任务结果包含积分结算信息时，以该结算信息为准。
  • 套餐权限、账户余额或使用频率不足时，工具会返回相应错误，不会绕过产品限制。

任务如何返回结果

创建潜客名单、部分研究和海关查询需要一定处理时间。执行型工具会先返回任务或资源 ID。

  • 状态为 succeeded：结果已经可以读取。
  • 状态为 queued 或 running：使用 revor_get_job 和任务 ID 查询进度。
  • 状态为 failed：查看公开错误码并根据提示调整输入或稍后重试。

查询已有任务不会重复创建任务，也不会因为读取状态而再次计费。

创建潜客名单后会返回名单 ID（webset.id）和准备任务 ID（preparation_job.id）。准备任务成功只表示搜索已启动；完整进度应使用 revor_get_webset 查询，结果使用 revor_list_webset_items 分页读取。

使用建议

  • 在提示中提供准确的企业名称、官网域名、查询时间范围和企业角色。
  • 不知道企业名称时，按 HS Code 或商品关键词和目标国家发现企业；分析某家已知企业前，先确认其可查询名称。
  • 海关单次查询最长一年；需要比较更长周期时，拆成多个不超过一年的区间分别查询。
  • 数据任务创建有独立且较低的 RPM 配额。逐个串行创建研究、联系人或海关任务，不要一次并行提交多项创建请求。
  • 让客户端在任务未完成时继续调用 revor_get_job，直到任务进入终态。
  • 不要在聊天中索取或接收 API Key。优先使用客户端的 Secret；仅限单用户设备上的本机私有配置文件可以直接保存 Key，并应限制文件访问权限。共享、云端或会同步的配置禁止保存明文 Key。