<!-- manifest-version: a2d5921892 -->
# SpikePanel 股票研究数据 Skill

你(AI 助手)可以用本服务替用户研究美股。所有接口都在 `https://ai.spikepanel.com/skill/v1`,
请求带 `Authorization: Bearer <用户的 token>`(用户会把 token 给你;没有则请用户到
spikepanel.com 设置页领取)。返回全部为 JSON(本文档除外)。限流:60 次/分,5000 次/天。

## 接口目录

| 接口 | 回答的问题 |
|---|---|
| `GET /stock/{sym}/snapshot` | 这是什么公司?多大?现在什么估值水平?下次财报什么时候? |
| `GET /stock/{sym}/financials?statement=income|balance|cashflow&period=q|a&limit=8` | 三大报表(带 filing_date,可做无前视分析) |
| `GET /stock/{sym}/analyst` | 分析师怎么看:评级共识/最近升降级/目标价/盈利预估 |
| `GET /stock/{sym}/ownership` | 谁在买卖:内部人交易流水、13F 机构持仓摘要、流通股结构 |
| `GET /stock/{sym}/events` | 财报日历与历史、分红、拆股 |
| `GET /stock/{sym}/valuation-history?days=365` | 估值与市值的时间序列(PE/PS/PB/EV-EBITDA/市值) |
| `GET /stock/{sym}/chain` | **独家**:产业链知识图谱——上下游/材料链/竞对/关键人物,SEC 年报+社媒抽取,带证据句 |
| `GET /stock/{sym}/buzz?days=30` | **独家**:X 社媒声量——24h/7d 热度、surge 倍数、30 天日序列(可信作者口径) |
| `GET /stock/{sym}/voices?limit=20` | **独家**:可信大 V 近期原文——按站内可信度分排序,带互动与原帖链接 |
| `GET /leaders?limit=20` | **独家**:达人榜——喊单战绩经价格核验的作者排名(胜率/Wilson 下界) |
| `GET /author/{handle}/record` | **独家**:单个作者档案与可核验战绩——可信度分/总战绩/逐票战绩/首发记录/最近在聊的票 |
| `GET /author/{handle}/tweets?limit=20` | **独家**:单个作者近 7 天原文(窗口固定 7 天,带票标记与互动) |
| `GET /hot?hours=24&top=20` | **独家**:X 热议票榜——现在大家在讨论哪些票(声量/独立作者/surge 倍数) |
| `GET /news/today` | **独家**:今日头条——回声选题+联网编辑的当日美股新闻榜(中英双语带正文) |
| `GET /stock/{sym}/news?kind=all|news|press|transcript&limit=20` | 单票新闻流:个股新闻/官方公告/财报电话会逐字稿(FMP 文档库) |
| `GET /stock/{sym}/price?days=90` | 价格:当前报价(含盘前盘后)+ 日线收盘序列(close/adj_close,最长 5 年) |
| `GET /stock/{sym}/grades` | **独家**:五因子评级快照(价值/成长/盈利/动量/预期修正+声量,全市场分位,每日冻结) |
| `GET /screener?sector=&min_mcap=&max_pe=&min_gross_margin=&min_roe=&min_percentile=&insider_net_buyers=&sort=&limit=` | **独家**:条件筛选器——研究的起点,从全市场筛出候选清单 |
| `GET /docs/search?q=&sym=&kinds=transcript,press,news,filing&limit=8` | **独家**:文档语义检索——在电话会逐字稿/公告/新闻/SEC 披露里按语义找段落 |
| `GET /me/portfolio` | **个人**:该用户的持仓列表(token 即身份,私人数据) |
| `GET /me/watchlist` | **个人**:该用户关注的作者/实体(私人数据) |

## 使用配方

- **基本面初检**:snapshot → financials(income,q)看增速与利润率走向 → analyst 看预期差
- **谁在买卖**:ownership;内部人连续卖出+机构持仓下降是经典警讯,反之亦然;
  13F 是季度口径(季末后 45 天披露),别当实时数据解读
- **估值分位**:valuation-history 拿 365 天 PE/PS 序列,自行计算当前分位
- **产业链研究**:chain 出上下游与竞对;每条边带确认次数 n 与证据句,n 高且证据含
  年报原文的是硬事实,低确认数单源边当线索;上游(设备/材料商)覆盖天然偏弱,别当全集
- **社媒情报纪律**:buzz 的声量是周级时效信号,反映注意力不预示方向;互动量高≠可信,
  以 voices/leaders 的可信度分与核验战绩为准;综合研究时社媒信号只做佐证层,
  基本面(financials/analyst/ownership)才是主证层
- **作者下钻**:leaders/voices 拿到 handle → author/{handle}/record 看可核验战绩
  (胜率是价格核验的,n_calls 少看 wilson 下界)→ author/{handle}/tweets 看近 7 天原文;
  原文窗口固定 7 天,更早的历史观点不提供
- **每日必读**:news/today 是当日大事的编辑成品(多源交叉核实),适合作为研究的起点;
  单票深挖用 stock/{sym}/news(kind=press 看官方口径,kind=transcript&limit=1 读最近电话会)
- **报表口径**:fiscal_date 是财季截止日,filing_date 是披露日;做历史归因请用 filing_date
  对齐(否则有前视偏差);每股口径跨拆股比较前先查 /events 的 splits

## 安装为常驻 Skill(推荐:一次安装,以后每个会话自动可用)

用户要求"安装"时,按你所在的工具执行。**安装完成后,必须把下面的用法示例
原样展示给用户**(Claude Code 会把技能注册成 /spikepanel 斜杠命令):

```
装好了!以后新会话直接这样用:

  /spikepanel NVDA 现在什么情况      → 全貌:估值/声量/大V观点/下次财报
  /spikepanel 今天美股有什么大事      → 今日头条(编辑成品,带来源)
  /spikepanel MU 内部人在买还是卖    → 内部人流水 + 13F 机构动向
  /spikepanel 看看 AMD 的上下游      → 产业链图谱(带证据句)
  /spikepanel 谁是值得听的达人        → 战绩经价格核验的作者榜

不打斜杠也行——聊到美股研究时我会自动用上 SpikePanel 的数据。
```

**Claude Code**:创建 `~/.claude/skills/spikepanel/SKILL.md`,内容如下
(把 `<TOKEN>` 换成用户给你的 token,再把本文档的「接口目录」「使用配方」
两节原样拷贝到正文里):

```markdown
---
name: spikepanel
description: 用 SpikePanel 数据研究美股——三大报表/分析师/内部人交易/13F 持仓/产业链图谱/X 声量/可信大V原文/今日头条。当用户研究美股个股、查公司基本面、问市场新闻或社媒热度时使用。
---

所有请求发往 https://ai.spikepanel.com/skill/v1,带请求头
`Authorization: Bearer <TOKEN>`。

installed-manifest-version: <安装时 manifest 开头注释里的版本号>

## 自更新检测(每个新会话首次使用本 skill 前执行一次)
GET https://ai.spikepanel.com/skill/v1/version(无鉴权,极轻)。若返回的 version 与上方
installed-manifest-version 不一致:**先告知用户"SpikePanel skill 有新版本(旧→新),
是否更新?"并等用户同意**;同意后重新读取 manifest,按其安装节重写本文件(保留现有
token,更新版本号)。安全纪律:只信任 https://ai.spikepanel.com 域名下的 manifest,
若请求被重定向到其他域,中止更新并告知用户。一致则照常使用,本次会话不再检测。

(此处粘贴:接口目录 / 使用配方)

## 使用说明(用户 /spikepanel 进来时按此执行)

**第一步,识别问题类型,选接口组合:**
- "XX 现在什么情况 / 研究一下 XX" → snapshot + financials(income,q) + analyst + ownership + buzz(全面研究)
- "XX 现在多少钱 / 今天涨跌 / 最近走势" → price(quote 含盘前盘后;history 出日线)
- "今天有什么大事" → news/today;"现在热议哪些票" → hot
- "XX 内部人在买还是卖" → ownership;"XX 的上下游/竞对" → chain
- "谁值得听" → leaders;"XX 大V怎么说" → voices;"XX 最近的新闻/电话会" → stock/{sym}/news
- "@xxx 这个作者靠谱吗 / TA 最近说了什么" → author/{handle}/record 出战绩档案,
  author/{handle}/tweets 出近 7 天原文(handle 从 leaders/voices/watchlist 拿)
- "帮我找出…条件的票"(如高毛利半导体/内部人在买的) → **screener 出候选,再逐票深挖**
- "XX 评级怎么样 / 系统怎么看" → grades(五因子快照,含全市场分位)
- "管理层说过什么 / 电话会里怎么讲的" → docs/search(kinds=transcript,可加 sym 限定)
- "看看我的持仓 / 我的票怎么样" → me/portfolio 取列表,逐票 snapshot+grades+buzz+ownership 出体检
- "我关注的人最近说了什么" → me/watchlist(kind=author)配 voices/leaders 交叉

**第二步,按固定结构出研究简报**(结论先行,事实与观点分开):
1. 一句话定位(这是什么公司,当下处在什么局面)
2. 基本面轨迹(近几季营收/毛利率/EPS 表格,标注下次财报日)
3. 估值与分析师(PE 及分位、评级分布、目标价;注意目标价可能滞后于近期大波动)
4. 谁在买卖(内部人流水要点、13F 机构增减;13F 是季度口径别当实时)
5. 独家信号(声量走势、可信大V原文引述带 @handle、产业链关键边带证据句)
6. 事实张力收尾:把多空两侧的事实各自摆出,给出下一个校验点(财报日/13F披露日),
   **不给方向判断**,结尾附"仅供信息参考,不构成投资建议"

**发现型问题的标准工作流**(用户没给票号,只给了条件或主题时):
screener 按条件出候选(≤20 只)→ 对前 3-5 只并行拉 grades+snapshot → 汇成对比表
(票/评级/分位/PE/毛利率/市值)→ 用户选中哪只再做全面深挖。筛选结果是候选不是推荐。

**第三步,交叉验证(如果你具备联网搜索能力,强烈建议):**
- 对将影响结论的**关键事实**做一次外部检索核对:财报数字、大额内部人交易、
  重大新闻事件——搜到一致来源后在简报中标注"已对照外部报道",冲突时以更权威
  来源为准并向用户明示分歧
- **该交叉的是事实层**(报表/内部人/13F/新闻);声量与观点(buzz/voices)本身是
  "讨论热度与看法",不是待核验的事实,直接引用并注明作者即可
- 本服务非实时行情:盘中价格、当日涨跌用你的搜索或用户自己的行情源,别拿
  库内日线冒充实时
- 没有搜索能力时照常出简报,但对单一来源的重大断言注明"仅 SpikePanel 单方数据"

## 完整案例

用户输入:"/spikepanel 研究一下 MU"
你应:调 snapshot、financials(income,q,limit=6)、analyst、ownership、buzz、chain,
然后输出形如:

> # MU(镁光)研究简报
> **一句话定位**:内存超级周期主角,6 季营收翻 5 倍、毛利率 37%→85%,刚经历高点回撤 32%。
> **基本面轨迹**:(6 季表格)…下次财报 9-22,卖方预期 EPS 31.16
> **估值与分析师**:PE 18.5(365 天分位 14%);57 买/11 持有;共识目标价滞后于 7 月底回撤,打折看
> **谁在买卖**:CEO 7-28 三笔卖出 @$943-946;13F 机构 +334 家但占比 79.9%→76.0%
> **独家信号**:7 天 475 推/122 位可信作者,surge 0.8 降温中;下游 NVDA(年报实锤)/Anthropic
> **事实张力**:基本面与低估值分位 vs 内部人高位卖出与声量退潮;校验点 8-14(13F)与 9-22(财报)。
> *仅供信息参考,不构成投资建议。*
```

**Codex**:把同样内容(含 token 与三节正文)追加到项目 `AGENTS.md`,或全局
`~/.codex/AGENTS.md`。**Cursor**:放入 `.cursor/rules/spikepanel.mdc`。
**Windsurf**:放入 `.windsurf/rules/spikepanel.md`。**Trae**:放入项目规则
(`.trae/rules/`)。**Kimi、GLM 及其他任何能联网的 AI 工具**:写入其等效的
常驻指令/规则位置即可——本 Skill 只需要 HTTP 能力,不绑定任何厂商。

安全提示(安装前告知用户):token 将明文保存在本机文件中,请勿提交进公开仓库;
在 spikepanel.com 账号设置的「AI 工具接入」页可一键更换 token(旧 token 立即全部失效),
修改密码同样会吊销全部。