内容
# lava-mcp · 熔岩消息面热度监测
[](https://hookmcp.com)
[熔岩(Lava)](https://lava.ai-dolphin.com/subscribe) 提供 **A 股股票和概念板块的消息面热度监测** 结构化只读数据——支持 **量化交易工具** 与 **AI Agent 股市研究** 接入,通过远程 MCP / REST 调用。
> 只读 · 结构化要点 + 机构/大V ID(`agency_id`)· 新闻命中不含标题与正文
## 新手 3 步
① 登录熔岩(手机号 / Google)→ 左侧「AI数据服务」→「API Key」。首次进入「AI数据服务」时自动送代金券并生成「默认」Key。入口:https://lava.ai-dolphin.com/lava#/ai-data-service
② WorkBuddy 国内版 5.9.3 已实测浏览器 OAuth,无需手填 Key:https://lava.ai-dolphin.com/subscribe/docs#workbuddy 。API Key 方式:确认客户端支持自定义远程 MCP 后,地址填 `https://lava.ai-dolphin.com/subscribe/v1/mcp`(Streamable HTTP,请求头 `Authorization: Bearer lvk_你的Key`)。分软件步骤:https://lava.ai-dolphin.com/subscribe/docs#ai-office
③ 启用连接器并查看工具列表,新建任务先只调用 `get_account` 检查是否成功(熔岩不计费),然后再查询数据。
## 远程 MCP(推荐)
| 项 | 值 |
| --- | --- |
| 传输 | Streamable HTTP |
| Endpoint | `https://lava.ai-dolphin.com/subscribe/v1/mcp` |
| 鉴权 | 请求头 `Authorization: Bearer <API Key>`(或 `X-API-Key`);亦支持 OAuth 2.1(PKCE S256 + DCR) |
| 客户端 | 支持自定义远程 MCP 的客户端。WorkBuddy 国内版 5.9.3 已实测浏览器 OAuth 与 `get_account`(无需手填 Key) |
开通与计费见 [落地页](https://lava.ai-dolphin.com/subscribe):开通赠 100 元代金券;约 1000 次 = 5 元。
## 本地 Streamable HTTP 代理
[`proxy/server.py`](./proxy/server.py) 是可运行的薄代理(Python 3.9+,仅标准库)。它不实现熔岩的查询接口,只把 MCP 的 Streamable HTTP / JSON-RPC 原样转到官方端点,并附上 `Authorization: Bearer <LAVA_API_KEY>`。个股、概念和热榜数据仍来自 `https://lava.ai-dolphin.com`。
直接连接官方端点仍然是推荐方式。本地代理适合需要在本机审计转发代码,或客户端不方便单独配置远程请求头的时候。
```bash
export LAVA_API_KEY=lvk_你的Key
python3 proxy/server.py
```
默认监听 `http://127.0.0.1:8787/mcp`(只绑定本机)。
| 环境变量 | 说明 |
| --- | --- |
| `LAVA_API_KEY` | 熔岩 API Key。设置后,每个转发请求都带 `Authorization: Bearer <key>` |
| `LAVA_PROXY_PORT` | 监听端口,默认 `8787` |
| `LAVA_PROXY_HOST` | 监听地址,默认 `127.0.0.1`。监听非本机地址时还要设置 `LAVA_PROXY_ALLOW_REMOTE=1` |
| `LAVA_MCP_UPSTREAM` | 上游地址,默认 `https://lava.ai-dolphin.com/subscribe/v1/mcp` |
| `LAVA_PROXY_TIMEOUT` | 上游超时(秒),默认 `180`;`0` 表示不限制 |
客户端把 MCP 地址填成 `http://127.0.0.1:8787/mcp`,传输选 Streamable HTTP。Key 放在启动代理的环境里即可。未设置 `LAVA_API_KEY` 时,才会原样转发客户端自己的 `Authorization` 头。
```bash
curl -sS http://127.0.0.1:8787/health
curl -sS http://127.0.0.1:8787/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
```
`GET /health` 只检查代理进程,不访问上游。本地测试:`python3 -m unittest proxy.test_server`。
## Skill 模板
仓库内 [`SKILL.md`](./SKILL.md) 与线上官方模板对齐(live as of 2026-11-05:WorkBuddy 5.9.3 浏览器 OAuth、先调用 `get_account` 验证、手机号 / Google 登录)。官方模板:
https://lava.ai-dolphin.com/subscribe/v1/skill
安装锚点:https://lava.ai-dolphin.com/subscribe/docs#workbuddy · https://lava.ai-dolphin.com/subscribe/docs#ai-office
## 文档与机器可读规范
- 产品落地页:https://lava.ai-dolphin.com/subscribe
- API 文档(canonical):https://lava.ai-dolphin.com/subscribe/docs
- OpenAPI 3.0:https://lava.ai-dolphin.com/subscribe/v1/openapi.json
- llms.txt:https://lava.ai-dolphin.com/llms.txt
- MCP Registry:[`server.json`](./server.json)
- 本地代理:[`proxy/server.py`](./proxy/server.py)
- Glama:[`glama.json`](./glama.json) · 线上 `/.well-known/glama.json`
## 数据模块一览
熔岩同时有站内看板和订阅 API / MCP。数据是 **A 股机构/大V 舆情的结构化只读**:概念和标的给摘要要点,机构/大V 用匿名 `agency_id`。订阅落地页是 https://lava.ai-dolphin.com/subscribe ;文档、OpenAPI、MCP 与 Skill 都在同一域名下。
表中的工具名与本文以及线上 OpenAPI 一致。板块趋势和情绪面的订阅路径尚未开放。
| 模块 | 站内 | 订阅 API / MCP | 说明 |
| --- | --- | --- | --- |
| 个股消息面热度 | 个股页 / 市场热度 | `get_stock_news_heat`、`get_stock_heat_windows`、`search_news_flow` | 提及次数、机构/大V 覆盖、摘要要点 |
| 概念板块消息面热度 | 概念页 / 概念热榜 | `get_market_hot_concepts`、`get_concept_stock_heat`、`get_stock_concept_heat` | 概念提及排行,以及概念与个股互查 |
| 全市场热榜 / 加速 / 首提 / 高分加权 | 市场热度 | `get_market_hot_stocks`、`get_accelerating_hot_stocks`、`get_first_mention_stocks`、`get_weighted_hot_stocks` | 多时间窗;动量字段为纯统计量 |
| 日频热度面板 / 机构覆盖度 | 个股页 | `get_stock_heat_panel`、`get_agency_coverage` | 日频序列与覆盖计数,适合回测与导出 |
| 新闻点名 | — | `get_news_stock_hits` | 只返回 `news_id`、媒体、命中股票;无标题、无正文 |
| 机构/大V 评分(PIT) | 市场热度 | `get_agency_ranking`、`get_agency_pit`、`get_agency_history`、`list_agency_pit_dates` | 用 `agency_id`;分数大约 450~1500 |
| 板块趋势 | 站内已上线:侧栏「市场热度」→「板块热度」 | 站内可用 · 订阅接口规划中 | 消息热度 Δ、资金流入流出、价格指数与成分股;口径对齐东财/同花顺 |
| 情绪面(聚合) | 规划中 · 求准优先 | 规划中 | 对外只准备聚合统计;趋势线与订阅接口质量达标后再开放 |
### 板块趋势(站内已上线 · 订阅接口规划中)
左侧「市场热度」可以切到「板块热度」。默认页是剧烈变化追踪,同时看消息热度变化、资金流入流出和价格变化。点进板块后,详情给出近三个月的消息面、资金流、价格指数(有数据才画)和成分股提及。板块命名对齐东财/同花顺口径。
站内已上线。订阅接口规划中,目前以站内页面为准。

侧栏「市场热度 → 板块热度」:按消息热度变化、资金净流入和价格变化看板块;右侧是选中板块近三个月的消息提及、净流入和板块指数。

板块详情:近 1 小时 / 24 小时 / 7 日提及,近 30 日与近 24 小时的提及和机构/大V,近三个月消息、资金与指数,以及成分股提及排行。
### 个股 / 概念热度(站内 + MCP)
全市场热榜、热度加速、高分加权、首提、小时窗、日频面板和机构覆盖度都已经能通过上表里的 MCP / REST 工具读取。站内「市场热度」是同一套统计的预览。

全市场热榜的个股视图:1 小时到 7 天窗口内,按机构/大V 提及次数和人数排序,并给出 1 日变化、3 日变化和 z20。

个股页:日线与提及、多时间窗热度、近 24 小时走势、近 90 日提及面板、机构/大V 覆盖度,以及结构化要点。
### 情绪面(规划中 · 求准优先)
正在做机构/大V 观点的二维情绪聚合。两个轴彼此独立:多空是 `bull` / `bear` / `neutral`,情感面是 `calm` / `joy` / `fear` / `frustration` / `anger`。对外只提供聚合统计,方便量化研究和 AI Agent 接入。站内趋势线和订阅接口都在质量达标后再开放。
### 订阅落地页
开通、计费和能查什么,以落地页为准:https://lava.ai-dolphin.com/subscribe

落地页列出已经开放的能力:个股/概念消息面、全市场热榜、高分加权、首提流、小时热度窗、新闻点名、机构/大V 评分,以及 API / MCP 接入。
## 主要工具(MCP)
| Tool | 用途 |
| --- | --- |
| `get_stock_news_heat` | 个股消息面热度与结构化观点列表 |
| `search_news_flow` | 关键词检索消息面结构化记录 |
| `get_concept_stock_heat` | 概念 → 个股提及排行 |
| `get_stock_concept_heat` | 个股 → 概念提及排行 |
| `get_market_hot_stocks` | 全市场个股热榜;窗口内会附带 heat_chg_1d / heat_chg_3d / heat_z20 |
| `get_market_hot_concepts` | 全市场概念热榜;时间窗最长 `3d` |
| `get_weighted_hot_stocks` | 高分机构/大V加权热榜;默认 `min_score` 1050、`order=weighted` |
| `get_first_mention_stocks` | 首提流:此前 7 天无提及、窗口内第一次被提到的 A 股 |
| `get_stock_heat_windows` | 单股多时间窗热度 + 逐小时 + 来源拆分 |
| `get_accelerating_hot_stocks` | **热度加速榜**:按 heat_chg_1d / heat_chg_3d / heat_z20 动量排序 |
| `get_stock_heat_panel` | **日频历史面板**:日频 mentions / agencies / weighted_heat,适合回测与导出 |
| `get_agency_coverage` | **机构覆盖度**:覆盖机构数时序与 7/30 日去重、新增覆盖(只给计数) |
| `get_news_stock_hits` | 新闻命中个股:`news_id`、发布时间、媒体、命中股票;不含标题与正文 |
| `get_agency_ranking` / `get_agency_pit` / `get_agency_history` / `list_agency_pit_dates` | 机构/大V评分(当前 / PIT / 时序) |
| `get_account` | 余额与用量(不计费) |
参数名与线上 MCP / OpenAPI 一致。机构/大V分大约 450~1500,1000 左右为中等,1050 约前 10%。
### `get_accelerating_hot_stocks`
在全市场热榜候选上计算动量,并按变化降序。字段为纯统计量,便于量化因子与监控。
| 参数 | 说明 |
| --- | --- |
| `window` | `1h` / `4h` / `18h` / `24h` / `3d` / `7d`,默认 `24h` |
| `order` | `chg1d`(默认)/ `chg3d` / `z20` |
| `min_mentions` | 最低提及门槛,默认 3 |
| `market` | `ashare`(默认)/ `all` |
| `limit` | 返回条数,默认 50,最大 200 |
### `get_stock_heat_panel`
按自然日聚合个股或概念的 mentions、agencies、weighted_heat、is_first_mention_day。区间最长 92 天,单次最多 20 个标的。
| 参数 | 说明 |
| --- | --- |
| `type` | `stock`(默认)/ `concept` |
| `stock_name` / `ts_code` / `concept` / `codes` | 标的选择(见 OpenAPI) |
| `days` 或 `start_date`/`end_date` | 回看区间 |
### `get_agency_coverage`
返回每日滚动 7/30 日去重机构/大V数、区间累计新增覆盖、30 日高分占比。只给计数,不返回机构 ID 列表。
| 参数 | 说明 |
| --- | --- |
| `stock_name` 或 `ts_code` | 必填其一 |
| `days` | 时序天数,默认 30,范围 7~90 |
| `min_score` | 可选;高分占比计算用 |
### 其他热榜 / 首提 / 新闻点名
详见线上文档与 OpenAPI:`get_market_hot_stocks`、`get_weighted_hot_stocks`、`get_first_mention_stocks`、`get_stock_heat_windows`、`get_news_stock_hits`。
## License
本仓库采用 [MIT License](./LICENSE)。
文档与 Skill 模板以站点公开内容为准(live as of 2026-11-05)。查询结果来自 lava.ai-dolphin.com;本仓库里可运行的服务端代码是本地转发代理 [`proxy/server.py`](./proxy/server.py)。
连接信息
猜你喜欢
暂无推荐服务器