前言¶
在 Cursor、Claude Code 等环境里做 A 股相关分析时，常见做法是临时拼 curl、Python 脚本或零散 MCP，行情、公告、深度财务往往分散在不同源上，某一接口失效时还要手动改脚本。下面介绍的 wolfjkd-trader-data 以通用 SKILL.md 形式，把「数据源选型、部署步骤、容错与路由」写进 Skill，让 Agent 按文档拉数而不是每次从零摸索。
这是什么¶
wolfjkd-trader-data（坐标 @user_abc07f4d/wolfjkd-trader-data，当前 v3.0.0）是 SkillHub 社区（community）发布的 data-analysis 类 Skill，发布者为 user_abc07f4d；Skill 正文由 wolfjkd 维护，协议为 MIT。定位是 A 股交易员数据获取的完整方案，并包含 多源智能路由（data_router.py）。SkillHub 标签标明 requires_api_key=true，主要对应 Wind 等深度数据所需的 API Key，腾讯行情、ftshare 公告等路径在文档中标注为无需 Key 或可选配置。
在 SkillHub 上该 Skill 评分 100000，下载 825 次（统计以 SkillHub 页面为准）。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 data_router.py 的说明，可按安装后的目录自行核对。
五类数据与主数据源¶
| 数据类型 | 主数据源 | 说明 |
|---|---|---|
| 行情数据 | 腾讯接口 | 毫秒级实时快照，如指数、自选股、美股指数、大宗商品、数字货币 |
| 公告数据 | ftshare | 单股历史公告、全市场按日公告等 |
| 新闻数据 | WebSearch | 文档中的兜底检索方式 |
| 大宗商品等 | 腾讯接口 | 与行情同一类接口 |
| 深度数据 | Wind | 财务、资金、板块、宏观、公告 RAG、技术指标等，需 API Key |
腾讯行情示例接口（文档摘录）：
https://qt.gtimg.cn/q=sh000001,sz399001,sz399006
多源智能路由 data_router.py¶
v3.0 起内置 data_router.py：对腾讯、Wind、ftshare 等适配器 并行探测，按可用性、及时性、质量加权评分，优先选用 ≥50 分 的源，并在接近时选更快响应。脚本仅依赖 Python 3 标准库（路由本身无需额外 pip 包）。
常用 CLI：
python data_router.py health
python data_router.py quote --codes sh000001 --json
python data_router.py watchlist --json
python data_router.py compare --code 600519.SH --type quote
自选股可在 data_router.py 内编辑 WATCHLIST 列表。
配套 Skill 与 AkShare¶
完整栈在文档中还包括：ftshare 公告 Skill、Wind 的 wind-mcp-skill / wind-find-finance-skill、可选 AkShare（如腾讯历史 K 线 stock_zh_a_hist_tx）。文档同时记录东方财富部分 AkShare 接口可能不可用时的替代路径（腾讯 curl、Wind、WebSearch）。
安装与启用¶
通过 SkillHub CLI（推荐）¶
先确认本机已安装 skillhub（安装方式见 SkillHub 安装说明）。安装 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。
command -v skillhub && skillhub --version
skillhub search wolfjkd-trader-data
skillhub install wolfjkd-trader-data --namespace user_abc07f4d --dir <你的 skills 目录>
SkillHub 页面也支持用自然语言让 Agent 按同一文档安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_abc07f4d/wolfjkd-trader-data`。
各客户端 skills 目录（节选）¶
| 环境 | 典型路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按各客户端要求重启或刷新 Skill 索引。扩展数据源（ftshare、Wind 等）需按 SKILL.md 中命令另行安装并配置 Key；未安装 Wind 时路由会自动降级，文档中已说明对应报错与处理。
典型用法¶
1. 快速验证腾讯行情¶
curl -s "https://qt.gtimg.cn/q=sh000001"
2. 路由健康检查与 JSON 行情¶
在 Skill 目录下执行：
python data_router.py health
python data_router.py quote --codes sh000001,sz399001,sz399006 --json
晚间报告类流程在文档中建议：先 health，再 quote / watchlist 的 JSON 输出，公告与新闻按健康结果选源并在报告中标注来源与评分。
3. ftshare 公告（需先安装 ftshare Skill）¶
python <FTSHARE_SKILL_DIR>/run.py \
stock-announcements-single-stock-all-periods \
--stock-code 600519.SH \
--page 1 --page-size 10
股票代码格式示例：上海 600519.SH，深圳 000001.SZ。
4. Wind 深度查询（需 API Key）¶
node <WIND_SKILL_DIR>/scripts/cli.mjs setup-key <YOUR_KEY> --scope global
node <WIND_SKILL_DIR>/scripts/cli.mjs call stock_data get_stock_price_indicators \
'{"windcode":"600519.SH","indexes":"中文简称,最新成交价,涨跌幅,成交量,换手率,市盈率(TTM),市净率"}'
使用 Wind 数据时，文档要求结果标注「数据来源于万得 Wind 金融数据服务」。
适用场景与注意¶
适合：需要在 Agent 工作流中稳定获取 A 股行情与公告、希望用 data_router.py 做源健康探测与择优、或按文档搭建定时任务（健康检查 + JSON 行情）的开发者与交易员。
限制与注意（摘自 Skill 文档）：
- 东方财富相关 AkShare 接口可能连接被拒，需走腾讯或 Wind 等替代。
- Wind 有日调用额度，实时快照优先腾讯；深度分析再调 Wind。
- Wind 单工具单标的，批量需循环调用。
data_router.py当前覆盖三个主适配器，无短时缓存；Wind 一致性检查对嵌套 JSON 解析仍不完善。- 行情与合规数据仅供技术研究，不构成投资建议；外部接口可用性随网络与厂商策略变化。
结尾¶
wolfjkd-trader-data 把 A 股多源获取与 v3.0 的智能路由写进一份可安装的 Skill，适合作为 Agent 侧的数据层「操作手册」。官方 SkillHub 页面与 API 入口：
- https://www.skillhub.cn/skills/user_abc07f4d/wolfjkd-trader-data
- https://api.skillhub.cn/user_abc07f4d/wolfjkd-trader-data
