前言¶
在 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
