用途：把用户问题作为查询提交给豆包联网检索，服务端实时搜集、阅读并整合资料，返回综合答案、引用来源链接和延伸建议。适合联网查最新信息、带来源的事实核查、快速调研和找资料来源。
主要能力：单次调用返回 result.content（答案正文）、result.references[]（标题与URL来源列表）、result.suggestions[]（延伸问题）。无需自建检索链路，按次消费。
使用方式：先提炼清晰具体的查询；然后调用脚本，例如 python3 "$SKILL_PATH/scripts/doubao_search.py" "2025 年 AI Agent 落地有哪些代表案例"。脚本先在 stderr 提示已提交，等待约5分钟后把结果以JSON打到 stdout。每个查询只运行一次，不要中途打断或重复调用。渲染时按防御式读取字段：缺失即跳过，建议排版为先答案、再来源列表、最后延伸建议。
鉴权与接口：密钥来自 doubaoya.com 密钥中心，配置环境变量 export DOUBAOYA_API_KEY="dyh_你的密钥"。接口为 POST https://doubaoya.com/api/skills/doubao-web-search/invoke，鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY，请求体 { "query": "<查询>" }。返回信封含 success、requestId、data、error；success 为 true 才读 data，否则读 error.code 与 error.message。
限制与错误处理：检索为异步慢操作，单次请求内等待约5分钟返回，无需轮询。401 表示密钥缺失或无效，400 为参数不合法，402 为额度不足需充值，502 为上游临时故障且已自动退款，重试安全不会重复扣费。若返回顶层 notice 字段，需原样转达用户，不影响本次结果。密钥绝不打印、不写入文件、不回显给用户；所有请求只发往 doubaoya.com。