百度 AI 搜索
百度 AI 搜索技能，提供智能搜索、百科查询、热榜获取等功能。
快速开始
推荐方式：智能调度器（自动选最优 API）
# 自动选择最佳 API（推荐）
python3 skills/zhisou/scripts/smart_search.py '<搜索关键词>'
# 示例
python3 skills/zhisou/scripts/smart_search.py '最新科技新闻'
python3 skills/zhisou/scripts/smart_search.py '量子计算是什么'
强制使用指定 API
python3 smart_search.py '<query>' --force chat_completions # 深度智能搜索
python3 smart_search.py '<query>' --force smart_search_pro # 高性能版
python3 smart_search.py '<query>' --force smart_search # 普通搜索
python3 smart_search.py '<query>' --force baike_content # 百科详情
python3 smart_search.py '<query>' --force baike_search # 百科搜索
python3 smart_search.py '<query>' --force zhihu # 知乎热榜
python3 smart_search.py '<query>' --force weibo # 微博热榜
python3 smart_search.py '<query>' --force xhs # 小红书热榜
python3 smart_search.py '<query>' --force bilibili # B站热榜
API 完整列表
搜索类
| API | 端点 | 配额/天 |
|---|
| ----- | ------ | --------- |
| 深度智能搜索 | /v2/ai_search/chat/completions | 100次 |
| 高性能版 | /v2/ai_search/web_summary | 100次 |
| 百度搜索 | /v2/ai_search/web_search | 50次 |
百科类
| API | 端点 | 配额/天 | 说明 |
|---|
| ----- | ------ | --------- | ------ |
| baike_content | /v2/baike/lemma/get_content | 50 | 词条详情（刘德华） |
| baike_search | /v2/baike/lemma/get_list_by_title | 50 | 词条搜索（刘德华→多条结果） |
热榜类
| API | type | 配额/天 | 说明 |
|---|
| ----- | ------ | --------- | ------ |
| weibo | 2 | 1 | 微博热榜 |
| toutiao | 3 | 1 | 头条热榜 |
| zhihu | 7 | 1 | 知乎热榜 |
| douyin | 6 | 1 | 抖音热榜 |
| bilibili | 8 | 1 | B站热榜 |
| baidu | 4 | 1 | 百度热榜 |
| tieba | 9 | 1 | 贴吧热议榜 |
| kuaishou | 10 | 1 | 快手热榜 |
| xhs | 14 | 1 | 小红书热榜 |
调度优先级
1. chat_completions (100次/天) ← 最强深度搜索
2. web_summary (100次/天) ← 高性能版 AI 总结
3. web_search (50次/天) ← 普通搜索结果
4. 兜底
调度器会自动按优先级尝试，直到成功或全部失败。
热榜查询（独立脚本）
通用热榜
python3 skills/zhisou/scripts/trending.py <platform>
# 平台: douyin, weibo, zhihu, bilibili, xhs, baidu, kuaishou, toutiao, tieba
垂类热榜（每天8次）
python3 skills/zhisou/scripts/trending.py vertical <category> [platform]
# 示例: python3 trending.py vertical 汽车
百度热搜（每天10次）
# 默认民生
python3 skills/zhisou/scripts/trending.py baidu
# 指定分类
python3 skills/zhisou/scripts/trending.py baidu livelihood # 民生
python3 skills/zhisou/scripts/trending.py baidu finance # 财经
python3 skills/zhisou/scripts/trending.py baidu tech # 科技
# 其他: society, entertainment, sports, food, car, game, edu
配额管理
| 类型 | 每日限额 | 说明 |
|---|
| ------ | ---------- | ------ |
| 深度智能搜索 | 100次 | 最强 AI 总结 |
| 高性能版 | 100次 | AI 总结 |
| 普通搜索 | 50次 | 搜索结果列表 |
| 百度百科 | 50次 | 词条详情/搜索 |
| 通用热榜 | 每平台1次 | 9个平台 |
| 垂类热榜 | 8次 | 超出收费1元/次 |
| 百度热搜 | 10次 | 民生/财经/科技... |
高级参数
深度搜索参数（仅 chat_completions）
| 参数 | 类型 | 说明 | 示例 |
|---|
| ------ | ------ | ------ | ------ |
deep_search | bool | 深度搜索，获取更全面结果（默认 True） | deep_search=True |
reasoning | bool | 开启推理模式，处理复杂问题（默认 False） | reasoning=True |
通用参数
| 参数 | 类型 | 说明 | 示例 |
|---|
| ------ | ------ | ------ | ------ |
recency | str | 时间过滤 (day/week/month/year) | recency="week" |
resource_types | list | 资源类型 (image/video/web) | resource_types=["image"] |
top_k | int | 返回结果数量（默认 10） | top_k=5 |
使用示例
from smart_search import smart_search
# 基础搜索
result = smart_search("北京天气")
# 一周内的新闻
result = smart_search("最新AI新闻", recency="week")
# 开启推理模式（复杂问题）
result = smart_search("量子计算对未来的影响", reasoning=True)
# 带图片结果
result = smart_search("科技图片", resource_types=["image"])
# 强制使用深度智能搜索 + 推理
result = smart_search("什么是AI", force_api="chat_completions", reasoning=True)
命令行使用
# 深度智能搜索 + 推理
python3 smart_search.py '量子计算' --force chat_completions --reasoning
# 高性能版 + 一周内
python3 smart_search.py 'AI新闻' --force smart_search_pro --recency week
# 带图片结果
python3 smart_search.py '风景' --resource-types image
安装
# 方式一：直接克隆
git clone https://github.com/Stan-Xia/zhisou-skill.git
cd zhisou-skill
# 方式二：下载 ZIP
# 下载 https://github.com/Stan-Xia/zhisou-skill/raw/main/zhisou-skill.zip
# 解压后放入 skills 目录
配置凭证
必需环境变量：BAIDU_API_KEY
获取方式：
- 访问 https://console.bce.baidu.com/qianfan/overview
- 创建应用，获取 API Key
- 设置环境变量：
# Linux/Mac
export BAIDU_API_KEY="你的API Key"
# Windows
set BAIDU_API_KEY=你的API Key
# 或者在调用时传入
python3 scripts/smart_search.py '关键词' --api-key 你的API Key
基本使用
# 智能搜索（自动选最优 API）
python3 scripts/smart_search.py '搜索内容'
# 指定搜索
python3 scripts/smart_search.py '搜索内容' --force chat_completions
# 查询热榜
python3 scripts/trending.py weibo
python3 scripts/trending.py bilibili
注意事项
⚠️ 重要提醒
- 凭证安全
BAIDU_API_KEY 是你的百度账号凭证，不要上传到公开仓库- 已上传的仓库会自动忽略包含 key 的文件
- 使用时通过环境变量传入，不要硬编码
- 配额限制
- 搜索类 API 每日限额用完后会自动失败
- 热榜每天共 8 次（不是每个平台 8 次）
- 超出配额可能产生额外费用
- ⚠️ 免费额度监控（必读）
- 百度计算调用次数的方式与实际可能有较大出入
- 请以千帆后台实际用量为准：https://console.bce.baidu.com/qianfan/studio/resource
- 建议实时监控千帆控制台的用量统计，避免额度用完导致服务中断
- 免费额度宝贵，不要随意测试，仅在实际需要时调用
- 💰 后付费政策
- 免费额度用完后将自动转为后付费模式
- 超额使用会产生欠费，请及时关注账户余额
- 调度器行为
- 自动按优先级尝试：
chat_completions → web_summary → web_search - 如果某 API 失败，会自动切换下一个
- 全部失败才返回错误
- 性能考虑
- 大关键词搜索可能返回较多结果，耗时较长
- 建议配合 OpenClaw 的异步执行
故障排查
| 问题 | 解决方案 |
|---|
| ------ | ---------- |
| 提示 "API Key 无效" | 检查 BAIDU_API_KEY 是否正确设置 |
| 提示 "配额不足" | 等待第二天配额重置，或更换 API Key |
| 返回空结果 | 检查关键词是否正确，尝试简化搜索词 |
| 网络超时 | 检查服务器网络连接 |
Current Status
Fully functional. 智能调度器 v1.0.3 已集成全部百度 API。