前言¶

做投研輔助或組合跟蹤時，常見做法是自己寫爬蟲、維護 Cookie，或在對話裏讓模型「猜」雪球頁面結構。組合代碼、用戶 ID、調倉明細分散在不同接口，手工拼 URL 成本高，也容易因頁面改版失效。

下面介紹 SkillHub 上的社區 Skill「雪球網信息獲取」（座標 @user_6eb4c6c0/xueqiu-skill，當前版本 1.0.3）。它把雪球相關查詢收斂成一套 POST JSON 接口說明，供 Agent 在需要組合、用戶、行情、調倉歷史等數據時按文檔調用，而不是臨時編造請求格式。

這是什麼¶

「雪球網信息獲取」是面向 Agent 的 SKILL.md 技能包：描述如何通過第三方雪球數據 API（線上 Base URL 爲 https://wxpub.aibana.art）拉取投資相關數據。發佈者爲 SkillHub 用戶 user_6eb4c6c0，來源爲 community，分類爲 professional；SkillHub 標註 requires_api_key=true，即使用前需配置 app_id 與 secure_key。

技能本身不內置可執行腳本，核心是接口契約、參數表與 curl 示例。Agent 讀取 SKILL.md 後，在用戶提問時選擇對應方法名（如 searchCube、getCubeRebalancing）組裝請求。

核心功能¶

以下能力均來自技能包內 SKILL.md / README.md，按接口類別歸納。

搜索

• searchUser：按關鍵詞搜雪球用戶
• searchCube：按關鍵詞搜投資組合
• searchStatus：按關鍵詞搜帖子（摘要爲 HTML，帖子鏈接需拼 https://xueqiu.com{target}）
• searchCubeRanked：搜組合並按總收益排序，支持 minTotalGain、minAnnualRate、topN 等過濾

行情

• getCubeQuote：組合實時淨值與收益（symbol 如 ZH349701）
• getCubeNavHistory：組合日頻淨值歷史（cubeId + count，最大約 365 天）

組合與用戶

• getCubeInfo：組合詳情、持倉與調倉相關元數據（SP 前綴老組合部分收益字段可能爲 null）
• getUserCubes：某用戶創建的全部組合
• getUserTimeline：用戶原創發帖列表

調倉

• getCubeRebalancing：組合歷史調倉記錄（含當次變動股票明細）

公共請求體均需 app_id、secure_key；線上路徑形如 POST https://wxpub.aibana.art/xueqiu/{method}，本地調試 Base URL 爲 http://localhost:8080/wxpublic_fetch。

安裝與啓用¶

1、安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時可按 SkillHub 官方安裝文檔執行（完整安裝示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

說明見：https://skillhub.cn/install/skillhub.md

2、安裝本技能到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。SkillHub 搜索頁給出的安裝方式爲：

skillhub install xueqiu-skill --namespace user_6eb4c6c0 --dir <你的 skills 目錄>

常見路徑（摘自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可在 SkillHub 技能頁將提示詞發給 AI，讓其按 https://skillhub.cn/install/skillhub.md 安裝 @user_6eb4c6c0/xueqiu-skill。

安裝完成後，按你所用客戶端要求重啓或刷新技能索引。

3、配置 API 憑證¶

在 https://wxpub.aibana.art 註冊賬號，於「Skill 技能」頁創建 app_id 和 secure_key。README 建議將憑證告知 Agent，例如說明自己的 app_id 與 secure_key，以便對話中發起調用。

計費與限速（技能文檔原文）：

• 每次成功調用扣 0.2 元；失敗自動退款；餘額不足返回 402
• 60 秒內最多 10 次上游請求（全用戶共享）；建議客戶端約每 6 秒一次；排隊超過 20 個可能 429，等待超過 120 秒可能 503

典型用法¶

自然語言（交給 Agent 選接口）¶

技能 README 中的示例提問包括：

• 「幫我搜索關鍵詞爲”實盤”的組合，按總收益排前 5」
• 「搜一下”散戶老牛”相關的帖子」
• 「ZH349701 的當前淨值是多少？」
• 「拉一下組合 12363 最近 10 次調倉」
• 「天地俠影最近發了哪些帖子？」

啓用技能並配置憑證後，Agent 應依據 SKILL.md 映射到具體 method 與 JSON 體。

curl 復現（搜索帖子）¶

下列命令來自 SKILL.md，將 ak_xxx / yyy 替換爲真實憑證：

curl -X POST https://wxpub.aibana.art/xueqiu/searchStatus \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","keyword":"散戶老牛","count":10,"page":1}'

curl 復現（組合排行 Top 5）¶

curl -X POST https://wxpub.aibana.art/xueqiu/searchCubeRanked \
  -H "Content-Type: application/json" \
  -d '{"app_id":"ak_xxx","secure_key":"yyy","keyword":"實盤","count":30,"topN":5}'

錯誤時響應形如 {"error":"..."}；401 檢查憑證，402 充值，502 多爲上游雪球失敗且文檔說明會自動退款。

適用場景與注意¶

適合誰

• 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望在對話裏查雪球組合、用戶、帖子、淨值與調倉，而不想每次手寫爬蟲
• 能接受按次計費與全侷限速的第三方 API，並願意在 wxpub 後臺維護餘額與密鑰

限制與注意

• 數據經 wxpub.aibana.art 中轉，合規與穩定性取決於該服務與雪球上游；502/503 需按文檔重試
• getCubeInfo 對部分 SP 前綴組合或同步延遲場景會出現 null 字段，調用方需做空值處理
• searchStatus 返回 HTML 摘要，展示前要自行清洗
• SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 3955；與技能業務能力無直接關係，選型時仍以接口文檔爲準
• README 提及 接口調用說明.md，當前 SkillHub 下發的包內以 SKILL.md 爲完整規範

結尾¶

「雪球網信息獲取」把雪球組合、用戶、行情與調倉查詢整理成 Agent 可讀的接口技能：安裝座標 @user_6eb4c6c0/xueqiu-skill，配置 app_id / secure_key 後即可在對話或 curl 中按方法名調用。

官方入口：

• API 頁：https://api.skillhub.cn/user_6eb4c6c0/xueqiu-skill
• SkillHub 頁：https://www.skillhub.cn/skills/user_6eb4c6c0/xueqiu-skill