技能介绍

要解决什么问题

在投研流程中，常常需要从雪球抓取用户、组合、帖子、净值和调仓信息，再拼接成可分析的数据源。手动抓取页面或维护私有爬虫，容易遇到鉴权、限速、字段格式不一致等问题。@user_6eb4c6c0/xueqiu-skill 把雪球相关接口封装为可调用技能，适合在 Agent 或脚本中按参数直接取数。

技能如何工作

技能通过 POST JSON 请求访问指定 Base URL，公共字段包含 app_id 和 secure_key。核心能力包括：

搜索类：searchUser、searchCube、searchStatus、searchCubeRanked，可按关键词查找用户、组合、帖子，并按收益排序筛选。
行情类：getCubeQuote 获取组合实时净值，getCubeNavHistory 获取日频历史净值。
详情与历史：getCubeInfo 返回组合描述、收益、持仓等；getCubeRebalancing 返回调仓时间、现金比例和股票变动明细。
用户维度：getUserCubes 与 getUserTimeline 用于追踪某个用户创建的帖子和组合。

关键步骤是先注册并获取凭证，再根据目标选择接口，传入 keyword、symbol、cubeId、userId 等参数，最后处理分页、HTML 描述、空值和错误码。

适用边界与注意点

该技能面向数据获取，不替代投资判断。帖子 description 是 HTML，展示前需清洗；完整 URL 需拼 https://xueqiu.com{target}。老组合或数据同步延迟可能导致部分字段为 null。接口按成功调用计费，失败退款；全局限速为 60 秒内最多 10 次上游请求，客户端建议每 6 秒请求一次。返回 401、402、429、502、503 时，应分别检查凭证、余额、请求频率或稍后重试。