前言¶
做選題、寫簡報或做輿情跟蹤時，常見做法是自己在瀏覽器裏搜關鍵詞、再手工整理鏈接。把「按關鍵詞查全網或指定站點、結果落盤成結構化文件」交給 Agent，前提是有一套可覈對的數據源和固定調用方式。下面介紹 SkillHub 上的 tencenthotsearch-skill（座標 @user_5b28ea14/tencenthotsearch-skill，當前版本 1.0.1）：它封裝騰訊雲在線搜索 API（SearchPro），在對話裏觸發熱點、趨勢或關鍵詞資訊檢索，並支持多種導出格式。
這是什麼¶
tencenthotsearch-skill 是社區來源（community）的 data-analysis 類 Skill，由 SkillHub 用戶 user_5b28ea14 發佈；頁面展示作者爲 hanli。官方簡介說明：通過騰訊雲 SearchPro 獲取熱門新聞與文章，支持全網或指定站點檢索，輸出可爲 JSON、CSV、TXT、MD；當用戶需要熱點、趨勢話題，或基於騰訊雲做關鍵詞文章搜索時，可調用本 Skill。
SkillHub 側標籤爲 requires_api_key=true，與包內 SKILL.md 一致：需要配置騰訊雲 SecretId 與 SecretKey。包內元數據還指向上游倉庫路徑 https://github.com/neuhanli/skills/tree/main/TencentHotSearch-skill，便於自行審閱腳本與配置說明。
核心功能¶
以下能力來自 SkillHub 簡介及已安裝包內 SKILL.md（v1.0.1）：
- 多關鍵詞組合檢索：一次支持 1～5 個關鍵詞。
- 全網或站內搜索：可不指定站點做全網檢索，也可用
-s限定站點（文檔示例含qq.com、news.qq.com）。 - 多種搜索模式：Mode
0自然搜索結果（默認）、1多模態 VR、2混合結果；部分過濾參數在 Mode 1 下無效，以文檔爲準。 - 時間與行業過濾：支持
--from-time/--to-time（Unix 秒級時間戳）；--industry可選gov/news/acad/finance（文檔標註爲 Premium 能力）。 - 結構化結果字段：標題、摘要、動態摘要、來源、發佈時間、原文鏈接、相關度、圖片列表等。
- 多格式輸出：
json/csv/txt/md，默認md；可在config.json中設置默認output_dir。 - 對接的官方 API：域名
wsa.tencentcloudapi.com，版本2025-05-08，接口名 SearchPro。
運行時依賴方面，文檔要求 Python 3.7+；核心邏輯使用標準庫，CSV 導出可選 pandas>=2.0.0（見 requirements.txt）。
安裝與啓用¶
通過 SkillHub CLI 安裝到 Agent¶
先確認本機已安裝 skillhub（未安裝時可按 SkillHub 安裝說明 執行官方安裝腳本）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。
在 Cursor 中，skills 目錄一般爲：
~/.cursor/skills/
安裝命令（與 SkillHub 頁面提示一致，座標帶 @ 前綴）：
skillhub install @user_5b28ea14/tencenthotsearch-skill --dir ~/.cursor/skills/
Claude Code 常用路徑爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下 .agents/skills/。將上述 --dir 換成對應目錄即可，安裝步驟相同。
也可把下面提示發給 Agent，讓其按官方文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5b28ea14/tencenthotsearch-skill`。
配置騰訊雲憑證¶
進入 Skill 目錄後，編輯 config.json（包內提供模板字段）：
{
"secret_id": "YOUR_TENCENT_CLOUD_SECRET_ID",
"secret_key": "YOUR_TENCENT_CLOUD_SECRET_KEY",
"output_dir": "./output"
}
SKILL.md 說明需在騰訊雲控制台開通「在線搜索」並獲取 API 密鑰；更細的字段說明見包內 CONFIG.md。請勿將 config.json 提交到版本庫。
Python 依賴（命令行腳本）¶
若需直接運行包內 scripts/tencent_hotsearch.py，在 Skill 根目錄執行：
pip install -r requirements.txt
典型用法¶
在 Agent 對話中¶
按官方 description，在用戶提出下列需求時啓用本 Skill 即可，由 Agent 按 SKILL.md 調用腳本或等價流程：
- 獲取某領域熱點新聞或趨勢話題；
- 按關鍵詞檢索最新文章；
- 在指定站點內搜索（如騰訊系站點）；
- 需要按時間或行業過濾，並將結果保存爲 MD/JSON/CSV 等。
命令行可復現示例¶
下列命令摘自包內 SKILL.md，在 Skill 根目錄、且已配置 config.json 的前提下執行。
全網檢索，返回 10 條，默認 MD：
python scripts/tencent_hotsearch.py "AI" "machine learning" -l 10
限定站點：
python scripts/tencent_hotsearch.py "AI" "machine learning" -s qq.com -l 10
指定輸出爲 JSON 文件：
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.json -f json
時間範圍過濾（示例時間戳來自文檔）：
python scripts/tencent_hotsearch.py "AI" --from-time 1704067200 --to-time 1706745600
常用參數包括 -l（條數，可選 10/20/30/40/50）、-m（模式 0/1/2）、-o / -f（輸出路徑與格式）、--print（打印到終端）。
適用場景與注意¶
適合誰
- 已在用或計劃用騰訊雲 SearchPro，希望 Agent 統一完成「搜熱點 → 落盤 → 再分析」的開發者；
- 需要把檢索結果固定爲 JSON/CSV 等格式、接入後續 data-analysis 流水線的場景。
限制與注意
- 必須自備 API 密鑰：無有效
secret_id/secret_key無法調用；密鑰應最小權限、定期輪換，建議在隔離環境運行。 - 網絡與寫文件權限：
SKILL.md聲明需要訪問wsa.tencentcloudapi.com，並向配置的輸出目錄寫入結果。 - 元數據與文檔：包內
SKILL.md提到，部分註冊元數據曾寫「無需憑證」，與實際config.json要求不一致；以包內文檔與requires_api_key=true爲準。 - Premium 能力：行業過濾、部分條數上限、動態摘要等以騰訊雲套餐與
SKILL.md說明爲準。 - SkillHub 統計（抓取時點）：評分 100000，下載約 990 次，安裝 24 次；數據隨 SkillHub 頁面更新而變化。
結尾¶
tencenthotsearch-skill 把騰訊雲 SearchPro 的檢索能力裝進通用 SKILL.md 工作流：Agent 側用 SkillHub 安裝與觸發，執行側用 config.json 與 scripts/tencent_hotsearch.py 完成可復現的搜索與導出。官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_5b28ea14/tencenthotsearch-skill
- API 座標頁：https://api.skillhub.cn/user_5b28ea14/tencenthotsearch-skill
