前言¶
在 Cursor、Claude Code 等環境裏做問答或寫代碼時，模型上下文往往止於訓練數據與本地倉庫，遇到「最新政策」「實時股價」「某產品本週更新」這類問題，要麼拒答，要麼靠內置瀏覽能力但結果不穩定。自己接搜索 API 又要寫鑑權、拼請求、把網頁洗成 Agent 可讀的 Markdown。
下面介紹 SkillHub 上的 元寶搜索 Skill（座標 @user_f26e0ccb/tencent-yuanbao-standard-search，包名對應標準版聯網搜索）。它把騰訊雲元寶搜索服務（Tencent Yuanbao Search，WSA）封裝成通用 SKILL.md 工作流：配置 API Key 後，由 Agent 在需要外網信息時優先調用 scripts/websearch.py，直接拿到結構化檢索結果。
這是什麼¶
元寶搜索 Skill 是社區來源（source: community）的 knowledge-management 類 Skill，SkillHub 子分類爲「信息檢索」。頁面展示名爲「元寶搜索Skill」，英文摘要爲：Search the web using Tencent Yuanbao Search (WSA). Prioritize using it when you need to retrieve network information.
維護方在 SkillHub 上標註爲 TencentCloud Web Search API (WSA)，發佈座標爲 user_f26e0ccb。產品定位（中文摘要）：以互聯網公開資源爲基礎，疊加騰訊內容生態與元寶 APP 聯網搜索實踐，從收錄到召回構建面向 AI 的搜索引擎；針對對話中的 query 返回標題、摘要、URL、發佈時間、站點等，供大模型決策使用。
當前 SkillHub 展示版本爲 v1.0.4（版本說明：增加 mode 參數）；標籤 requires_api_key=true，運行依賴 python3 與環境變量 TENCENTCLOUD_WSA_APIKEY。
核心功能¶
依據官方 Skill 包內的 SKILL.md，已覈實能力包括：
- 關鍵詞聯網檢索：通過 WSA 按 query 拉取網頁結果，腳本輸出 Markdown（標題鏈接、摘要、發佈時間、站點、相關性得分，可選圖片）。
- 檢索約束：可選
site（域名）、freshness（d[N]/m[N]/y[N]或year等時效）、cnt（10–50 條）、industry（gov / news / acad / finance）。 - 結果類型
mode（v1.0.4 起）：0公開網頁信源（默認）；1優質權威垂直信源（天氣、金價、股價等）；2混合結果。 - Agent 觸發指引：文檔列出「幫我搜索…」「最新的…」「聯網搜索」等意圖，並約定先檢查
TENCENTCLOUD_WSA_APIKEY，再在 Skill 目錄下執行腳本。 - 錯誤提示：欠費、未開通、未授權等場景對應騰訊雲控制台與費用中心鏈接。
SkillHub 頁面統計（截至頁面數據）：下載約 5788 次，安裝 9 次；產品主頁見 騰訊雲 WSA。
安裝與啓用¶
1. 安裝 SkillHub CLI（可選）¶
若本機尚無 skillhub，按 SkillHub 安裝文檔 執行：
command -v skillhub && skillhub --version
未安裝時可用官方腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝元寶搜索 Skill¶
方式 A：skillhub install（推薦）
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別：
skillhub install @user_f26e0ccb/tencent-yuanbao-standard-search --dir <你的 skills 目錄>
常見路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
方式 B：下載 Zip
SkillHub 提供 v1.0.4 包下載：
https://api.skillhub.cn/api/v1/download?slug=@user_f26e0ccb/tencent-yuanbao-standard-search
解壓到上述 skills 目錄之一即可。
方式 C：讓 Agent 按提示詞安裝
官方頁面說明：根據 https://skillhub.cn/install/skillhub.md ，安裝 @user_f26e0ccb/tencent-yuanbao-standard-search。
3. 開通 WSA 並配置 API Key¶
在 元寶搜索控制台 開通服務並創建 服務 API KEY。免費額度規則以 活動專區 頁面爲準。
將 Key 寫入環境變量（Skill 元數據要求）：
export TENCENTCLOUD_WSA_APIKEY="your-api-key-here"
更完整的 Open Claw / 多環境配置見 Skill 包內 references/setup.md。安裝後需重啓或刷新 Agent，使其加載新 Skill。
典型用法¶
以下命令均需在 Skill 根目錄（與 scripts/websearch.py 同級）執行。
關鍵詞搜索：
python3 scripts/websearch.py --query="搜索關鍵詞"
限定站點：
python3 scripts/websearch.py --query="搜索關鍵詞" --site="sogou.com"
最近三天內的結果：
python3 scripts/websearch.py --query="搜索關鍵詞" --freshness='d3'
天氣、股價等垂直信源（混合模式）：
python3 scripts/websearch.py --query="搜索關鍵詞" --mode=2
限制返回條數：
python3 scripts/websearch.py --query="搜索關鍵詞" --cnt=10
在對話側，用戶說「幫我搜索一下騰訊股價」時，Agent 應按 SKILL.md：識別檢索意圖 → 檢查 TENCENTCLOUD_WSA_APIKEY → 調用上述腳本 → 將 Markdown 結果回給用戶。
適用場景與注意¶
適合：
- 需要穩定、可審計的聯網檢索，且希望統一走騰訊雲 WSA 計費與控制台管理的團隊。
- 已在 Cursor / Claude Code / Codex 等支持 Skills 的客戶端中工作，希望用一條安裝命令補齊「外網查證」能力。
注意：
- 付費與配額：調用走 WSA 標準版/API KEY 鑑權，需關注賬號欠費與額度；未配置 Key 時 Skill 會提示開通與創建 Key。
- 運行環境：依賴本機
python3；腳本路徑相對 Skill 目錄，不要在其他工作目錄裸調。 - 命名差異：SkillHub 展示名「元寶搜索Skill」，包內
SKILL.md的name爲tencent-yuanbao-search，座標 slug 爲tencent-yuanbao-standard-search，檢索時以座標爲準。 - 社區包：
source爲 community，使用前可在 SkillHub 查看安全掃描結果；企業場景請結合內網合規要求評估外網檢索。
結尾¶
元寶搜索標準版 Skill 把 WSA 檢索參數（站點、時效、條數、mode、垂直領域）和 Agent 觸發邏輯寫進 SKILL.md，減少自建聯網層的重複勞動。安裝、Key 配置與腳本示例均來自官方 Skill 包與 SkillHub 頁面。
- SkillHub 技能頁：https://www.skillhub.cn/skills/user_f26e0ccb/tencent-yuanbao-standard-search
- API 入口（SkillHub）：https://api.skillhub.cn/user_f26e0ccb/tencent-yuanbao-standard-search
- 產品文檔與開通：https://cloud.tencent.com/product/wsa
