熔岩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