MCP 工具说明
REVOR AI MCP 工具按业务能力命名。工具只返回稳定的 REVOR AI 字段、任务状态和积分信息，不暴露内部实现或第三方服务信息。
工具一览
目标企业与人物发现
使用 revor_create_webset 描述要寻找的企业或人物。target_kind 可选 company 或 person；人物目标可以描述职位、职级、地区、行业经历和当前公司。可请求的数量由账户会员档位决定：
服务不会把越档数量静默缩小；不在当前套餐内的数量会明确返回会员档位错误。创建成功后返回 webset.id 与 preparation_job.id。
revor_get_job只用于查看准备任务是否成功启动。revor_find_more_webset用于在已有合格结果基线上追加count个目标；它需要稳定的idempotency_key，返回后用revor_get_job检查新一轮是否成功入队。revor_get_webset用于查看完整搜索状态和进度；其中progress.verified只统计当前运行，progress.qualified是结果池口径，可能包含尚未释放的 overflow。revor_get_webset_strategy用于尽早读取搜索条件与挖掘策略；根据criteria_ready、strategy_ready判断是否可展示，不需要等待名单完成。revor_list_webset_items用于读取企业结果；搜索进行中时结果可能标记为临时结果。完成后持续分页到has_more=false才是最终可见名单。revor_list_websets默认返回 20 条，limit最大为 100。
条目中的 match.score 是 0–100 的综合加权匹配分，match.status 按分数分为 full、partial、rejected；full 和 partial 都属于合格结果。单条件名单中，综合分可能与该条件的置信度乘以 100 相同。entity.name 只是展示名称，MCP 客户端应使用条目 id 作为唯一键，并结合网站区分同名企业或地区法人。
结果使用 cursor 游标分页。读取下一页时，把上一页的 next_cursor 原样传回；has_more 为 false 时结束。结果详细度和单页上限如下：
示例提示：
Text寻找 100 位德国工业自动化企业的采购或供应链负责人。创建人物潜客名单后持续检查进度，并用 compact 模式分页列出合格结果。
账户、渠道与触达
先使用 revor_list_connect_accounts 并设置对应 channel 与 can_send=true，再把返回的账户 ID 交给触达工具。revor_send_outreach 和 revor_like_linkedin_post 会对外产生真实操作；AI 客户端应在调用前让用户确认收件人、渠道和内容，并为重试保留相同的 idempotency_key。
MCP 与开放 API 按账户和工具类型共享会员限流，切换 API Key 或调用协议不会获得额外额度。请求频率、活动任务并发和 Credits 分别检查；完整额度、工具分类和重试方式参见限流、并发与重试。
企业公开信息研究
revor_research_public_web 适合企业背景、产品、市场、新闻和公开财务信息研究。
主要输入：
示例提示：
Text研究 example.com 的主营产品、目标客户和最近一年的重要动态，并附上公开来源。
企业联系人
revor_find_contacts 需要一个已经确认的企业官网域名。
主要输入：
示例提示：
Text查找 example.com 负责采购、供应链和国际业务的联系人，最多 10 人。
海关企业名称确认
海关查询依赖准确的企业登记或贸易名称。建议先调用 revor_customs_company_candidates，再从候选项中选择准确名称。候选结果中的贸易行数只能证明该名称可查询，不能证明法律实体身份。
同一个短名可能聚合多个国家或地区的同名企业。引用结果前应结合候选项的国家、企业 ID 和后续数据逐一核验；完整名称查不到时可以尝试短名，但短名只能作为扩大召回的候选，不应直接当成已确认实体。
主要输入包括企业名称、企业角色、进口或出口目录、开始日期和结束日期。该工具当前不消耗 credits。
示例提示：
Text先确认 Example Company 作为进口商在 2025 年可查询的准确海关企业名称。
海关企业发现
不知道公司名称时，使用 revor_customs_discover_companies 按贸易活动反向寻找企业。company_role=importer 用于寻找买家或进口商，company_role=exporter 用于寻找供应商或出口商。
主要输入包括 HS Code 或商品关键词、来源国、目的国、时间范围、分页和排序。HS Code 必须是 2、4、6、8 或 10 位数字；一次只能传一个编码或章节前缀，不能传 84,85、空格分隔列表或 84-85 范围。多个品类应分别查询。国家建议使用 ISO 3166-1 alpha-3，例如 CHN、BRA；有效的 alpha-2 输入也会被规范成 alpha-3。
如果已经知道企业名称，先用 revor_customs_company_candidates 核验名称和查询路由，再调用企业维度的海关工具；只有不知道目标企业时才使用 revor_customs_discover_companies 反向发现名单。
示例提示：
Text查找最近一年从中国进口 HS 8429 工程机械到巴西的企业，按交易次数降序返回前 20 家。不要要求我先提供公司名称。
海关贸易查询
正式海关工具共用以下主要输入：
正式查询按照实际返回的数据量结算 credits；返回 0 行时最终消耗 0 credits。当前行级量级如下，实际结果以任务的 billing.charged_credits 为准：
综合报告把四类结果的实际返回行数分别计费；单项工具只计算该维度。创建时会根据 page_size 临时预留可用余额，因此即使最终为 0 行，余额不足仍可能阻止任务创建；结算后未使用的预留会释放。当前没有查询前 dry-run 估价，控制成本时应降低 page_size，完成后读取 billing。
异步任务
潜客名单准备、企业研究、联系人和海关工具都采用任务机制。企业研究、联系人和海关创建工具会先等待服务端的同步等待上限（默认 20 秒），大多数快速任务可在首次工具调用中直接返回已完成的 item。客户端的单次工具调用超时应设置为至少 30 秒，否则可能在服务端正常等待期间提前报超时。等待过程监听任务完成事件，不会循环查询任务状态，从而减少无效请求和轮询限额消耗；潜客名单搜索通常会超过该窗口，因此保持异步。任务常见状态如下：
创建工具会把任务返回在 item 中，并提供可直接执行的 next_action。如果任务在同步等待期间完成，next_action 为 null，结果已可直接使用。否则请保存 item.id，等待 next_action.retry_after_ms，再用 next_action.arguments 调用 revor_get_job（等价于传入 { "job_id": item.id }）。持续查询同一个任务 ID，直到状态变为 succeeded、failed 或 cancelled。不要再次提交相同业务请求来代替查询状态，否则可能创建新任务。
revor_cancel_job 只保证取消 queued 或 scheduled 状态的任务。任务进入 running 后可能已经调用外部服务或产生副作用，因此会返回 job_already_running，不会伪报取消成功。
幂等与重试
所有执行型工具都必须提供 idempotency_key。仅在网络中断后重试完全相同的输入时复用原值；发起新操作时使用新值。同一个 Key 携带不同输入会返回 idempotency_conflict，且不会启动第二个任务。AI 客户端应自动生成并保留该值。
错误与隐私
工具只返回稳定的 REVOR AI 公开错误码和 request_id，不返回内部调用链、密钥、调试信息或上游原始响应。遇到错误时，优先检查输入、账户权限、credits 和使用频率；联系支持时请保留 request_id 和任务 ID。
API Key 在 MCP HTTP 入口触发限流时，响应使用 JSON-RPC 错误，而不是 REST 错误体：
JSON{ "jsonrpc": "2.0", "error": { "code": -32001, "message": "REVOR AI request rate limit exceeded.", "data": { "code": "api_key_rate_limit_exceeded", "request_id": "...", "retry_after_ms": 60000 } }, "id": null }
HTTP 响应同时包含 Retry-After。工具执行阶段触发限流时，错误内容中的 error.retry_after_ms 给出等待时间；客户端即使拿不到 HTTP Header，也应优先使用该字段，不要立即并行重试。