前言¶

做投研辅助或组合跟踪时，常见做法是自己写爬虫、维护 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