渡鸥

MCP 接入指南

接上之后，在 AI 助手里说一句「帮我找 20 家德国的 LED 面板灯批发商」就行。要花钱的时候，助手会先告诉你价格，等你同意了再做。

地址与认证

地址：https://doouai.com/mcp
协议：Streamable HTTP（无状态）
认证：Authorization: Bearer doou_live_…（和对外 API 同一把密钥）

所有账户都能用。密钥在「设置 → API 与 MCP」里创建，步骤见概述 · 接入步骤。

客户端配置

Claude Code

终端命令
claude mcp add --transport http doou https://doouai.com/mcp --header "Authorization: Bearer doou_live_…"

Claude Desktop

在 Claude Desktop 里打开「设置 → 开发者 → 编辑配置」，把下面这段写进 claude_desktop_config.json。它通过 mcp-remote 连接，电脑上要装有 Node.js。

claude_desktop_config.json
{
  "mcpServers": {
    "doou": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://doouai.com/mcp",
        "--header",
        "Authorization:${DOOU_AUTH}"
      ],
      "env": {
        "DOOU_AUTH": "Bearer doou_live_…"
      }
    }
  }
}

Cursor

写进 ~/.cursor/mcp.json，只想在某个项目里用就写进项目的 .cursor/mcp.json。

mcp.json
{
  "mcpServers": {
    "doou": {
      "url": "https://doouai.com/mcp",
      "headers": {
        "Authorization": "Bearer doou_live_…"
      }
    }
  }
}

其他客户端

只要客户端支持远程 MCP（Streamable HTTP），填上面的地址，再在请求头里加上 Authorization 就能用。如果客户端只能跑本地命令，就照 Claude Desktop 的方法，用 mcp-remote 转接一下。

计费确认

有 13 个工具会花钱。调用它们时必须带上你同意的上限：一次性的用 maxFen（单位分），按周订阅的用 weeklyCapFen。执行前服务端会再报一次价，超过上限就不做，把报价交回给助手，让它先来问你。

对话示例（金额仅为示意）
你：帮我找 20 家德国的 LED 面板灯批发商。
助手：（调 search_quote）这次最多 ¥8.74，没找到的不收费。要开始吗？
你：可以。
助手：（调 search_start，maxFen = 874）开始了。（调 search_result 等它跑完）
      找到 20 家，实付 ¥6.12。前三家是……

工具列表

一共 65 个，跟服务端实际提供的一致。

工具说明计费
balance看余额看组织的可用余额、进行中的金额（heldFen）与这期会员用量还剩多少（creditFen），单位分。免费。免费
search_quote找买家：报价开始需求搜索、相似客户搜索、电商卖家搜索、广告主搜索、地图商家搜索前，看这次最多多少钱（免费）。电商卖家搜索、广告主搜索、地图商家搜索的报价不一样，带上 kind。免费
search_start需求搜索（花钱）说一句需求找海外买家：写清卖什么、找哪国的什么买家，比如「LED 面板灯，找德国的批发商」。花钱：最多是报价的金额，实付看结果。必须先调 search_quote，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。收费
similar_start相似客户搜索（花钱）给 1–5 个老客户官网，找跟它们同类的公司（老客户自己和客户库里已有的不会再给）。花钱，报价跟需求搜索一样：必须先调 search_quote，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。收费
search_result买家搜索：取结果看一次需求搜索或相似客户搜索的进度和名单（免费）。还在跑可以用 waitSeconds 等；名单分页：offset、limit。免费
search_list找买家记录这个工作区做过的找买家（需求搜索、相似客户搜索、电商卖家搜索、广告主搜索）。免费。免费
sellers_start电商卖家搜索（花钱）找在亚马逊、谷歌购物上卖这个产品的品牌与网店（名单行带在哪看到它在卖）。花钱：最多是报价的金额，实付看结果。必须先调 search_quote，kind 填 sellers，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。收费
advertisers_start广告主搜索（花钱）找最近在 Facebook / Instagram、谷歌投这个产品广告的品牌（名单行带在哪投的广告）。花钱：最多是报价的金额，实付看结果。必须先调 search_quote，kind 填 advertisers，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。收费
merchant_types地图商家搜索：商家类型地图商家搜索能选的商家类型（零售门店、批发分销、工程安装三组）。给了 product 或 productId 时同时按产品挑好几类（免费）。免费
merchants_start地图商家搜索（花钱）找 Google 地图上卖这个产品的本地门店、批发商、工程商（名单行带地图上的类型、城市、评分与评论数，联系方式里有官网和电话；只给有官网、还在营业的）。types 用 merchant_types 里的 id。花钱：最多是报价的金额，实付看结果。必须先调 search_quote，kind 填 merchants，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。收费
trade_company_quote企业进口记录：报价查一家公司的进口记录：从哪买、买多少、供应商和官网。报价免费：给出可选的查看项和这次最多多少钱。执行用 trade_company_run。免费
trade_company_run企业进口记录（花钱）查一家公司的进口记录：从哪买、买多少、供应商和官网。花钱：最多是报价的金额，实付看结果。必须先调 trade_company_quote，把金额告诉用户、用户同意后再带 maxFen 调用；按报价算超过 maxFen 不会执行。收费
trade_product_quote产品查询：报价进口商查询：查某国谁在进口这个产品，名单来自海关提单。报价免费：给出可选的查看项和这次最多多少钱。执行用 trade_product_run。免费
trade_product_run产品查询（花钱）进口商查询：查某国谁在进口这个产品，名单来自海关提单。花钱：最多是报价的金额，实付看结果。必须先调 trade_product_quote，把金额告诉用户、用户同意后再带 maxFen 调用；按报价算超过 maxFen 不会执行。收费
trade_competitor_quote竞品客户查询：报价进口商查询：查某个同行（出口商）在某国卖给了谁。报价免费：给出可选的查看项和这次最多多少钱。执行用 trade_competitor_run。免费
trade_competitor_run竞品客户查询（花钱）进口商查询：查某个同行（出口商）在某国卖给了谁。花钱：最多是报价的金额，实付看结果。必须先调 trade_competitor_quote，把金额告诉用户、用户同意后再带 maxFen 调用；按报价算超过 maxFen 不会执行。收费
trade_result看以前的海关查询按 runId 看以前的一次产品查询、竞品客户查询或企业进口记录（免费）。免费
trade_list海关查询记录这个工作区以前的海关查询（新的在前，最多 50 次，不含结果；看结果用 trade_result）。免费。免费
company_lookup查一家公司给官网、公司邮箱或公司名，认出是哪一家（免费）。只给了公司名时认不出官网，问用户要官网或公司邮箱填 website。addToLibrary 为 true 时认出官网就加进客户库（免费）。免费
company_get看一家公司一家公司的详情：在不在客户库、买家类型、在哪看到它在卖或投广告、哪几次找到过它、海关摘要、联系方式链接。不在客户库也能看（找到过的、海关查询或求购信息里认出的）。免费。免费
global_search全局搜索在这个工作区里搜：客户库里的公司（名字、官网）、联系人（名字、邮箱）、做过的搜索（需求、产品），每类最多 5 条。免费。免费
company_contacts看一家公司的联系方式公司公开的邮箱、电话、联系页、社媒，和已知的人；查到过的邮箱 / 手机也在里面。免费。公司要在这个工作区的名单或客户库里。免费
company_channels_refresh再找一遍公司联系方式从官网、地图等再找一遍公司公开的联系方式。免费，要几秒到几十秒。免费
contacts_quote找联系人：报价找这家公司的人（采购在前）并报价。找人免费，查邮箱 / 手机才收钱，没找到不收；查到过的人在 alreadyPaid 里，不再收。人的 key 是联系人编号（p_ 开头）。执行用 contacts_run。免费
contacts_run找联系人：查邮箱（花钱）查选中的人的工作邮箱（可选手机）。花钱：没找到不收，查到过的不再收，实付看结果。必须先调 contacts_quote，把人选与金额告诉用户、用户同意后再带 maxFen 调用；按报价算超过 maxFen 不会执行。收费
verify_quote邮箱验证：报价验证邮箱能不能收信之前，看要验几个、最多多少钱（免费）。30 天内验证过能收信的跳过（skipped）。给 emails、companyIds 或 allUnverified 之一。免费
verify_start邮箱验证（花钱）验证邮箱能不能收信（有效 / 收不到 / 不确定能收到 / 结果不明）。花钱：最多是报价的金额，结果不明、没验成的不收。必须先调 verify_quote，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。后台一个个验，用 verify_result 取。收费
verify_result邮箱验证：取结果看一批邮箱验证（运行中可以用 waitSeconds 等）：验完一个出一个结论，还在验的是 pending；全部验完才有实付 chargedFen。免费。免费
library_list客户库列表客户库（找到的、加进来的、手动建的客户）。可按名称 / 域名 / 备注搜、按国家、阶段、标签、负责人、待办到期、重点、产品筛；一页 50。免费。免费
library_get看客户库里的一家一家客户的跟进信息（阶段、标签、备注、负责人、下次待办）。免费。免费
library_update改跟进改一家客户的阶段、标签、备注、负责人、重点（只改给了的）；改阶段会自动记一条跟进。免费。免费
library_add加进客户库两种：海关查询（产品查询、竞品客户查询、企业进口记录）里认出来的公司（companyId + tradeRunId）；或手动新建一家（website 必填，按官网认公司）。免费。免费
library_stats客户报表客户库的阶段分布、各来源找到的客户与跟进的、近 8 周新增与跟进、按负责人。免费。免费
activities_list看跟进记录一家客户的跟进记录（新的在前）。免费。免费
activity_add记一条跟进给一家客户记一条跟进（笔记、邮件、电话、会议、WhatsApp、寄样、报价、下单）。免费。免费
people_list联系人列表客户库里的联系人：付过钱查到的和手动记的。可按名字 / 职位 / 公司搜，按角色、有邮箱 / 手机筛；一页 50。免费。免费
company_not_relevant标不相关这家对这个产品不相关：以后找买家不再给它（按组织）。reason：not_this_product 卖的不是这个（把这家卖的东西记成产品卡的排除词）、competitor 同行、forwarder 货代、too_small 太小、other 别的。免费。免费
company_not_relevant_undo撤销不相关撤销对这家、这个产品说过的「不相关」（当时加进产品卡的排除词也拿掉）。免费。免费
outreach_write写开发信按这家的情况（卖什么、在投什么广告、从哪进口、官网上的说法）和我的产品写一封第一次联系的信，用对方的语言，带中文对照。只写不发：发信在工作台上。免费。免费
outreach_rewrite改写开发信把写好的一封改写：another 换一封、shorter 短一点、formal 更正式。只写不发。免费。免费
watch_list关注与订阅关注的客户、同行，需求订阅、求购帖订阅（每周上限、这周花了多少、暂停没有）。免费。免费
company_watch关注一家客户关注客户库里的一家：有新的进口记录、开始投广告、在招采购这些动静出一条客户动态（signals_list）。免费（会员专属）。免费
posts_subscribe订阅求购帖（花钱）每周查一次领英上有没有人发帖找这个产品的供应商，有新的出一条客户动态（signals_list 里 kind 是 new_posts，帖子用 posts_result 看）。花钱：每周最多 weeklyCapFen（分），没找到新的不收。必须先把每周上限告诉用户、用户同意后再调。同一产品同一国家只订一次。会员专属。收费
watch_update暂停 / 恢复订阅，改每周上限暂停或恢复一个关注 / 订阅，或改订阅的每周上限（分）。免费。免费
watch_delete取消关注 / 订阅取消一个关注或订阅（它出过的客户动态一起删）。免费。免费
signals_list客户动态关注的客户、同行和订阅的动静（新的进口记录、开始投广告、新买家、新的求购帖……），一页 50。new_posts 用 posts_result 看帖子，new_buyers 用 search_result 看名单。免费。免费
signals_read标已读把客户动态标成已读：给 ids，或 all 为 true 全部标。免费。免费
signal_to_task动态转待办把一条客户动态转成待办（挂这家公司，标题是建议做的事，负责人是自己）；转过的回原来那条。公司要在客户库里。免费。免费
posts_result看求购帖一次求购信息：求购帖订阅查到的新帖子（客户动态里 new_posts 那条的 runId）。帖子作者的公司认出来了可以加进客户库。免费。免费
tasks_today今天要做的待办没做完的待办里过期的和今天到期的（按北京时间），默认只看自己的。免费。免费
tasks_list待办列表按状态、时间（overdue 过期 / today 今天 / week 7 天内）、负责人、客户筛待办。免费。免费
task_create建待办建一件待办（可以挂一家客户），到期日按北京时间；不给负责人就是密钥的建立人。免费。免费
task_complete完成待办把一件待办打勾做完。免费。免费
products_list我的产品组织卖的产品（名称、HS、英文名与别名、价格区间、起订量、认证、产品卡），找买家、国家进口榜单时可以直接用。免费。免费
product_understand理解产品把产品名理解成产品卡（英文叫法、海关编码、谁买、排除词），给一到几种理解让用户选（免费）。写名字（name）就建好这个产品（同名的用已有的），或给已有的 productId。用户选好后调 product_card_confirm。免费
product_card_confirm确认产品卡用户选好的那种理解写进产品卡（之后找买家、海关查询、国家进口榜单都按卡找）。免费。免费
product_card_edit改产品卡改已经确认的产品卡：只改给了的几项（整组替换）。免费。免费
market_quote国家进口榜单：报价做国家进口榜单前，看这份最多多少钱（免费）。每月 1 份不收钱（maxFen 是 0）；30 天内同一产品 + 国家做过的不收钱（给了 hs 才认得出）。免费
market_start做国家进口榜单一个产品，哪些国家值得做：国家排行（推荐度、规模名次、增速、中国份额与对手、季节性、关税、买家结构）。每月 1 份不收钱；要收钱时先调 market_quote，把金额告诉用户、用户同意后再带 maxFen 调用，报价超过 maxFen 不会开始。同一产品 + 国家 30 天内再做不收钱。后台跑，用 market_result 取。收费
market_result国家进口榜单：取结果看一份国家进口榜单（运行中可以用 waitSeconds 等）。运行中先给已经查到的国家：pending 是这一行还在查的格子，名次是临时的，全部查完再定。免费。免费
market_list国家进口榜单记录这个工作区做过的国家进口榜单。免费。免费
reviews_quote买家评论分析：报价做买家评论分析前，看这份最多多少钱（免费）。7 天内本组织看过同一个的不收钱。免费
reviews_start买家评论分析（花钱）归纳亚马逊上这个品类（或一个商品）的买家抱怨什么、夸什么、常问什么，给改款与卖点的建议，每条带原话。花钱：最多是报价的金额，什么都没归纳出来不收。必须先调 reviews_quote，把金额告诉用户、用户同意后再带 maxFen 调用；报价超过 maxFen 不会开始。后台跑，用 reviews_result 取。收费
reviews_result买家评论分析：取结果看一份买家评论分析（运行中可以用 waitSeconds 等）。免费。免费
reviews_list买家评论分析记录这个工作区做过的买家评论分析（不含主题，看一份用 reviews_result）。免费。免费