前言¶
在 Cursor、Claude Code 等环境里做调研时，模型自带的联网能力往往不稳定，或者结果难以对照国内站点与实时热榜。若你希望 Agent 按固定流程调用百度千帆的 AI 搜索、百科与热榜接口，并把配额与 API 选择写进 Skill，社区 Skill「百度ai搜索」提供了一套可安装的方案。下面介绍它是什么、能做什么，以及如何通过 SkillHub 安装与配置。
这是什么¶
「百度ai搜索」是 SkillHub 上的社区 Skill，坐标为 @user_458b0f84/baiduaisearchwithquota，当前版本 1.0.3，分类为 knowledge-management，标签标明 requires_api_key=true。官方简介：集成深度搜索、百科查询、热榜获取等能力，用于网络信息检索、实时资讯、知识查询。
Skill 包内元数据要求运行环境具备 python3，并通过环境变量 BAIDU_API_KEY 提供百度千帆 API Key。包内 README 亦指向 GitHub 仓库 Stan-Xia/baidu-ai-search 作为同源说明；通过 SkillHub 安装时以本 Skill 目录下的 scripts/ 为准。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与脚本说明，可按用途分为三类。
智能搜索与调度¶
scripts/smart_search.py 作为调度器，在未强制指定 API 时按优先级尝试：深度智能搜索（chat_completions）→ 高性能版（web_summary / smart_search_pro）→ 普通百度搜索（web_search / smart_search）。文档说明单日配额大致为：深度与高性能各约 100 次、普通搜索约 50 次；调度在配额用到约 85% 时会切换到下一档 API。
也可通过 --force 固定某一类接口，例如深度搜索、百科详情/搜索，或各平台热榜类型。
百科¶
支持词条详情（baike_content）与按标题搜索（baike_search），文档标注每日约 50 次配额。
热榜¶
scripts/trending.py 可查询多平台热榜（如 weibo、zhihu、bilibili、xhs、douyin 等），并支持垂类热榜、百度热搜分类等子命令。Skill 文档对热榜、垂类、百度热搜的每日次数有单独说明，且提醒热榜总次数与计费策略需以千帆控制台为准。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方安装说明执行（完整安装或仅 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。SkillHub 页面给出的安装提示为：根据上述安装文档，安装 @user_458b0f84/baiduaisearchwithquota。
命令行示例（将目录换成你当前客户端的路径）：
skillhub install @user_458b0f84/baiduaisearchwithquota --dir ~/.cursor/skills
skillhub install @user_458b0f84/baiduaisearchwithquota --dir ~/.claude/skills
skillhub install @user_458b0f84/baiduaisearchwithquota --dir ~/.codex/skills
安装成功后，技能会出现在对应目录下的 @user_458b0f84/baiduaisearchwithquota/。部分客户端在安装或更新 Skill 后需要重启才能加载，以你所用产品的文档为准。
3. 配置 BAIDU_API_KEY¶
在 百度千帆控制台 创建应用并获取 API Key，然后设置环境变量：
export BAIDU_API_KEY="你的API Key"
也可在调用脚本时传入（见包内 SKILL.md 中的 --api-key 说明）。请勿将 Key 提交到公开仓库。
典型用法¶
以下示例假设 Skill 已安装到 ~/.cursor/skills/@user_458b0f84/baiduaisearchwithquota，其他客户端请把路径中的 .cursor 换成对应 skills 目录。
智能搜索（推荐，自动选 API）：
python3 ~/.cursor/skills/@user_458b0f84/baiduaisearchwithquota/scripts/smart_search.py '最新科技新闻'
强制使用深度智能搜索并开启推理：
python3 ~/.cursor/skills/@user_458b0f84/baiduaisearchwithquota/scripts/smart_search.py '量子计算' --force chat_completions --reasoning
查询微博热榜：
python3 ~/.cursor/skills/@user_458b0f84/baiduaisearchwithquota/scripts/trending.py weibo
在 Agent 会话中，也可按 SkillHub 页面提示，让 AI 根据安装文档完成安装；启用 Skill 后，用户用自然语言描述检索或热榜需求，Agent 应按 SKILL.md 调用上述脚本而非臆造接口。
适用场景与注意¶
适合谁： 需要在国内数据源上做 AI 总结搜索、百科查证、热榜跟踪的开发者；已在使用 Cursor、Claude Code、Codex 等支持 Skill 的客户端，并愿意自行申请千帆 API Key 的同学。
限制与注意：
- 配额与费用：Skill 文档列出了各接口的参考日限额；同时明确百度侧统计可能与文档不一致，应以 千帆资源用量 为准。免费额度用尽后可能进入后付费，需关注账户余额。
- 热榜次数：文档对「通用热榜」「垂类热榜」「百度热搜」的次数描述并不相同，实际调用前建议对照
SKILL.md中的配额表，避免误测耗尽额度。 - 网络与依赖：需能访问百度 API；仅依赖 python3 与 requests（脚本内使用），无额外编译步骤。
- 社区维护：来源为 SkillHub community，发布者为 user_458b0f84；问题排查可参考包内故障表（如 Key 无效、配额不足、空结果等）。
SkillHub 页面当前展示的版本为 v1.0.3；站内统计（抓取时）评分 100000、下载约 1898、安装约 24，仅供了解热度，与千帆配额无直接关系。
结尾¶
「百度ai搜索」把百度千帆的搜索、百科与热榜能力封装成 Agent 可遵循的 Skill，并通过调度器在多种 API 之间按优先级与配额切换。若你正在搭建面向国内资讯与知识查询的 Agent 工作流，可从 SkillHub 安装并配置 BAIDU_API_KEY 后，用包内脚本做可复现验证。
官方 Skill 页：https://www.skillhub.cn/skills/user_458b0f84/baiduaisearchwithquota
API 入口（SkillHub）：https://api.skillhub.cn/user_458b0f84/baiduaisearchwithquota
