# 豆包搜索 > 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。 豆包搜索是面向大模型构建的搜索服务，通过灵活 API 形式提供多垂类、多信源搜索能力，用于补充模型训练数据截止后的最新事实、核验信息出处、获取时效性内容，提升大模型回答的知识面和可信度。 > **注意** > > 2026年6月22日，Agent Plan 产品中的联网搜索（Beta版）服务正式升级为豆包搜索服务。建议已接入联网搜索（Beta版）的企业用户迁移至豆包搜索。 # 能力介绍 豆包搜索支持的核心能力如下，详情参见 [豆包搜索 API 文档](https://docs.volcengine.com/docs/87772/2272953?lang=zh)。 - **网页搜索**：返回标题、来源站点、URL、摘要、正文等结构化字段，单次最多 50 条。 - **多模态搜索**：对文本 query 返回图片内容（包括图片标题、URL、尺寸与形状）。 - **权威来源过滤**：可限定返回可信度高的各类官方站点内容。 - **时间范围筛选**：支持近一天/周/月/年的快捷枚举，或自定义日期区间。 - **Query 改写**：对口语化长问题自动改写为搜索式 query，提升召回。 # 使用豆包搜索 > **注意** > > * 使用联网搜索（Beta版）的用户：可继续使用原 API Key 进行接入鉴权，但无法使用套餐内 AFP 进行抵扣。建议迁移至豆包搜索。 > * 使用豆包搜索的用户：使用 Agent Plan 企业版专属 API Key 调用搜索服务，支持使用套餐内 AFP 进行抵扣。 ## 步骤一：订阅套餐并开通豆包搜索 1. 管理员在 [Agent Plan 企业版](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close) 购买套餐并为用户分配席位。套餐说明参见[套餐概览](/docs/agent-plan-enterprise-plan-overview)。 2. 管理员需要在**Harness 管理**页签，开启豆包搜索的允许抵扣开关。 ![开启豆包搜索允许抵扣开关](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/agent-plan-enterprise-allow-deduction.png) 3. 席位用户在Harness区域，打开开启抵扣的开关。 4. 席位用户获取用于接入豆包搜索的专属 API Key，用于在工具中完成 Skill 或 MCP 的配置。 ![image-20260909-103103-932.png](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/agent-plan-enterprise-api-key.png) ## 步骤二：在工具中使用豆包搜索 目前支持通过 MCP Server 或 Skill 两种方式在工具中使用豆包搜索。具体接入方式参见 [AI 工具接入指南](https://docs.volcengine.com/docs/87772/2297384?lang=zh)。 **前置准备**：已安装 Python 3.12+、uv。其中 uv 安装命令如下： * macOS / Linux ```Bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` * Windows ```Bash powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ``` ### Skill 接入方式 通过 Skill 方式为 AI 工具快速安装并接入豆包搜索能力。以下为常用 AI 工具的配置方案，其他工具可按需选择通过命令安装或通过对话安装方式完成豆包搜索 Skill 的安装并使用。 **选项：Claude Code** 1. 安装并配置 Claude Code，具体步骤见 [Claude Code](/docs/agent-plan-enterprise-claude-code)。 2. 在终端执行以下命令为 Claude Code 安装并接入豆包搜索 Skill `byted-web-search`。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent claude-code ``` 3. 安装完成后，执行`claude`命令启动 Claude Code。 4. 通过对话方式提供 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise) 完成 Skill 的配置。 5. 配置完成后，可以在 Claude Code 中使用豆包搜索能力。 ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/611ce1c992e94311b8bf81238199348f~tplv-goo7wpa0wc-image.image) **选项：OpenCode** 1. 安装并配置 OpenCode，具体步骤见 [OpenCode](/docs/agent-plan-enterprise-opencode)。 2. 在终端执行以下命令为 OpenCode 安装并接入豆包搜索 Skill `byted-web-search`。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent opencode ``` 3. 安装完成后，执行`opencode`命令启动 OpenCode。 4. 通过对话方式提供 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise) 完成 Skill 的配置。 5. 配置完成后，可以在 OpenCode 中使用豆包搜索能力。 ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e0bda1f82fc641c5887dc89e5ad9e2b5~tplv-goo7wpa0wc-image.image) **选项：OpenClaw** 1. 安装并配置 OpenClaw，具体步骤见 [OpenClaw](/docs/agent-plan-enterprise-openclaw)。 2. 在终端执行以下命令为 OpenClaw 安装并接入豆包搜索 Skill `byted-web-search`。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent openclaw ``` 3. 安装完成后，执行以下命令启动 OpenClaw。 ```Bash openclaw tui ``` 4. 在对话框中输入 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise) ，完成 Skill 配置。 5. Skill 配置完成后可以在 OpenClaw 中使用豆包搜索能力。 ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e4639c0deaf9464d9cefd607bb3c546c~tplv-goo7wpa0wc-image.image) **选项：Hermes Agent** 1. 安装并配置 Hermes Agent，具体步骤见 [Hermes Agent](/docs/agent-plan-enterprise-hermes-agent)。 2. 在终端执行以下命令为 Hermes Agent 安装并接入豆包搜索 Skill `byted-web-search`。 ```Bash npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search --agent hermes-agent ``` 3. 安装完成后，启动 Hermes Agent。 4. 在对话框中输入 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise) 完成 Skill 的配置。 5. 配置完成后，可以在 Hermes Agent 中使用豆包搜索能力。 ![hermes-searching.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/hermes-searching.png) ### MCP 接入方式 以下为常用 AI 工具的 MCP 接入方案，其他工具可通过对话方式让模型完成 MCP 的接入。将配置中的 `` 替换为 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise)。 **选项：Claude Code** 1. 安装并配置 Claude Code，具体步骤见 [Claude Code](/docs/agent-plan-enterprise-claude-code)。 2. 编辑配置文件`~/.claude.json`，添加 MCP 配置。其中``需替换为 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise)。 ```JSON { ... "mcpServers": { "mcp-server-askecho-search-infinity": { "command": "uvx", "args": [ "--from", "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity", "mcp-server-askecho-search-infinity" ], "env": { "ASK_ECHO_SEARCH_INFINITY_API_KEY": "" } } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 3. 在终端执行`claude`命令启动 Claude 服务后，输入`/mcp`后看到`mcp-server-askecho-search-infinity`，说明配置成功。 ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/fe05e350de7743f7be11077cb906d6a3~tplv-goo7wpa0wc-image.image) 4. MCP 安装完成后即可使用豆包搜索能力。 **选项：OpenCode** 1. 安装并配置 OpenCode，具体步骤见 [OpenCode](/docs/agent-plan-enterprise-opencode)。 2. 编辑配置文件`~/.config/opencode/opencode.json`，添加 MCP 配置，并将``替换为 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise)。 ```JSON { ... "mcp": { "mcp-server-askecho-search-infinity": { "type": "local", "enabled": true, "command": ["uvx", "--from", "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity", "mcp-server-askecho-search-infinity"], "environment": { "ASK_ECHO_SEARCH_INFINITY_API_KEY": "" } } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 3. 在终端执行`opencode`命令启动 OpenCode 服务后，输入`/mcp`后看到`mcp-server-askecho-search-infinity`状态为 Enabled，说明配置成功。 ![](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2aaee036e20b472bb5ad01e426d407d0~tplv-goo7wpa0wc-image.image) 4. MCP 安装完成后即可使用豆包搜索能力。 **选项：OpenClaw** 1. 安装并配置 OpenClaw，具体步骤见 [OpenClaw](/docs/agent-plan-enterprise-openclaw)。 2. 在终端执行如下命令安装 MCPorter。 ```Bash npm install -g mcporter ``` 3. 编辑配置文件`~/.openclaw/openclaw.json`，添加 MCP 配置，并将``替换为 [Agent Plan 企业版的专属 API Key](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenModelVisible=false&advancedActiveKey=agentEnterprise)。 ```JSON { ... "mcp": { "servers": { "mcp-server-askecho-search-infinity": { "command": "uvx", "args": [ "--from", "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity", "mcp-server-askecho-search-infinity" ], "env": { "ASK_ECHO_SEARCH_INFINITY_API_KEY": "" } } } }, "skills": { "entries": { "mcporter": { "enabled": true } } } ... } ``` > **说明** > > 配置保存后，建议使用在线 JSON 验证工具或本地命令检查 JSON 格式是否合法。 4. 在终端执行如下命令使配置生效。 ```Bash openclaw gateway restart ``` 5. 在项目目录下，执行如下命令查看已安装的 `mcp-server-askecho-search-infinity` MCP。 ```Bash mcporter list ``` 6. 启动 OpenClaw 后，即可使用豆包搜索能力。 # 用户权益 ## 使用联网搜索（Beta版）的用户权益 2026年7月1日起，联网搜索（Beta版）的限时免费权益活动结束，每月免费额度发生变更。 - 变更前：根据下单的 Agent Plan 企业版套餐类型发放每月免费额度（按席位计数）。套餐到期时，下单附赠的免费搜索额度也将回收。 - Team Small：每个席位每月赠送 50 次免费搜索额度。 - Team Medium：每个席位每月赠送 300 次免费搜索额度。 - Team Large：每个席位每月赠送 800 次免费搜索额度。 - Team Max：每个席位每月赠送 1800 次免费搜索额度。 - 变更后：以火山引擎主账号 ID 维度，每月发放 500 次免费额度（每月1日重置），免费额度不专属于 Agent Plan 获取的搜索 API Key 调用，在火山引擎的所有开通方式下都会被优先消耗。 ## 使用豆包搜索的用户权益 以火山引擎主账号 ID 维度，每月发放 500 次免费额度（每月1日重置），免费额度不专属于 Agent Plan 获取的 API Key 调用，在火山引擎的所有开通方式下都会被优先消耗。 # 常见问题 * 如何关闭豆包搜索服务？ 豆包搜索是按量后付费型产品，当前官网无法主动关停服务。如有关停需求可提交 [工单申请](https://console.volcengine.com/workorder/create?step=1&SubProductID=P00001696)。 * 如何查看豆包搜索付费用量统计？ 可以在 [豆包搜索控制台数据管理](https://console.volcengine.com/search-infinity/web-search-interface) 查看豆包搜索付费用量信息。 * 豆包搜索和联网内容插件有什么区别？ 豆包搜索和联网内容插件的区别请参见 [豆包搜索产品简介](https://docs.volcengine.com/docs/87772/2272949?lang=zh)。 # 服务协议 * [豆包搜索专用条款](https://docs.volcengine.com/docs/87772/2272947?lang=zh) * [豆包搜索服务等级协议](https://docs.volcengine.com/docs/87772/2272948?lang=zh) * [Harness 能力说明和产品专用条款](/docs/harness-rules)