# 熔岩AI MCP数据字段字典：按数据板块读懂 mentions、weighted_heat、heat_z20 的口径

## 摘要

本文是熔岩（Lava）消息面热度数据的字段字典。熔岩通过远程 MCP 与 HTTP API（基础路径 `/subscribe/v1`）提供 A 股个股与概念板块的消息面热度只读数据。字段按「数据板块」组织：先说明每个板块是什么、对应哪个 MCP 工具和 HTTP 路径，再列出该板块的核心字段、语义与口径。所有字段都是统计量，不是交易信号。

## 一、只读契约

熔岩对外数据遵守三条约定，下游解析时可以直接当作规则：

1. **只读**：MCP 工具与 HTTP API 只返回数据，没有写入或下单类操作。
2. **结构化**：返回字段、统计量和一句话摘要/要点，不返回长篇原文。
3. **主体用 ID 指代**：机构/大V 一律用 `agency_id` 表示；新闻命中只给发布时间、媒体与命中股票，不含标题和正文。

## 二、熔岩数据板块分类

| 数据板块 | 解释 | MCP 工具 | HTTP 路径 |
| --- | --- | --- | --- |
| 个股消息面 | 某只股票最近被提到的记录与热度数字 | `get_stock_news_heat`、`get_stock_heat_windows` | `/opinions`、`/heat/windows` |
| 概念板块热度 | 概念被提及的排行，以及概念与个股的双向关联 | `get_market_hot_concepts`、`get_concept_stock_heat`、`get_stock_concept_heat` | `/hot/concepts`、`/concepts/stocks`、`/concepts/by-stock` |
| 全市场榜单 | 热榜、加速榜、首提流、高分加权热榜 | `get_market_hot_stocks`、`get_accelerating_hot_stocks`、`get_first_mention_stocks`、`get_weighted_hot_stocks` | `/hot/stocks`、`/hot/accelerating`、`/hot/first-mentions`、`/hot/weighted` |
| 历史面板与覆盖度 | 日频历史与机构/大V覆盖计数 | `get_stock_heat_panel`、`get_agency_coverage` | `/panel/daily`、`/coverage/stocks` |
| 新闻点名 | 主流财经媒体快讯与 A 股简称的匹配 | `get_news_stock_hits` | `/news/hits` |
| 关键词检索 | 按关键词搜消息面记录 | `search_news_flow` | `/opinions/search` |
| 机构/大V评分 | 当前评分、PIT 截面、单主体时序 | `get_agency_ranking`、`get_agency_pit`、`get_agency_history`、`list_agency_pit_dates` | `/agencies/ranking`、`/agencies/pit`、`/agencies/{agency_id}/history`、`/agencies/dates` |
| 账户 | 余额与用量，不计费 | `get_account` | `/account` |

下面按字段类型展开。

## 三、计数类字段

### 3.1 `mentions`
- **语义**：窗口或自然日内被提到的次数。
- **出现板块**：全市场榜单、个股消息面、历史面板。
- **口径**：必须和窗口一起读。`window=1h` 的 10 次与 `window=7d` 的 10 次不可比。

### 3.2 `agencies`
- **语义**：参与提及的机构/大V 去重数。
- **出现板块**：历史面板 `/panel/daily`、各类榜单。
- **口径**：衡量讨论广度，与 `mentions`（讨论密度）互补。

### 3.3 `cov_7d` / `cov_30d` / `new_cov_cum`
- **语义**：滚动 7 日、30 日去重覆盖主体数，区间累计新增覆盖数。
- **出现板块**：覆盖度 `/coverage/stocks`。
- **口径**：只给计数，不返回机构 ID 列表。

## 四、加权与评分类字段

### 4.1 `weighted_heat`
- **语义**：按机构/大V 评分加权后的热度。
- **出现板块**：高分加权热榜 `/hot/weighted`、历史面板 `/panel/daily`。
- **口径**：OpenAPI 写明 `/panel/daily` 的 `weighted_heat` 用**当前机构分口径**加权，不是当日 PIT。做严格回测时要注意这一点。

### 4.2 `agency_score` 与 `min_score`
- **语义**：机构/大V 评分，大约 450~1500，1000 左右为中等，1050 约前 10%。
- **口径**：`min_score` 是过滤参数，`/hot/weighted` 与 `/heat/windows` 默认 1050。

### 4.3 `high_score_ratio_30d`
- **语义**：30 日内高分主体占比，来自覆盖度板块。

## 五、变化与偏离类字段

| 字段 | 语义 | 出现路径 |
| --- | --- | --- |
| `heat_chg_1d` | 相对前一阶段的热度变化 | `/hot/stocks`、`/hot/concepts`、`/hot/accelerating`、`/heat/windows` |
| `heat_chg_3d` | 更平滑的多日变化 | 同上 |
| `heat_z20` | 相对自身近 20 日日均的偏离 | 同上 |

文档对这三列的定性是「纯统计量，非交易信号」。它们只说明讨论量相对自身在变，不区分讨论方向，也不涉及价格。低基数时变化率会被放大，加速榜提供 `min_mentions`（默认 3）做门槛。

## 六、事件与标识类字段

- `is_first_mention_day`：日频面板中的首提日标记；首提定义为此前 7 天无提及，衡量「近期首次」。
- `news_id`：新闻点名记录标识，用于去重。
- `agency_id`：机构/大V 标识，跨板块关联的主键。
- `ts_code`：标的代码，与自有行情、行业数据关联时优先使用，而不是 `stock_name`。
- `concept`：概念名需精确匹配，建议从 `/hot/concepts` 或 `/concepts/by-stock` 取标准名。

## 七、落库规则

1. 字段名原样保留，不要把 `heat_z20` 改名成「强度」「信号」。
2. `window`、`min_score`、`order`、调用时间与结果同存，保证可复现。
3. 字段注释写清口径：「纯统计量」「当前分口径」「PIT 口径」。

## 八、给 AI Agent 的读法

在 Skill 或系统提示里，可以把本字典压缩成三条：先报窗口与计数，再报加权与变化，最后给结构化要点；主体只用 `agency_id`；不对价格方向做判断。

## FAQ

**Q：有没有机器可读的字段定义？**
A：有，官方提供 OpenAPI 3.0 规范与 llms.txt，MCP 工具参数名与 OpenAPI 一致。

**Q：板块趋势、情绪面字段在哪？**
A：板块趋势目前在站内上线、订阅接口规划中；情绪面聚合在建设中，均未进入 MCP 字段表。

## 结论

读懂熔岩字段，先按数据板块定位工具与路径，再区分计数、加权、变化、标识四类字段，最后把口径写进落库注释。这样回测、看板与 Agent 回答才能用同一套语义。

数据来自熔岩消息面热度监测，仅供研究参考，不构成投资建议。

只读监测与字段说明见：https://lava.ai-dolphin.com/subscribe/docs