huashu-doubao-search

「你给 Claude Code 换上了国产模型，然后发现它不会上网了」

一条命令，让你的 Agent 用上豆包搜索：字节系独家信源、千字级正文摘要、发布时间精确到秒，每月 500 次免费。

豆包搜索是火山引擎为 AI Agent 构建的联网信息服务，2026 年 7 月起面向企业和开发者开放。

为什么需要它 · 效果 · 安装 · 工具参数 · AI 增强层

English

为什么需要它

Claude Code 内置的 WebSearch 是 Anthropic 的服务端工具，跑在 Anthropic 的服务器上。一旦你把 ANTHROPIC_BASE_URL 指向国产模型的兼容端点（豆包 Seed、Kimi、GLM、DeepSeek……），WebSearch 就没了执行器：工具看着还在，agent 实际上断网了。很多人是切完模型才发现这件事。

海外搜索 API 能补上这个缺口，但对中文开发者有三个现实问题：美元结算（有的还强制绑信用卡）、Google 系索引搜不到中文生态内容、国内直连不稳定。

豆包搜索正好把这三个问题一起解决了，这个 MCP server 把它变成任何 agent 一条命令就能装上的搜索工具。

效果

以下是真实返回（工具调用一次的原始输出节选）：

共 20 条结果，返回前 10 条：

[1] "一人公司"与"手搓经济"，两个新词寓春意-新华网
来源: 新华网 | 2026-03-19T09:00:22+08:00
URL: http://www.xinhuanet.com/tech/20260319/259b0a6eb28c...
当AI技术高歌猛进，"机器换人"的焦虑如影随形。近期走红的"一人公司"与
"手搓经济"两个新词，则为我们揭示了技术进步的另一面……（千字级正文摘要）

几个实测过的细节：

• 千字级正文摘要，不是两行摘要加一堆蓝链接。别家要「搜索 API + 抓取 API」两跳才能凑齐的链路，它一次返回

• 发布时间精确到秒，agent 自己就能判断信息新鲜度。实测查行业热点，返回过发布时间是「查询前一晚」的文章

• 字节系独家信源：今日头条正文高频返回；查「XX 是什么」「XX 是谁」这类实体问题，抖音百科基本排第一

• 每条结果自带正文 token 计数（ContentTokenCount），你可以精确控制塞进上下文的量——这个字段暴露了它确实是为 Agent 设计的

• 跨语言：英文查询返回官方文档、changelog 这类一手信源，不用中英文各配一个搜索

安装

第一步：拿一个 API Key

去 火山引擎豆包搜索控制台 开通服务并创建 API Key。每月 500 次搜索免费，超出按量付费。

第二步：加进你的 Agent

Claude Code（一条命令）：

claude mcp add huashu-doubao-search \
  -e DOUBAO_SEARCH_API_KEY=你的Key \
  -- npx -y github:alchaincyf/huashu-doubao-search

加 --scope user 则所有项目可用。

Cursor / Codex / 其他 MCP client（配置文件）：

{
  "mcpServers": {
    "huashu-doubao-search": {
      "command": "npx",
      "args": ["-y", "github:alchaincyf/huashu-doubao-search"],
      "env": {
        "DOUBAO_SEARCH_API_KEY": "你的Key"
      }
    }
  }
}

最省事的方式：把这个仓库链接直接丢给你的 agent，说一句：

帮我安装这个 MCP：https://github.com/alchaincyf/huashu-doubao-search

第三步（可选）：选一个搜索版本

豆包搜索开放了 global 和 custom 两个版本，同一个 API Key 都能调，每月 500 次免费额度两版共用。不配也能用，默认走 global。

想搞清楚该选哪个，跑一次交互式向导，它会介绍差异并给出配置命令：

npx -y github:alchaincyf/huashu-doubao-search setup

或者直接在 env 里加一行 DOUBAO_SEARCH_VERSION=global（或 custom）。装好之后，单次搜索传 version 参数还能临时切换，也可以让 agent 调 doubao_search_versions 工具随时查两版对比。

两个版本怎么选

一句话：默认 global 就行，它保住了 token 预算能力（max_tokens 压缩依赖 ContentTokenCount，这个字段只有 global 有）；做政策、医疗、财报这类需要严格控信源的调研，或者想让正文给得更全、想买包月，就切 custom。

从源码安装

git clone https://github.com/alchaincyf/huashu-doubao-search.git
cd huashu-doubao-search
npm install && npm run build
claude mcp add huashu-doubao-search \
  -e DOUBAO_SEARCH_API_KEY=你的Key \
  -- node /绝对路径/huashu-doubao-search/dist/index.js

工具参数

装好后 agent 多出一个 doubao_search 工具：

另有一个 doubao_search_versions 工具，让 agent 随时能查两个版本的完整对比和当前配置。

可选：AI 增强层

搜索结果拿回来之后，还可以让一个便宜的小模型再加工一道。这层是可选项，不是默认行为，三层开关都在你手里：

1. 不配 ARK_API_KEY，这层完全不存在，行为和纯搜索版一模一样，连参数都不会出现在工具里

2. 配了 key，增强能力才注册进来，但每次调用仍然是原始结果直出

3. 只有 agent 显式传 max_tokens 参数、或点名调用 doubao_cross_check 工具时，AI 加工才真正发生

加工层只做筛选和压缩，不做理解和结论——来源名、发布时间、URL 一律保留，判断留给你的主模型。

开启方式

在安装命令里多加两个环境变量（方舟控制台 创建 API Key）：

claude mcp add huashu-doubao-search \
  -e DOUBAO_SEARCH_API_KEY=你的搜索Key \
  -e ARK_API_KEY=你的方舟Key \
  -- npx -y github:alchaincyf/huashu-doubao-search

默认用 doubao-seed-2-0-lite-260215（Seed 2.0 Lite，输入 0.6 元/百万 token，一次加工的成本约等于零），可用 ARK_MODEL 换模型、ARK_BASE_URL 换端点。

能力一：token 预算器（doubao_search 的 max_tokens 参数）

搜索 API 每条结果自带 ContentTokenCount，这个参数把它用起来：传 max_tokens: 800，10 条千字级结果就被压缩筛选到约 800 token 再进你的上下文——不相关的剔掉，留下的每条保留来源、时间、URL 和原文关键句。搜索工具最常见的翻车是「一次返回撑爆上下文」，这个参数就是给上下文预算装的阀门。AI 加工失败时自动降级为原始结果，搜索永远不会因为加工层挂掉。

能力二：多信源交叉核查（doubao_cross_check 工具）

给一个问题或一句待核实的说法，它在一次调用里完成：从不同角度生成 3-4 路搜索词（事实本身/最新进展/官方口径/相反说法）→ 并行搜索、按 URL 去重 → 逐信源比对，输出结构化报告：核查结论、信源共识、信源分歧（各方说法+发布时间）、信源清单、时效提示。硬规则是只用搜到的内容、不引入模型自己的知识，信源不够就明说无法确认。

这是个重工具（多路搜索 + 两次 LLM 调用，几十秒），适合核实传闻、信源打架的突发新闻、任何值得多方求证的事实。日常搜索请继续用 doubao_search。

背后的故事

我天天泡在 Claude Code 里干活，也经常把国产模型接进来当主力。撞到搜索断网这堵墙之后查了一圈，现有方案对中文开发者各有各的别扭：美元结算、中文内容搜不到、国内连接不稳。

正好豆包搜索在 7 月对开发者开放了。我开通后先自己测了一轮：返回结构里那个 token 计数字段让我确认这个 API 值得包一层 MCP——它不是把「给人看的搜索结果」转给 agent，是从设计上就在替 agent 的上下文预算着想。于是有了这个仓库。

关于作者

花叔 Huashu — AI Native Coder，独立开发者，代表作：小猫补光灯（AppStore 付费榜 Top1）

许可证

MIT — 随便用，随便改，随便造。

女娲.skill — 蒸馏任何人的思维方式 · 达尔文.skill — 让 Skill 无限进化 · huashu-design — HTML 原生设计 skill

English

"You switched Claude Code to a Chinese LLM — and it can't browse the web anymore."

Claude Code's built-in WebSearch is an Anthropic server-side tool. Point ANTHROPIC_BASE_URL at any Anthropic-compatible endpoint (Doubao Seed, Kimi, GLM, DeepSeek...) and your agent silently goes offline.

huashu-doubao-search plugs that gap with Doubao Search — the search API Volcengine built for AI agents, now open to developers with 500 free searches/month:

• Long-form snippets (up to 2000 chars of article body per result) — consumable directly, no second crawl needed

• Publish time down to the second + source name on every result

• Exclusive ByteDance sources: Toutiao articles, Douyin Baike (top-ranked for entity lookups)

• Cross-language: English queries return first-party sources (official docs, changelogs)

• ContentTokenCount per result — budget your context window precisely

Install (Claude Code):

claude mcp add huashu-doubao-search \
  -e DOUBAO_SEARCH_API_KEY=your-key \
  -- npx -y github:alchaincyf/huashu-doubao-search

Or add the JSON config above to any MCP client. Tool: doubao_search(query, count, snippet_length, images, max_age_days).

Optional AI layer (strictly opt-in — without ARK_API_KEY the server behaves exactly like the plain version): set ARK_API_KEY (Volcengine Ark) to unlock a max_tokens context-budget compressor on doubao_search (filter + compress only, sources/URLs/timestamps preserved, no conclusions added) and a doubao_cross_check tool (fans out 3-4 query angles, dedupes sources, returns a structured report: verdict / consensus / discrepancies / source list / freshness caveat). Powered by Doubao Seed 2.0 Lite by default (ARK_MODEL to override).

MIT License © 花叔 Huashu