元宝搜索 API 之外：小红书、抖音、B 站数据怎么补

腾讯在 2026 年 10 月 20 日把元宝搜索通过腾讯云开放给开发者，提供 API、MCP、Skill 三种接入方式，每月 2,000 次免费调用，按量价格从每千次 14 元起（快科技 10 月 20 日报道、腾讯云计费概述）。它的 SearchPro 接口每条结果只返回标题、发布时间、链接、摘要、站点名、相关性分、图片等网页字段，没有点赞、评论、收藏、播放和作者粉丝数，腾讯云常见问题还写明「暂不支持微信公众号内容」（SearchPro 接口文档、常见问题）。我们在 2026 年 11 月 6 日 00:17–00:20（新加坡时间）用同一个话题「羽绒服 测评」真调了小红书、抖音、B 站和公众号，6 次扣费合计 $0.028557：小红书、抖音、B 站返回的每一条结果都带点赞、评论和发布时间，公众号文章还能另查阅读和在看。SearchPro 的返回里没有这些数，这就是要在元宝搜索旁边再挂一个平台数据接口的原因。EveryInfra 和腾讯没有合作关系，两边是各自独立的服务。

这篇文章回答一个具体问题：开发者已经用 元宝搜索 mcp 或 API 给 agent 接上了网页搜索，想回答「今年羽绒服大家都在吐槽什么」这类消费品问题时，还缺什么、怎么补、补一次多少钱。腾讯一侧的每条事实都来自 cloud.tencent.com 的文档原文和 10 月 20 日到 22 日的发布报道，每条写了我们读到的时间；我们没有注册腾讯云，所以元宝搜索的请求和配置都写成「配置示例」，没有真调。EveryInfra 一侧的每个数字都来自 11 月 6 日凌晨的真实返回。站内的 DeepSeek Search API：平台内数据怎么补讲的是 DeepSeek 的搜索接口和函数调用，本文换成腾讯的内容生态和 MCP 并列挂载，两篇的区别在后面单独一节写清楚。

元宝搜索 api 是什么：11 月 6 日读到的原文

元宝搜索的英文名是 Tencent Yuanbao Search，产品代号 wsa。按腾讯云产品动态，它在 2025-07-01 以「联网搜索API」的名字上线，2026-01-21 加了轻量版，2026-05-29 上线旗舰版，2026-10-09 正式更名为「元宝搜索」。10 月 20 日的开放不是新产品，而是把腾讯内部已经在用的搜索服务对外开放：凤凰网科技 10 月 20 日的报道援引腾讯的说法，元宝搜索已构建千亿级索引，日均调用数亿次，支撑 WorkBuddy、ima、腾讯金融科技、腾讯视频等 50 多个业务。下面这张表把我们关心的事实逐项列出来，读取时间都是 2026 年 11 月 6 日新加坡时间 00:13–00:41。

有几件事原文没有写，我们也不替它补。第一，计费概述只写了「服务调用失败不计费」，没有写「返回 0 条结果算不算成功调用」，所以空结果会不会扣费，目前要以账单为准。第二，计费概述和退费说明都没有提免费额度，MCP 页只说免费额度规则看控制台「活动专区」页面，具体以页面为准；每月 2,000 次和邀请码 6,000 次这两个数来自发布报道。第三，产品概述只列了腾讯新闻、搜狗百科、企鹅号三个腾讯内容源，没有说小红书、抖音、B 站的内容收了多少；我们没有 Key，也就没法自己去量。第四，Cnt 设成 50 时单价是否变化，计费页没有写，表里只有「每千次调用」一种单位。

元宝搜索 api 怎么开通：注册、Key 和免费额度

按服务 API KEY 方式这一页，开通分四步：注册腾讯云账号并完成个人或企业实名认证；进入元宝搜索控制台的概览页自助开通服务；在「服务 API KEY 方式」里创建 API KEY；按兼容模式向 api.wsa.cloud.tencent.com/SearchPro 发请求。这一页有两个容易漏掉的限制：每个 subuin（包括主账号）最多同时持有 3 个 API KEY；明文 Key 只在创建时显示一次，之后查不到，要当场下载 CSV 或复制保存。如果用子账号创建 Key，主账号要先在访问管理里给它授予元宝搜索的全读写权限；常见问题另外写了两条：子账号调用显示未授权，是因为没有 CAM 授权；开通失败，多半是账号处于欠费状态。

免费额度要分开看原文和报道。快科技 10 月 20 日 15:55 的报道和凤凰网科技都写每月 2,000 次免费调用；快科技当天 18:15 的第二篇把它叫作「2000次/月」的免费限时福利，所以这个额度是限时的，截止日期报道没写。东方财富财富号 10 月 22 日的文章多给了一个条件：10 月、11 月通过邀请码每月最高 6,000 次。三种接入方式是否共用同一份额度，腾讯云文档没有写，一篇知乎专栏写的是「三种接入方式共用」。我们的建议是：把 2,000 次当成开发和小流量的额度，不要把它算进长期成本，月底在控制台核一次用量。

价格这一块，按量计费是后付费，按日结算，次日出账单；资源包是预付费，只有标准版有，买的越多单次越便宜。为了和 EveryInfra 的美元价放在一起比，我们用 国家外汇管理局公布的人民币汇率中间价 2026-11-05 的 1 美元兑 6.7156 元换算，表里的美元数都是「约合」。

退费规则也写在原文里：资源包在一年有效期内、没用完的部分可以自助退，退款金额等于实付金额乘以未使用比例，买包时用的代金券不退；按量计费产生的费用不支持退款（退费说明）。对 agent 场景来说，这意味着先用按量和免费额度把调用量跑出来，再决定要不要买包；100 万次的包按单次算比按量便宜约 7.5%，量没稳定之前买大包没有必要。

元宝搜索 api 返回什么：网页字段，没有互动数

SearchPro 的出参里，搜索结果放在 Pages 数组，每个元素是一个 JSON 字符串，客户端要再解析一次（SearchPro 接口文档）。三个版本能拿到的字段不一样，下面按原文整理；pics 在 API KEY 方式的示例返回里写成了 images，两个名字我们都见到了，接入时以实际返回为准（API KEY 方式示例）。

请求参数这边，Query 必填，MCP 页写的上限是 1,500 个 UTF-8 字节，约 500 个中英文字符；Mode 取 0（公开网页）、1（优质权威垂直信源，也就是天气、金价、股价这类卡片）、2（混合）；Site 可以指定一个域名，或用 exclude: 排除最多 5 个域名；Cnt 取 10、20、30、40、50；Industry 取 gov、news、acad、finance；Freshness 支持最近 N 天（1～30）、N 月（1～12）、N 年（1～5）、某一天或日期区间。极速版不支持 Mode、Cnt、Industry（SearchPro 接口文档）。这些参数足够把搜索限定在「最近 7 天的新闻」或「某个站点」，适合给 agent 找背景、找出处、找政策原文。

问题在于消费品口碑需要的那几列。把元宝搜索的字段表和我们三个平台的真实返回放在同一张图里，差别一眼就能看出来：元宝搜索一列只有发布时间是文档里有的，其余六项都是「文档里没有这个字段」；小红书、抖音、B 站三列的点赞、评论、收藏、发布时间都是 100% 有值。字段名对应的是 EveryInfra 目录里的 response_fields：小红书目录有 like_count、collect_count、comment_count、share_count、posted_at、is_cooperation_note；抖音目录多了 author_follower_count、view_count、is_ad；B 站目录有 view_count、danmaku_count、favorite_count、coin_count。

这张图里有两格要说明。小红书的 share_count 这次 19 条全是空值，B 站的 share_count 也是 0%，所以「分享」这一行不能当成三个平台都有的指标；抖音的 view_count 10 条全空，抖音的播放数要换别的能力拿，搜索结果里只能用点赞、评论、收藏、分享四个数。小红书的 is_cooperation_note、author_is_verified 和抖音的 author_is_verified 这次全部是 false，抖音的 is_ad 全部是空值；我们只看了一个话题，不能判断这是真实分布还是默认值，所以不把它们写进结论，也不建议仅凭这几个布尔值过滤广告。

实测一：同一个话题「羽绒服 测评」，四个平台各回了什么

我们在 2026 年 11 月 6 日新加坡时间 00:17 到 00:20 之间对同一个话题发了 10 次请求，全部经 POST /api/v1/social。其中 2 次撞上了这把测试 Key 每分钟 10 次的限额，返回 429，没有扣费；1 次小红书按「最多点赞 + 近 30 天」排序返回 0 条，按空结果退回；1 次故意把抖音的 sort 写成 hot，返回 422。真正扣费的 6 次合计 $0.028557。

小红书这次 19 条全是视频笔记，发布时间在 2026-11-02 到 2026-11-05 之间，点赞中位数只有 9，最高的一条是 334 赞、14 条评论、101 次收藏，是一条小个子试穿某品牌全系列的视频笔记；19 条里有 6 条评论数是 0。按「最新」排序拿到的是刚发的笔记，互动数自然低，这类结果的价值在于看「这几天大家在测什么牌子」，而不是看哪条最火。我们第一次按「最多点赞 + 近 30 天」排序拿到 0 条，接口按空结果退回了预扣的费用，返回里的 reason 是 empty_result_refunded；换成 newest 后正常返回。

抖音按「最多点赞 + 近一周」拿到 10 条，点赞在 1,507 到 17,048 之间，中位数 4,896.5，10 条评论数合计 4,501。点赞最高的一条 17,048 赞、853 条评论、6,699 次收藏、3,674 次分享，作者粉丝 130,114；第二条是一条讲波司登的视频，15,377 赞、1,053 条评论、15,860 次分享，分享数比点赞还高。作者粉丝数从 137 到 464,930 都有，粉丝只有 137 的账号也能拿到 8,217 赞、1,433 条评论，这说明抖音的结果不能按粉丝数过滤，否则会漏掉小号的爆款。

B 站默认排序拿到 20 条，播放数从 0 到 1,695,719，中位数 1,047.5，弹幕合计 3,447 条。播放最高的是一位测评 UP 主 2023-12-01 发的横评视频，1,695,719 播放、44,806 赞、3,678 条评论；20 条里有 4 条是一年以前发的。我们接着用 bilibili/comments 拉了这条视频的热门评论，3 条点赞分别是 3,999、1,843、1,831，最高的一条是观众写的「省流」总结。这正是网页搜索补不上的一层：视频页面能被搜到，但评论区里哪些话被几千人点了赞，要进平台内去拿。

实测二：发布时间，平台内结果有多新

消费品口碑问题对时间很敏感，去年的测评和这周的吐槽不是一回事。我们按调用时刻（2026-11-05T16:19:30Z）把四个平台的结果按发布时间分成四段：1 天内、1～7 天、7～30 天、30 天以上。小红书 19 条全部在 7 天内，其中 12 条在 1 天内，中位数只有 0.47 天；抖音 10 条全部在 7 天内，这是我们传了 publish_time=one_week 的结果，中位数 2.56 天；B 站默认排序 20 条里 13 条在 7 天内，但有 6 条超过 30 天，最老的一条发于 2021-01-22；公众号 36 篇里 24 篇在 30 天内，12 篇更早，最老的一篇是 2024-12-18。

这张图对 agent 的设计有直接影响。小红书和抖音返回的结果天然新，可以直接拿来回答「最近」；B 站和公众号的结果新老混在一起，送进模型之前要先按 posted_at 过滤，否则模型会把 2021 年的拆衣服视频当成今年的口碑。元宝搜索这边有 Freshness 参数，可以把网页结果限定在最近 N 天，这一点和平台接口的 date_range、publish_time 作用相同；区别在于，元宝搜索的 date 是网页的发布时间，平台接口的 posted_at 是笔记或视频本身的发布时间，两者在转载、聚合页上会不一样。

实测三：这些平台内结果，公开网页索引里能找到几条

「网页搜索找不到平台内内容」常被当成常识，我们想用数据核一下，同时把方法的边界说清楚。我们没有元宝搜索的 Key，所以这个探针用的不是元宝搜索，而是一个公开网页搜索引擎（Google，地区设成中国、语言中文）：对上面真调拿到的每一条结果，取标题前 18 个字加引号，再加 site: 限定到对应平台的域名，看前 10 条结果里有没有同一个笔记或视频 ID。为了确认这个方法本身能找到东西，我们先挑了 6 条已知被收录的抖音和 B 站页面做对照，6 条全部命中；第一版方法（直接搜 ID）在这 6 条对照上一条也没命中，所以作废，没有用它的结果。

结果是：小红书 0/19，抖音 0/10，B 站 4/20，公众号 0/36，对照组 6/6。小红书和公众号的零主要是 robots.txt 决定的（robots.txt 是一个约定，不是访问控制，格式见 RFC 9309）：小红书的 robots.txt 对 Googlebot 写的是 Disallow: /，对通配的 * 也是 Disallow: /；公众号的 robots.txt 对所有爬虫只放行少数路径，文章所在的路径不在其中。同一时间我们还在同一个引擎里直接搜「羽绒服 测评」加 site:，小红书和公众号不限时间、限定一周都是 0 条，和上面一致。

抖音和 B 站的零不能解释成「新视频还没被收录」，因为同一组对照数据不支持这个说法。抖音的 robots.txt 和 B 站的 robots.txt 都只禁了少数路径，视频页本身允许抓取。限定一周后，这个引擎对 B 站返回 10 条，全是羽绒服测评，标着「12小时前」到「6天前」；对抖音返回 9 条，标着「1天前」到「6天前」，不过标题里只有 1 条和羽绒服有关。对照组的 6 条里也有新视频：一条抖音标着「1天前」，一条 B 站标着「6天前」，都按标题命中了。所以数据只能说明一件事：平台内按「最多点赞」或默认排序返回的这一批，恰好不在网页搜索的前 10 条里。B 站命中的 4 条发布了 16.1、1,070.6、1,386.1、2,113.4 天，7 天内的 13 条一条没中，这同样说明两边排序不同，而不是收录慢。对 agent 来说，可以确定的是两点：网页搜索会拿到哪几条视频，你控制不了，和平台内的「最多点赞」「最新」排序对不上；拿到的那几条也没有点赞、评论、收藏数。

这个结果不能直接套到元宝搜索上，原因有两个。第一，元宝搜索和我们用的引擎不是同一个索引，腾讯说元宝搜索「分钟级更新」（产品概述），它收了哪些平台页面、按什么排序，都可能和 Google 不一样。第二，小红书的 robots.txt 对搜狗的网页爬虫和移动爬虫放行了 /explore 和笔记的站点地图，搜狗又是腾讯的，所以元宝搜索的索引里有可能收了一部分小红书笔记页，我们没法验证有多少。能确定的只有两点：即便收了，SearchPro 的返回字段里也没有点赞、评论、收藏数；公众号这一块腾讯自己写了暂不支持。想自己量的读者，可以用元宝搜索的 Site=xiaohongshu.com 加 Freshness=d7 搜同一个话题，再和 xiaohongshu/search 的结果按笔记 ID 对一遍。

公众号：元宝搜索明说不支持的那一块

腾讯云常见问题里有一条专门的问答：「包含微信公众号内容吗？由于内容版权问题，元宝搜索暂不支持微信公众号内容。」（常见问题）这是元宝搜索文档里唯一一处明确写出「不收」的内容源。对消费品问题来说，公众号恰恰是长文测评最集中的地方，比如我们这次搜到的 36 篇「羽绒服 测评」文章，来自 25 个公众号，最早的一篇是 2024-12-18 发的。

EveryInfra 有两个公众号能力可以补这一块：wechat_oa/article_search 按关键词搜文章，返回标题、摘要、链接、公众号名和发布时间，这次 36 篇一次返回，$0.008；wechat_oa/article_metrics 按文章链接拿阅读数、点赞、在看、分享、收藏、评论数，一篇 $0.005556。我们取了搜索结果里一篇 2025-11-19 发的「实测14款羽绒服」文章（公众号「老爸评测」），拿到 read_count 100001、like_count 2763、watching_count 1455、share_count 7763、collect_count 932、comment_count 94。阅读数 100001 很可能对应页面上显示的「10万+」，也就是说这个数是一个下限，不是精确值；我们没有找到文档说明，所以在回答里写「10 万以上」更稳妥。平台总览在公众号爬虫页。

公众号的分享数 7,763 比点赞 2,763 高得多，这和抖音那条波司登视频的情况类似：测评类内容的主要传播方式是转发，而不是点赞。如果 agent 只看点赞来判断「哪篇测评影响大」，会低估这类文章；把分享和收藏一起看，排序会更接近读者的实际行为。

回答怎么写出处：按这次真实返回整理的样例

两种数据混在一个回答里，最容易出的问题是读者分不清哪句话来自新闻、哪句话来自用户。我们按这次真实返回整理了一个格式样例，元宝搜索那一段没有真调，只写占位说明。第一段讲背景：「今年羽绒服的国标和价格变化」这类事实，引用元宝搜索返回的网页，每条后面写站点名和 date。第二段讲用户声音：抖音近一周点赞最高的 10 条视频里，一条讲波司登做工的视频有 15,377 赞、15,860 次分享，分享比点赞还多；B 站播放最高的横评视频有 1,695,719 次播放，热门评论第一条有 3,999 赞，内容是观众写的结论摘要；每条都写平台、发布日期和拿到数据的时间。第三段讲长文测评：公众号「老爸评测」2025-11-19 的一篇测评，阅读 10 万以上、在看 1,455。最后一行写清楚「平台数据截至 2026-11-06 00:20 新加坡时间」，因为这些数字下一次调用就会变。

这个格式有两个好处。一是可核对：每个数字都能回到一次具体的调用，读者或审核的人可以按链接和时间去看原页面；二是可控成本：模型只需要拿到每条结果的标题、链接、三四个计数和发布时间，不需要整页正文，送进模型的内容会短很多。元宝搜索返回的 passage 和 content 摘要适合放在第一段做背景，平台结果适合放在第二、三段做证据，两者的位置固定下来以后，模型写出来的回答结构也会更稳定。

元宝搜索 mcp 和 EveryInfra MCP 并列挂在一个 agent 上（配置示例）

两个服务都是远程 MCP 服务器，都用 Streamable HTTP 传输，都在请求头里带 Authorization: Bearer。元宝搜索 MCP 只有一个工具 SearchPro（元宝搜索 MCP 页）；EveryInfra 的 MCP 在 11 月 6 日 00:24（新加坡时间）读到的 tools/list 返回 12 个工具，其中 everyinfra_list_capabilities 免费列出平台和能力，everyinfra_call_api 调具体能力，everyinfra_get_job 取异步任务结果。传输方式的定义在 MCP 规范 2025-06-18 版的 Transports 一节，客户端先发 initialize 协商协议版本（Lifecycle），再用 tools/list 和 tools/call 列出、调用工具（Tools）。

下面是 Claude Code 项目根目录 .mcp.json 的写法，两个服务器并列，Key 都从环境变量读。腾讯 MCP 页给的样例里写的是 "type": "streamableHttp"，而 Claude Code 的 MCP 文档（2026-11-02 更新）写的是 type 接受 http，并把 streamable-http 当作别名，没有提到 streamableHttp 这种驼峰写法；在 Claude Code 里请改成 http。Cursor、Cherry Studio 等客户端照搬腾讯的样例即可，以客户端自己的文档为准。

{
  "mcpServers": {
    "yuanbao-websearch-mcp": {
      "type": "http",
      "url": "https://api.wsa.cloud.tencent.com/Mcp",
      "headers": {
        "Authorization": "Bearer ${WSA_API_KEY}"
      }
    },
    "everyinfra": {
      "type": "http",
      "url": "https://api.everyinfra.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EVERYINFRA_API_KEY}"
      }
    }
  }
}

挂上之后，第一件事是在客户端里跑一次 tools/list，看元宝搜索的 SearchPro 实际接受哪些参数。我们发现腾讯 MCP 页的两处写法不一致：页面上的参数表写的是 Query、Site、Mode、Freshness、Cnt、Industry，而同一页内嵌的工具定义里，时间过滤用的是 FromTime、ToTime 两个秒级时间戳，Mode 的类型也从整数变成了字符串。哪个是线上真实的，要以你自己连上后 tools/list 的返回为准；MCP Inspector 可以不写代码直接看两个服务器的工具定义。鉴权方面，两边都是静态 Bearer Key，不走 MCP 规范里的 OAuth 授权流程，Bearer 头的用法见 RFC 6750。

除了 MCP，元宝搜索还有一个 Skill 形态，发布在 SkillHub 的元宝搜索页面。按页面上的技能说明，它在执行前先检查环境变量 TENCENTCLOUD_WSA_APIKEY 有没有配置，没有就提示用户去控制台开通服务、创建 API KEY、到活动专区看免费额度；配置好之后在技能目录下运行 scripts/websearch.py，用 --query 传搜索词，可选 --site 限定站点。Skill 和 MCP 背后是同一个 SearchPro 接口，用的是同一把 Key，按报道也共用同一份免费额度，区别只在于由哪种客户端来调：支持 Skill 的 agent 框架直接装技能，支持 MCP 的客户端挂远程服务器。EveryInfra 这一侧同样有 MCP 和直接 HTTP 两种接法，两种接法的参数和价格完全相同。

自己写脚本直调 MCP 地址时，记得在初始化之后的每个请求里带 MCP-Protocol-Version 头，这是 2025-06-18 版新加的要求（变更说明）；腾讯 MCP 页写的协议版本「2025-6-18」就是规范的 2025-06-18 版，只是少写了一个零。用 Claude Code、Cursor 这类客户端时，这个头由客户端自动带上，不需要手动配置。

两个服务器挂在一起之后，agent 怎么分工，靠系统提示词里的一段路由规则。我们建议按「问题要的是什么」来分，而不是按平台名：

这张表的逻辑是：元宝搜索负责「有没有、是什么、出处在哪」，平台接口负责「多少人在说、说了什么、说了多久」。一个回答里两种来源都要标出处：网页结果标 url 和 date，平台结果标链接、点赞数和 posted_at，让读者能分辨哪句话来自新闻，哪句话来自用户。

网页搜索这一步也可以不用元宝搜索。EveryInfra 自己也有网页搜索能力 web/search，目录价每次 $0.001389，也就是每千次 $1.389（2026-11-06 读取）；元宝搜索标准版按腾讯云计费概述原文是每千次 20 元，按国家外汇管理局 2026-11-05 中间价 1 美元兑 6.7156 元折合约 $2.978，极速版 14 元约 $2.085。两者适合的场景不同。元宝搜索融合了腾讯新闻、搜狗百科、企鹅号这些腾讯内容源，有 Industry、Mode=1 的天气和金价卡片，标准版一次最多 50 条，还有每月的限时免费额度，适合中文新闻、百科、政策原文这类问题。web/search 一次最多 10 条，返回标题、链接、摘要、排名和发布时间，可选 country、language，和平台接口共用一把 Key、一份账单和同一个 MCP 服务器，适合不想再开腾讯云账号、或者问题不限于中文网页的 agent。这次我们没有真调 web/search，它的字段和价格按目录写。

不用 MCP：两条 curl 就能跑通

不想挂 MCP 的话，两边都可以直接用 HTTP 调。元宝搜索的 API KEY 方式只需要一个 Bearer 头，不用腾讯云 API 3.0 的签名（服务 API KEY 方式）；如果要用签名方式，腾讯云的 SDK 已经有 wsa 包，比如 Python 版的 wsa_client.py，字段模型在 models.py 里；其他语言在腾讯云 GitHub 的同名 SDK 仓库里，路径都带 wsa/v20250508，比如 Go 和 Node.js。下面第一条是元宝搜索的配置示例，我们没有运行；第二条是我们在 00:19:14（新加坡时间）真实发出的请求。

# 配置示例（未运行）：元宝搜索标准版，最近 7 天，20 条
curl -s https://api.wsa.cloud.tencent.com/SearchPro \
  -H "Authorization: Bearer $WSA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Query":"羽绒服 测评","Freshness":"d7","Cnt":20}'
# Pages 里每个元素是 JSON 字符串，要再 json.loads 一次

# 真实请求：EveryInfra 抖音搜索，最多点赞，近一周
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douyin","action":"search","params":{"keyword":"羽绒服 测评","sort":"most_liked","publish_time":"one_week"}}'
# 返回 count、results[]（like_count、comment_count、collect_count、share_count、posted_at…）和 billing.charged_usd

EveryInfra 的返回是一个普通 JSON 对象：results 是数组，每一行的字段就是目录里 response_fields 列出的那些；billing.charged_usd 是这次实际扣的美元数；pagination.has_more 告诉你还有没有下一页，有的话把 next_page_token 传回 page_token。慢的能力可以在请求体里加 "mode":"async"，立即拿到 202 和 job_id，再轮询 /api/v1/jobs/{job_id}，同步请求的时间上限是 85 秒。参数和价格可以先免费读目录，不扣费。

错误和计费：两边分别怎么算

两边的扣费规则写法不同，接 agent 之前最好先弄清楚，因为 agent 会重试。元宝搜索的计费页写「服务调用失败不计费」，错误码有六个：InternalError、InvalidParameter、RequestLimitExceeded、ResourceNotFound（服务未开通，开通后要几分钟生效）、ResourceUnavailable（多半是欠费）、UnauthorizedOperation（Key 错误或已删除）（SearchPro 接口文档、元宝搜索 MCP 页）。EveryInfra 这边，失败和空结果都不留扣费，参数写错在扣费之前就被拦下。

我们 00:19:57（新加坡时间）故意发的那次 sort=hot，返回的错误里写着 sort 只能是 most_liked、newest、relevance，did_you_mean 给的是 most_liked，next_steps 第一条是「只改 sort 再发，没有扣费」。这种错误信息是写给 agent 看的：模型拿到 422 以后能自己改参数重发，不需要人介入。429 的含义在 RFC 6585 里定义，正确做法是等一会再发，而不是立刻重试；这次撞上 429 的是小红书和抖音两次请求，返回里的 retry_after 分别是 8 秒和 1 秒，reason 是 key_limit，也就是这把测试 Key 自己每分钟 10 次的限额；重试逻辑按 retry_after 等待后重发即可，我们实际约 74 秒后重发，两次都正常返回。状态码的通用语义见 RFC 9110。

成本：每 1,000 个问题要多少钱

先看单价。按每千次调用算，元宝搜索标准版约 $2.978；EveryInfra 的网页搜索 web/search 是 $1.389；bilibili/search 是 $0.556，比元宝搜索便宜；xiaohongshu/search 是 $5.556，约是元宝搜索标准版的 1.9 倍；wechat_oa/article_search 是 $8.0；douyin/search 是 $8.333，约 2.8 倍。如果按「每千行结果」算，差别又不一样：这次小红书一次 19 行，每千行约 $0.2924；抖音一次 10 行，约 $0.8333；B 站一次 20 行，约 $0.0278；公众号一次 36 行，约 $0.2222。各平台的单价在价格页和对应的能力页上都能查到，比如小红书搜索、抖音搜索、B 站搜索。

再看组合。我们按三种做法算每 1,000 个问题的数据费：A 只用元宝搜索标准版，每个问题 1 次，$2.978；B 每个问题都把四个平台各查一次，再加 1 次元宝搜索，$25.423；C 每个问题查 1 次元宝搜索和 1 次 B 站，小红书只给 40% 的问题查，抖音和公众号各 20%，$9.023。C 里的 40% 和 20% 是我们假设的比例，不是测出来的，实际比例取决于你的问题有多少是「大家怎么说」类的。

如果一个月是 3,000 个问题，按做法 C 算：元宝搜索 3,000 次里 2,000 次在免费额度内，付费的 1,000 次约 $2.978；平台数据费是 3 × $6.045 = $18.135；合计约 $21.113。免费额度是限时的，不算它时，元宝搜索 3,000 次约 $8.934，合计约 $27.069；如果网页搜索换成 web/search，3,000 次是 $4.167，合计约 $22.302。可以看出，免费额度用完之前，成本几乎全在平台那一侧，省钱的关键是让 agent 少查抖音和公众号搜索这两个最贵的能力；B 站搜索便宜，可以每次都查。

和《DeepSeek Search API：平台内数据怎么补》有什么不同

站内 11 月 3 日的 DeepSeek Search API：平台内数据怎么补和本文的出发点相同：网页搜索接口不返回互动数，要另外补平台内数据。区别在三处。第一，对象不同：那篇讲的是 DeepSeek 10 月 17 日开放的 Search 和 Fetch，按成功请求每千次 5 元，用 OpenAI 兼容的函数调用把搜索和平台接口串起来；本文讲的是腾讯的元宝搜索，它的特点是融合了腾讯新闻、搜狗百科、企鹅号这些腾讯内容源，同时明说不收公众号，所以本文把公众号单独作为一节。第二，接法不同：那篇写的是四个函数定义和 tool_calls 循环，本文写的是两个远程 MCP 服务器并列挂载，不用写调度代码。第三，平台不同：那篇查的是小红书、知乎、微博，以图文和问答为主；本文查的是小红书、抖音、B 站和公众号，抖音和 B 站是视频，多了播放、弹幕、分享和作者粉丝数。

两篇可以一起读：如果你的 agent 用 DeepSeek 模型、想自己控制每一步，参考《DeepSeek Search API：平台内数据怎么补》的函数写法；如果你用 Claude Code、Cursor 这类支持 MCP 的客户端，参考本文的并列配置。两种搜索接口也可以都挂上，按价格和内容源分工。

做不了或要注意的地方

元宝搜索这一侧我们没有真调，所有关于它的描述都来自文档和报道，配置和请求都是「配置示例」。文档里有几处前后不一致：MCP 页的参数表和内嵌工具定义对时间过滤的写法不同；API KEY 方式示例里的图片字段叫 images，接口文档叫 pics；报道里召回率一处写 94%（快科技），一处写 93%（东方财富财富号）。接入时以你自己拿到的返回为准。免费额度是限时的，2,000 次和邀请码 6,000 次这两个数来自报道，腾讯云的计费页没有写，过了 11 月建议再核一次。

EveryInfra 这一侧，我们这次只查了一个话题，字段覆盖率和新鲜度是这一次的快照，不代表所有话题。小红书的商业合作标记和认证标记这次全是 false，抖音的 is_ad 全是空值，不能当成真实的广告比例。公众号阅读数 100001 很可能是「10万+」的下限。抖音搜索结果里的 view_count 是空值，要播放数得换别的能力。平台内数据是快照，同一条笔记的点赞数下一次调用会变，回答里要写清楚是哪个时间拿到的。

合规上，采集和使用公开数据要遵守所在地的规定。中国大陆的网络数据安全管理条例自 2025 年 1 月 1 日起施行，对网络数据处理活动提出了要求；如果你的 agent 面向中国大陆公众提供生成式服务，还要看生成式人工智能服务管理暂行办法和 2025 年 9 月 1 日起施行的人工智能生成合成内容标识办法。在回答里引用用户评论时，隐去个人昵称，只保留品牌和机构账号名，是一种稳妥的做法。

各平台也有自己的开放平台，但面向的场景和本文不同：小红书开放平台主要面向店铺和电商工具，抖音开放平台主要面向移动应用和网站接入抖音账号与能力，B 站开放平台主要面向 UP 主和服务商的内容分发与数据回流，微信开放文档里的公众号接口管理的是你自己的公众号。它们都不提供「按关键词搜全站公开笔记和视频」这类能力，想了解第三方接口和平台开放能力的差别，可以看站内的小红书 API 怎么选：官方平台、开源脚本、按次付费。

最近的变化

2026-10-09，「联网搜索API」更名为「元宝搜索」（产品动态）。对开发者的意义：搜旧名字的教程和 SDK 包名仍是 wsa，两个名字指的是同一个服务。

2026-10-17，DeepSeek 开放 Search 和 Fetch 接口，每千次成功请求 5 元（DeepSeek 更新说明、网页搜索与抓取文档）。对开发者的意义：国内网页搜索接口有了两个按次计费的选择，元宝搜索标准版的按量价是它的 4 倍，但有每月免费额度和腾讯内容源。

2026-10-20，元宝搜索通过腾讯云对外开放，每月 2,000 次免费（快科技）。对开发者的意义：给 agent 加中文网页搜索的门槛降到了「申请一把 Key」，限时免费额度适合先试。

2026-10-27，SearchPro 接口文档更新，Freshness 的写法和示例在这一版里（SearchPro 接口文档）。对开发者的意义：时间过滤参数还在变，MCP 工具定义要以 tools/list 为准。

2026-11-02，Claude Code 的 MCP 文档更新，写明 type 字段接受 streamable-http 作为 http 的别名（Claude Code MCP 文档）。对开发者的意义：照搬服务方的配置样例时，要核对 type 的拼写。

2026-11-04，腾讯云「AI 工具接入方式」页面更新，列出 MCP 接入、Skill 接入和用源码自行部署 MCP Server 三种方式（AI 工具接入方式）。对开发者的意义：不想把请求发到远程 MCP 地址的团队，可以自己部署一份 MCP Server。

同一段时间里，其他模型平台也把网页搜索做成了现成工具：Kimi 开放平台和智谱开放平台都有联网搜索工具的文档，Anthropic 的 web search 工具按每千次 $10 计费。对开发者的意义：网页搜索越来越容易拿到，但这些工具返回的也是网页，平台内的点赞、评论仍然要单独接。

常见问题

元宝搜索 api 免费吗，每月有多少次？

有限时免费额度。10 月 20 日的报道写每月 2,000 次，Skill、MCP、API 三种方式共用；10 月、11 月用邀请码每月最高 6,000 次。腾讯云计费页没有写免费额度，MCP 页让你去控制台的活动专区看规则。超出后按量每千次 14 元（极速版）、20 元（标准版）、26 元（旗舰版）。（问题来源：联想词「元宝搜索 免费吗」「元宝搜索 免费版」；依据：快科技、东方财富财富号、计费概述）

元宝搜索 mcp 怎么配置到 Claude Code 或 Cursor？

服务地址是 api.wsa.cloud.tencent.com/Mcp（HTTPS），请求头带 Authorization: Bearer 加你的元宝搜索 API KEY。Cursor 等客户端可以照搬腾讯 MCP 页的样例；Claude Code 要把 type 写成 http，腾讯样例里的 streamableHttp 不在 Claude Code 文档列出的取值里。配好后先跑一次 tools/list 看参数。（问题来源：联想词「腾讯 元宝 mcp」；依据：元宝搜索 MCP 页、Claude Code MCP 文档）

腾讯元宝 api 和元宝搜索 api 是一回事吗？

元宝搜索 API（产品代号 wsa）只做搜索：发一个查询词，返回网页结果的标题、链接、摘要、发布时间等，不生成回答。要让模型根据搜索结果作答，需要另外接一个对话模型，再把元宝搜索作为工具交给它。（问题来源：联想词「腾讯元宝api」「元宝 api」；依据：SearchPro 接口文档、产品概述）

小红书 api 一次能拿到多少笔记数据？

xiaohongshu/search 按页返回，每页 20 条，用 page_token 翻页，一次 $0.005556。我们这次按「最新 + 近 30 天」搜「羽绒服 测评」，一页拿到 19 条，每条带点赞、评论、收藏、发布时间。（问题来源：联想词「小红书 api 获取 笔记 数据量」；依据：小红书目录）

搜索引擎 api 有免费的吗？

元宝搜索目前有每月 2,000 次的限时免费额度；DeepSeek Search 按成功请求每千次 5 元，我们在它的文档里没有看到单独的搜索免费额度。EveryInfra 的目录和 MCP 的 tools/list 可以免费读，调用能力按次计费，失败和空结果不留扣费。（问题来源：联想词「搜索 引擎 api 免费」；依据：快科技、DeepSeek 网页搜索与抓取文档、B 站目录）

上手步骤

第一步，在 EveryInfra 快速上手创建 API Key，免费读一次目录，确认 xiaohongshu/search、douyin/search、bilibili/search、bilibili/comments 的参数和价格；平台总览在小红书爬虫、抖音爬虫、B 站爬虫三页，MCP 的接法在 MCP 服务器页。第二步，在腾讯云开通元宝搜索、创建 API KEY，把两把 Key 放进环境变量，把本文的 .mcp.json 复制到项目根目录。第三步，在系统提示词里写上「先网页、按需平台」的路由表，用一个问题跑通，再按月度问题量估算成本。想看同一类思路在 WorkBuddy 里怎么做，可以读 WorkBuddy 查小红书、抖音、京东数据：7 个连接器怎么用。

参考资料

1. 元宝搜索 产品概述，腾讯云文档，页面更新 2026-10-26，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/121794
2. 元宝搜索 计费概述，腾讯云文档，页面更新 2026-10-09，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/121798
3. 元宝搜索 退费说明，腾讯云文档，页面更新 2026-10-09，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/121801
4. 元宝搜索 产品动态，腾讯云文档，页面更新 2026-10-09，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/121792
5. 元宝搜索 常见问题，腾讯云文档，页面更新 2026-10-09，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/121804
6. 元宝搜索 SearchPro 接口，腾讯云 API 文档，页面更新 2026-10-27，2026-11-06 读取，https://cloud.tencent.com/document/api/1806/121811
7. 元宝搜索 服务 API KEY 方式，腾讯云文档，页面更新 2026-10-09，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/130615
8. 元宝搜索 AI 工具接入方式，腾讯云文档，页面更新 2026-11-04，2026-11-06 读取，https://cloud.tencent.com/document/product/1806/140541
9. 元宝搜索MCP，腾讯云开发者 MCP 广场，2026-11-06 读取，https://cloud.tencent.com/developer/mcp/server/11764
10. 元宝搜索 Skill，SkillHub，2026-11-06 读取，https://skillhub.cn/skills/tencent-yuanbao-standard-search
11. tencentcloud-sdk-python wsa_client.py，TencentCloud（GitHub），2026-11-06 读取，https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/wsa_client.py
12. tencentcloud-sdk-python wsa models.py，TencentCloud（GitHub），2026-11-06 读取，https://github.com/TencentCloud/tencentcloud-sdk-python/blob/master/tencentcloud/wsa/v20250508/models.py
13. 腾讯宣布元宝搜索正式对外开放！千亿级索引 每月2000次免费调用，快科技，2026-10-20，https://news.mydrivers.com/1/1158/1158971.htm
14. 腾讯全新升级元宝搜索 通过腾讯云对外开放服务，快科技，2026-10-20，https://news.mydrivers.com/1/1159/1159052.htm
15. 腾讯元宝搜索正式对外开放：日均调用数亿次，接入超50个腾讯业务，凤凰网科技，2026-10-20，https://tech.ifeng.com/c/8xNUpH50e2g
16. 腾讯云全面开放元宝搜索API服务，东方财富财富号，2026-10-22，https://caifuhao.eastmoney.com/news/20261022114426222792250
17. 腾讯云宣布「元宝搜索」正式对外开放，知乎专栏，2026-11-06 读取，https://zhuanlan.zhihu.com/p/2096309245318787504
18. DeepSeek 更新说明（2026-10-17），DeepSeek API 文档，2026-11-06 读取，https://api-docs.deepseek.com/zh-cn/news/news261017
19. 网页搜索与抓取，DeepSeek API 文档，2026-11-06 读取，https://api-docs.deepseek.com/zh-cn/guides/search
20. robots.txt，小红书，2026-11-06 00:23 新加坡时间读取，https://www.xiaohongshu.com/robots.txt
21. robots.txt，抖音，2026-11-06 00:23 新加坡时间读取，https://www.douyin.com/robots.txt
22. robots.txt，哔哩哔哩，2026-11-06 00:23 新加坡时间读取，https://www.bilibili.com/robots.txt
23. robots.txt，微信公众平台，2026-11-06 00:23 新加坡时间读取，https://mp.weixin.qq.com/robots.txt
24. 人民币汇率中间价，国家外汇管理局，2026-11-05 数据，https://www.safe.gov.cn/safe/rmbhlzjj/index.html
25. 网络数据安全管理条例，中国政府网，2024-09-30 公布，https://www.gov.cn/zhengce/content/202409/content_6977766.htm
26. 生成式人工智能服务管理暂行办法，中央网信办，2023-07-13，https://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm
27. 人工智能生成合成内容标识办法，中央网信办，2025-03-14，https://www.cac.gov.cn/2025-03/14/c_1743654684782215.htm
28. RFC 9309: Robots Exclusion Protocol，RFC Editor，2022-09，https://www.rfc-editor.org/rfc/rfc9309.html
29. Transports（2025-06-18），Model Context Protocol 规范，2026-11-06 读取，https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
30. Lifecycle（2025-06-18），Model Context Protocol 规范，2026-11-06 读取，https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
31. Tools（2025-06-18），Model Context Protocol 规范，2026-11-06 读取，https://modelcontextprotocol.io/specification/2025-06-18/server/tools
32. Authorization（2025-06-18），Model Context Protocol 规范，2026-11-06 读取，https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization
33. MCP Inspector，modelcontextprotocol（GitHub），2026-11-06 读取，https://github.com/modelcontextprotocol/inspector
34. Connect Claude Code to tools via MCP，Claude Code 文档，页面更新 2026-11-02，https://code.claude.com/docs/en/mcp
35. 小红书开放平台，小红书，2026-11-06 读取，https://open.xiaohongshu.com/
36. 哔哩哔哩开放平台，哔哩哔哩，2026-11-06 读取，https://open.bilibili.com/
37. 抖音开放平台概述，抖音开放平台，2026-11-06 读取，https://developer.open-douyin.com/docs/resource/zh-CN/dop/overview/introduction
38. 微信开放文档，微信，2026-11-06 读取，https://developers.weixin.qq.com/doc/
39. RFC 6585: Additional HTTP Status Codes，RFC Editor，2012-04，https://www.rfc-editor.org/rfc/rfc6585.html
40. RFC 6750: OAuth 2.0 Bearer Token Usage，RFC Editor，2012-10，https://www.rfc-editor.org/rfc/rfc6750.html
41. RFC 9110: HTTP Semantics，RFC Editor，2022-06，https://www.rfc-editor.org/rfc/rfc9110.html
42. 小红书能力目录，EveryInfra API，2026-11-06 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu
43. 抖音能力目录，EveryInfra API，2026-11-06 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
44. 哔哩哔哩能力目录，EveryInfra API，2026-11-06 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili
45. 公众号能力目录，EveryInfra API，2026-11-06 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa
46. 网页搜索能力目录，EveryInfra API，2026-11-06 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=web
47. Key Changes（2025-06-18），Model Context Protocol 规范，2026-11-06 读取，https://modelcontextprotocol.io/specification/2025-06-18/changelog
48. tencentcloud-sdk-go wsa client.go，TencentCloud（GitHub），2026-11-06 读取，https://github.com/TencentCloud/tencentcloud-sdk-go/blob/master/tencentcloud/wsa/v20250508/client.go
49. tencentcloud-sdk-nodejs wsa_client.ts，TencentCloud（GitHub），2026-11-06 读取，https://github.com/TencentCloud/tencentcloud-sdk-nodejs/blob/master/src/services/wsa/v20250508/wsa_client.ts
50. Web search tool，Claude 文档，2026-11-06 读取，https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool
51. 使用联网搜索，Kimi 开放平台文档，2026-11-06 读取，https://platform.moonshot.cn/docs/guide/use-web-search
52. 网络搜索，智谱开放平台文档，2026-11-06 读取，https://docs.bigmodel.cn/cn/guide/tools/web-search