基于东方财富权威金融数据库的一站式投研能力平台，覆盖数据查询、资讯搜索、智能选股、财报诊断、研报生成等 14 个专业化子技能。

git clone git@github.com:ghyghoo8/mx-skill-cc.git ~/.claude/skills/mx-skills

重启 Claude Code 后自动识别并加载。

在项目根目录执行：

mkdir -p .claude/skills
git clone git@github.com:ghyghoo8/mx-skill-cc.git .claude/skills/mx-skills

# mx-skills 主路（14 个子技能）
pip3 install httpx pandas openpyxl --user

# a-stock-data 补充层（仅 A 股的实时/筹码/资金面/龙虎榜等互补能力）
pip3 install mootdx requests stockstats --user

# 方式 1：写入 ~/.zshrc 或 ~/.bashrc（持久化）
export EM_API_KEY="your_api_key_here"

# 方式 2：多 Token 配额轮换（推荐高频场景使用）
export EM_API_KEY_POOL="em_xxx,em_yyy,em_zzz"

# 方式 3：使用项目本地 .env 文件
cp .env.example .env
# 编辑 .env 填入你的 API Key

.env 已加入 .gitignore，不会提交到仓库。

注意：EM_API_KEY_POOL 需由外层调用封装实现轮换逻辑，原生脚本仅读取 EM_API_KEY。

本技能集采用 Router（路由层） 设计。当用户提出金融相关请求时，Claude 会自动读取 SKILL.md 中的路由决策表，匹配正确的子技能并调用对应脚本。

触发场景包括但不限于：

• 提到股票代码（如 600519、300059）或公司名称
• 提到基金名称（如华夏成长混合）
• 要求查询数据、行情、财报、宏观指标
• 要求搜索资讯、公告、研报
• 要求分析/诊断/研究某只股票、基金或行业
• 要求选股、筛基金、对比公司
• 要求生成报告（行业研究、深度研究、业绩点评、专题研究等）

上游快照版本：基于东方财富妙想官方技能包 2026-03-18 发布版本 vendor ���来（本地快照日期 2026-05-28）。 各子技能上游版本号见下表 meta.json 列；本地相对上游的差异：①移除脚本中硬编码的默认 API Key，强制读取环境变量；②为 4 个 reference 文档补充「调用配额」说明段落。 后续上游升级时，可使用本仓库当前快照作为基准进行 diff 合并。

Vendor 自 simonlin1212/a-stock-data（Apache-2.0，V3.3.0）。覆盖 mx-skills 没有的实时盘口、筹码、资金面、打板、ETF期权、舆情互动能力；也作为 mx-skills 配额耗尽时的降级源。

调用模式 D：模型读 reference → 直接 python3 -c "<内嵌代码>" 执行 → 返回 Python 值（不写文件）。详见 SKILL.md 路由规则。

Vendor 自 skills-xjx/hot-theme-miner v2.0.0（commit e7a022b3，2026-04-15）。不是数据源，而是打分大脑：在 a-stock-data 数据之上跑「题材 Top3 → 个股 Top5 → 中长期目标价 → 操作策略」一条龙。

• 单向依赖：本层引用 a-stock-data，a-stock-data 不感知本层（后者继续按上游 diff 独立升级）。
• 路由切边：简单「今天什么板块热」走 mx-skills #12（付费、快）；整条链路或 #12 配额耗尽走本层（免费、打分透明）。
• ⚠️ 价格模型为启发式、未回测（用当前 PE 反推伪"历史分位"），目标价仅作相对排序参考，已在文档内强制免责。
• 许可证未知：上游无 LICENSE、作者署名 "AI Assistant"，按指示在未核实许可证情况下 vendor，各文件 frontmatter 已如实标注（与 a-stock-data 的 Apache-2.0 不同，存在来源风险）。
• 补充端点回归测试：scripts/theme_miner/smoke_test.py。

• 单次查询实体上限：5 个
• 超限处理：自动截取前 5 个实体，并在结果说明文件中提示
• 示例：查询 6 只股票时，仅返回前 5 只的数据
• 数据量过大时可能返回精简数据，需在提示中留意

包括：金融问答、资讯搜索、宏观数据、智能选股、行业研究、个股跟踪、首次覆盖/深度研究、业绩点评、股票诊断、基金诊断、热点发现、可比公司分析、专题研究。

• 每个技能每日免费调用额度约为 50 次（独立计算，互不影响）
• 具体限额取决于您的东方财富妙想账户等级与平台策略
• 如出现限流提示（如 rate limit、quota exceeded、调用次数已达上限 等），说明已达到当日上限

如需了解确切限额或提升配额：

1. 访问 东方财富妙想官网 查看 API 套餐说明
2. 联系东方财富客服咨询账户升级方案

mx-skills/
├── SKILL.md              # 主 Router：触发条件 + 路由决策表 + 快速调用索引
├── .env.example          # 环境变量模板
├── .gitignore
├── scripts/              # 14 个子技能执行脚本
│   ├── mx_financial_assistant/
│   ├── mx_finance_data/
│   ├── mx_finance_search/
│   ├── mx_macro_data/
│   ├── mx_stocks_screener/
│   ├── industry_research_report/
│   ├── industry_stock_tracker/
│   ├── initiation_of_coverage_or_deep_dive/
│   ├── stock_earnings_review/      # 多步骤脚本（validate + period + review）
│   ├── stock_diagnosis/
│   ├── fund_diagnosis/
│   ├── stock_market_hotspot_discovery/
│   ├── comparable_company_analysis/ # get_data + excel_theme
│   └── topic_research_report/
└── references/           # 15 个详细参考文档（按需读取）
    ├── mx_financial_assistant.md
    ├── mx_finance_data.md
    ├── ...
    └── stock_earnings_review_business_logic.md

本仓库的 a-stock-data 补充能力层 vendor 自：

• 项目主页：simonlin1212/a-stock-data
• 版本：V3.3.0（2026-06-28，commit bcda4054；历经 V3.1 2dd95e3c → V3.2.1 b428fad2 → V3.2.2 9379ab90 → V3.2.4 e40d0655 → V3.2.5/3.3.0 跟进）
• 作者：Simon 林（抖音「Simon林」 / 公众号「硅基世纪」）
• License：Apache License 2.0

上游单文件 SKILL.md（覆盖 10 层架构 / 40 个端点 / 13 个数据源）按层拆分为 11 个 reference 文件（references/a_stock_*.md），保留原作者署名与许可声明。本地针对 2026 年后部分接口漂移做了 2 处仍生效的 patch（§1.3 百度 K线被封改东财 push2his + pandas 算 MA、§5.1 东财个股新闻 search-api 失效改 np-listapi；详见各文件 frontmatter 的 patch_notes）。另有 2 处历史 patch 已被上游官方采纳后本地退役（§6.4 新浪三表 → v3.2.1；§3.3 概念板块 → v3.2.2 改东财 slist）。所有改动经 scripts/a_stock_data/smoke_test.py 回归验证。完整 Apache-2.0 声明见仓库根目录 NOTICE。

v3.2.2 升级要点（2026-06-03 跟进）：①§3.3 概念板块——百度 PAE getrelatedblock 失效（ResultCode 10003），上游改用东财 slist（spt=3，一次拿全板块 + BK码 + 涨跌 + 龙头股），本地退役自有的 emweb F10 patch 与之对齐；②§7.1 巨潮公告——硬编码 gssh0{code} 致大量 601xxx 股票查不到公告，改用 _cninfo_orgid() 动态查官方 szse_stock.json 映射表（6199 股）+ 硬编码 fallback。

v3.2.3 / v3.2.4 升级要点（2026-06-20 跟进，纯新增 + 兼容补丁，不涉本地 patch）：①§2.1 研报层新增东财行业研报 eastmoney_industry_reports()（与个股研报同端点，qType=1）；②新增 tdx_client() helper 规避 mootdx 0.11.x 全新安装的 BESTIP.HQ 空串崩溃（显式探测 TCP 服务器 + 三级 fallback），4 处 mootdx 调用统一改走它。

v3.2.5 升级要点（2026-06-28 跟进，bug 修复）：①**§1.1 mootdx K线参数 category→frequency（CRITICAL）**——旧参数名被 **kwargs 静默吞，分钟/周/月线全退化成日线且不报错；同步修了本仓库 smoke_test 里的同一处；②full_valuation EPS 取列由 iloc[2](=最小值) 改按列名「均值」取（否则 PE/PEG 系统性偏低）；③em_get 加 HTTPAdapter+Retry（429/5xx 退避）；④download_pdf 机构名路径加固。

v3.3.0 升级要点（2026-06-28 跟进，新增三层，7→10 层 / 28→40 端点）：新增 Layer 8 打板（东财涨停/炸板/跌停/昨日涨停四池 + 同花顺涨停揭秘 + 打板情绪）、Layer 9 ETF期权（新浪 T型报价 + 希腊字母/IV，交易所预算好无需本地 BSM）、Layer 10 舆情互动（巨潮互动易问答 + 同花顺热榜 + 东财人气榜）。拆为 3 个新 reference 文件；theme_miner 题材挖掘层的自建涨停/跌停池补充端点已改为复用本层官方 em_zt_pool/em_dt_pool。

v3.2 升级要点（2026-05-30 跟进）：上游新增「东财防封」架构——所有 eastmoney.com 请求统一走 em_get() 节流入口（串行限流 + 会话复用），本地 patch 的 eastmoney 端点也已接入；财联社快讯（§5.2）因 cls.cn 迁站下线，全市场快讯改用东财全球资讯（§5.3）。

感谢 Simon 林开源这套高质量的 A 股数据工具集——它让 mx-skills 在妙想付费配额耗尽时拥有了可靠的免费降级源，也补齐了龙虎榜、解禁日历、北向资金、题材归因等 mx-skills 原本不覆盖的能力。如果它帮到了你的投研工作流，欢迎到上游赞赏作者。

所有分析仅供参考，不构成投资建议。股市有风险，投资需谨慎。