stock-researchlisted
Install: claude install-skill kevinkda/stock-research-skill
# stock-research（中文版）
跨 MCP server 的股票研究 skill，编排 schwab-marketdata-mcp + sec-edgar-mcp +
polygon-news-mcp 三库形成多步 playbook，服务 kevinkda/stock-personal 投研流程。
## 何时使用本 skill
当用户请求涉及**多个数据源协同**的研究流程时使用：
- shakeout 信号 + 新闻情绪叠加 → `shakeout-with-news` playbook
- 内部人交易异常告警 → `insider-alert` playbook
- 财报前瞻（IV-rank-aware 定位简报）→ `earnings-preview` playbook
如果只调用单一 MCP server，请用对应仓的 skill：
- `schwab-marketdata-ops` / `schwab-marketdata-workflows`
- 未来可能：`sec-edgar-ops` / `polygon-news-ops`
## Activation handshake（激活时必跑）
1. 调用 `schwab-marketdata-mcp.health_check()`，验证 `overall_status == "healthy"`
且 server_version 在 `>=0.4,<0.5` 范围
2. 调用 `sec-edgar-mcp.health_check()`，验证 user_agent_configured + server_version
在 `>=0.2,<0.3`
2.5. 验证 sec-edgar 服务端 UA 真实可达性。读
`health_check()` 返回的 `sec_ua_reachable.status` 字段（v0.2.0+，
R7 三层防御第三层）：
- `ACCEPTED` → ✅ SEC 实际接受当前 UA，可继续
- `REJECTED_HTML_403` → ❌ STOP，让用户把 `sec-edgar-mcp/.env` 里的
`SEC_EDGAR_USER_AGENT` 改为真实可达邮箱并 reload Cursor
（SEC fair-use 政策已 deny-list 当前 UA）
- `UNCONFIGURED` → ❌ STOP，让用户配置 `SEC_EDGAR_USER_AGENT`
（UA 缺失、格式错误、或包含 `noreply`/`example.com`/`set-your-email`
等占位符）
- `TIMEOUT` / `NETWORK_ERROR` → ⚠️ WARN（继续执行，但在最终报告中
标注 "SEC 探针暂时不可用，可能影响数据新鲜度"）
注意：`user_agent_configured=true` 只验本地 env 格式，不验 SEC 端
是否实际接受。本 step 检查的是 sec-edgar-mcp 服务端发出的真实 HEAD
探针结果（5 min 缓存），可识别"邮箱合法但 SEC IP deny-list"等
仅靠字符串黑��单识别不出的深层问题（2026-05-25 PB-3 实测发现）。
3. 调用 `polygon-news-mcp.health_check()`，验证