RevorRevor

MCP 工具说明

REVOR AI MCP 工具按业务能力命名。工具只返回稳定的 REVOR AI 字段、任务状态和积分信息,不暴露内部实现或第三方服务信息。

工具一览

工具用途计费
revor_whoami检查当前授权账户和连接权限。不计费
revor_research_public_web从公开信息中研究企业、市场或近期动态。按开放 API 规则
revor_find_contacts按企业域名和职位方向查找业务联系人。按开放 API 规则
revor_customs_company_candidates查找并确认可用于海关查询的企业名称。当前不计费
revor_customs_full_report创建包含交易对手、商品类别、趋势和国家分布的综合贸易报告。按返回数据量计费
revor_customs_counterparties查询主要交易对手。按返回数据量计费
revor_customs_categories查询主要商品或 HS Code 类别。按返回数据量计费
revor_customs_trend按月、季度或年度查询贸易趋势。按返回数据量计费
revor_customs_countries查询来源国或目的国分布。按返回数据量计费
revor_create_webset根据自然语言目标画像创建企业 Webset。按开放 API 规则
revor_list_websets分页列出当前账户的 Webset。不重复计费
revor_get_webset查询 Webset 状态、进度和筛选标准。不重复计费
revor_list_webset_items分页读取 Webset 匹配结果。不重复计费
revor_get_job查询当前账户创建的任务状态、结果和积分结算。不重复计费

目标企业发现(Websets)

使用 revor_create_webset 描述要寻找的企业,例如行业、地区、产品、商业模式和必须满足的条件。当前每次创建目标为 25 家企业,并返回 webset.idpreparation_job.id

  • revor_get_job 只用于查看准备任务是否成功启动。
  • revor_get_webset 用于查看完整搜索状态和进度。
  • revor_list_webset_items 用于读取企业结果;搜索进行中时结果可能标记为临时结果。
  • revor_list_websets 默认返回 20 条,limit 最大为 100。

结果使用 cursor 游标分页。读取下一页时,把上一页的 next_cursor 原样传回;has_morefalse 时结束。结果详细度和单页上限如下:

detail内容limit 上限
compact企业核心字段和匹配结论50
standard增加匹配统计和标准摘要25
full增加完整标准判断和公开证据10

示例提示:

Text
寻找 25 家位于德国、生产工业热泵且有海外经销业务的企业。创建 Webset 后持续检查进度,并用 compact 模式分页列出合格结果。

企业公开信息研究

revor_research_public_web 适合企业背景、产品、市场、新闻和公开财务信息研究。

主要输入:

字段说明
queries1 至 2 个明确的研究问题。
search_limit每个问题希望获取的结果数量,最多 10。
category可选的信息类型,例如企业、新闻、财务报告或人物。
include_domains可选,仅从指定网站域名中研究。
user_location可选,两位国家或地区代码。

示例提示:

Text
研究 example.com 的主营产品、目标客户和最近一年的重要动态,并附上公开来源。

企业联系人

revor_find_contacts 需要一个已经确认的企业官网域名。

主要输入:

字段说明
domain企业官网域名,不要填写搜索结果页 URL。
positions可选,希望查找的职位或职能方向。
limit最多返回的联系人数量。
locale结果说明语言,可选 zhen

示例提示:

Text
查找 example.com 负责采购、供应链和国际业务的联系人,最多 10 人。

海关企业名称确认

海关查询依赖准确的企业登记或贸易名称。建议先调用 revor_customs_company_candidates,再从候选项中选择准确名称。

主要输入包括企业名称、企业角色、进口或出口目录、开始日期和结束日期。该工具当前不消耗 credits。

示例提示:

Text
先确认 Example Company 作为进口商在 2025 年可查询的准确海关企业名称。

海关贸易查询

正式海关工具共用以下主要输入:

字段说明
company_name已确认的准确企业名称。
company_role企业在贸易记录中的角色:importerexporter
catalog可选,查询进口或出口目录。
start_date / end_dateYYYY-MM-DD 格式的查询范围。
page_size单页返回数量,最多 20。
period_unit趋势查询的周期:月、季度或年。
filters可选,按 HS Code、商品描述或国家代码缩小范围。

正式查询按照实际返回的数据量结算 credits。综合报告会一次生成四类结果,适合需要完整贸易画像的场景;如果只需要一个维度,使用对应的单项工具更节省时间和用量。

异步任务

Webset 准备、研究、联系人和海关工具通常返回任务对象。任务常见状态如下:

状态说明
queued任务已创建,等待处理。
running正在处理。
succeeded已完成,可读取 resultbilling
failed执行失败,可读取公开错误码。
cancelled任务已取消。

当任务尚未完成时,使用 revor_get_job 并传入 job_id。不要再次提交相同业务请求来代替查询状态,否则可能创建新任务。

幂等与重试

所有执行型工具都必须提供 idempotency_key。仅在网络中断后重试完全相同的输入时复用原值;发起新操作时使用新值。同一个 Key 携带不同输入会返回 idempotency_conflict,且不会启动第二个任务。AI 客户端应自动生成并保留该值。

错误与隐私

工具只返回稳定的 REVOR AI 公开错误码和 request_id,不返回内部调用链、密钥、调试信息或上游原始响应。遇到错误时,优先检查输入、账户权限、credits 和使用频率;联系支持时请保留 request_id 和任务 ID。