用途：通过火山引擎（字节跳动）融合信息搜索 API，为智能体提供网页搜索、图片搜索和 AI 搜索结果摘要能力，返回带丰富元数据的结构化结果。
主要能力：
- 网页搜索：可按时间范围（OneDay、OneWeek、OneMonth、OneYear 或自定义日期）、指定或屏蔽域名、权威等级（如仅高权威来源）过滤；获取内容片段、摘要或全文；支持查询改写与金融、游戏等行业化搜索。
- 带 AI 摘要的网页搜索：在网页搜索基础上生成 AI 内容摘要，并提供 Token 用量统计，支持流式或非流式响应。
- 图片搜索：按宽高范围与形状（横长方形、竖长方形、正方形）过滤，返回尺寸、URL、发布时间等元数据。
- 火山如意卡片数据：天气与空气质量、股票与金融数据、汇率与贵金属、节假日日历、火车/航班时刻、演唱会信息等，从 CardResults 字段提取。
使用方式：先在火山引擎控制台 https://console.volcengine.com/ask-echo/api-key 的“融合信息搜索”创建 API Key，并通过环境变量 VOLCENGINE_API_KEY 保存。简单搜索可直接运行命令行：python scripts/volcengine_search.py YOUR_API_KEY web "搜索关键词"；摘要用 summary 子命令，图片用 image 子命令。程序化集成可导入 scripts/volcengine_search.py 中的 VolcengineSearchClient 类。输出为 JSON。
限制：查询长度 1-100 字符；网页搜索单次最多 50 条结果，图片搜索最多 5 条；默认限速 5 QPS；网页搜索与摘要各有 5000 次免费额度；域名过滤最多 5 个。错误处理：403 检查密钥与权限，429 为超限，空结果可尝试启用 query_rewrite 或放宽过滤。其他参数细节与卡片结构见 references/api_reference.md。