豆包WebSearch

这是基于红狐API的豆包联网搜索工具，核心功能含异步提交搜索、自动轮询结果、实时进度反馈、结构化输出及多场景异常处理。适用于需获取联网实时信息、AI辅助检索的场景，输入搜索关键词，输出含豆包回答文本和引用来源的JSON结果，需配置红狐API Key使用。

热度 16.02

最近更新 2026-06-24 14:19:42

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add doubao-websearch

Metadata

name: doubao-websearch
description: 豆包 WebSearch 搜索工具。基于红狐 API 调用豆包联网搜索能力，提交查询后自动轮询等待结果返回。当用户需要使用豆包搜索、联网搜索、AI 搜索获取实时信息时使用。触发词：豆包搜索、豆包websearch、联网搜索、AI搜索、doubao搜索。

通过红狐 API 调用豆包联网搜索能力，提交查询后自动轮询等待结果返回。适用于需要联网实时搜索、AI 辅助信息检索的场景。

功能模块	能力描述	核心价值
异步提交	提交搜索关键词到豆包 WebSearch，返回 taskId	无需等待，立即获取任务标识
自动轮询	每 5 秒查询任务状态，最多等待 5 分钟	自动等待结果，无需手动查询
进度反馈	轮询期间通过 stderr 实时输出等待状态	用户可知搜索进度
结果输出	状态变为 completed 后输出完整 JSON	结构化数据便于 Agent 解析展示
异常处理	覆盖 API Key 缺失、提交失败、超时、任务失败四种场景	每种异常有明确提示和处理

前往红狐hub 获取 API Key，通过以下方式配置：

# 方式一：配置文件（如 OpenClaw 的 ~/.openclaw/openclaw.json）
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

# 方式二：终端环境变量
export REDFOX_API_KEY="ak_xxxx..."

从用户自然语言描述中提取搜索意图和关键词，作为 inquiry_text 传入。

python3 ~/.agents/skills/doubao-websearch/scripts/doubao_search.py "<搜索关键词>"

脚本自动完成：

提交搜索：POST /story/api/doubaoSearch/submit，传入 {"inquiry_text": "...", "source": "豆包websearch-ClawHub"}
轮询结果：每 5 秒 POST /story/api/doubaoSearch/result 查询一次，直到状态为 completed
实时反馈：轮询期间通过 stderr 输出等待提示
最终输出：状态 completed 后输出完整 JSON 结果到 stdout

脚本返回 JSON 后，提取 data.content 中的豆包回答文本和 data.result 中的引用来源，结构化整理后向用户展示。

pip3 install requests