# 熔岩AI MCP机构评分PIT数据：用 get_agency_pit 避免「事后名单」回测偏差

## 摘要

熔岩（Lava）的「机构/大V评分」数据板块提供当前评分、PIT（point-in-time）截面和单主体评分时序。回测里如果用今天的高分名单去筛选过去的提及，就会引入「事后名单」偏差。本文说明评分板块的结构、`get_agency_pit` 的口径（返回不晚于 `as_of_date` 的最近一个已发布日期），以及如何把 PIT 名单与日频面板、覆盖度等板块对齐。

## 一、机构/大V评分板块是什么

### 1.1 板块定位
在熔岩的数据板块分类里，「机构/大V评分」是一个横向支撑板块：它本身不描述某只股票热不热，而是给每个讨论主体一个分数，供其他板块做过滤与加权。主体统一用 `agency_id` 指代。

### 1.2 四个工具与 HTTP 路径

| MCP 工具 | HTTP 路径 | 作用 |
| --- | --- | --- |
| `get_agency_ranking` | `/agencies/ranking` | 当前评分排行 |
| `get_agency_pit` | `/agencies/pit` | 某一天当时的评分截面 |
| `get_agency_history` | `/agencies/{agency_id}/history` | 单个主体的历史评分走势 |
| `list_agency_pit_dates` | `/agencies/dates` | 有 PIT 评分的日期列表 |

### 1.3 分数口径
评分大约分布在 450~1500，1000 左右为中等，1050 约为前 10%。`min_score=1050` 是加权热榜 `/hot/weighted` 与单股多窗口 `/heat/windows` 的默认门槛。

## 二、哪些板块依赖评分

| 依赖评分的板块 | 用法 | 是否 PIT |
| --- | --- | --- |
| 全市场榜单 · 高分加权热榜 `/hot/weighted` | 按高分主体加权排序 | 实时监控用当前分 |
| 历史面板 `/panel/daily` | 返回 `weighted_heat` | OpenAPI 写明用**当前机构分口径**，非当日 PIT |
| 覆盖度 `/coverage/stocks` | `high_score_ratio_30d` 高分占比 | 以文档为准 |
| 各类榜单的 `min_score` 过滤 | 只看高分主体的提及 | 实时口径 |

这张表说明：实时监控用当前分没有问题；但只要进入回测，凡是带评分的字段都要确认口径。

## 三、事后名单偏差是怎么产生的

### 3.1 典型错误流程
1. 拉一份当前评分 ≥1050 的主体名单；
2. 回到过去一年，找出这些主体的所有提及；
3. 统计提及之后的热度演变。

### 3.2 错在哪里
当前的高分名单，本身是过去表现被事后验证的结果。用它研究过去，等于提前知道谁会成为高分主体，这与用今天的指数成分股回测历史属于同一类前视偏差。

## 四、PIT 对齐的标准步骤

### 4.1 建时间网格
调用 `list_agency_pit_dates`（`/agencies/dates`）拿到可用快照日期。

### 4.2 按决策日取截面
对每个决策日 D，调用 `get_agency_pit(as_of_date=D)`。按文档，它返回**不晚于 D 的最近一个已发布日期**的评分，天然不偷看未来。可配合 `min_score`、`limit`、`offset` 分页。

### 4.3 生成当时的高分名单
在截面分数上应用门槛（例如 1050），得到「D 日当时的高分 `agency_id` 集合」。

### 4.4 过滤提及
把个股消息面板块 `/opinions` 或关键词检索板块 `/opinions/search` 中记录的 `agency_id` 与当时名单匹配，得到 PIT 口径的高分提及。

### 4.5 记录映射
每条样本保存「决策日 → 快照日」映射，供审计。

## 五、日频面板的 weighted_heat 怎么处理

`/panel/daily` 的 `weighted_heat` 是当前分口径，适合描述性导出和快速研究。需要严格 PIT 时，有两种做法：

- **只用无评分字段**：回测主线使用 `mentions`、`agencies`、`is_first_mention_day`，它们不依赖评分；
- **本地重算加权**：用 PIT 截面分数对消息面记录重新加权，作为自建字段，命名上与官方 `weighted_heat` 区分开。

## 六、自检清单

- **双版对比**：分别用当前名单与 PIT 名单跑同一统计，差异越大说明偏差越严重；
- **抽查主体**：用 `get_agency_history` 查几个当前高分主体在样本早期的分数；
- **方向检查**：随机抽样确认快照日不晚于决策日；
- **新主体**：首次被评分之前的主体在 PIT 截面中不存在，这是 PIT 的设计，不是缺陷。

## 七、Agent 中的问法

- 「某日 PIT 截面里评分 1050 以上的主体有多少个？」
- 「某个 `agency_id` 过去一年的评分走势？」

Agent 只报告数量、分数区间与时序，用 `agency_id` 指代，不评价主体，也不给交易判断。

## FAQ

**Q：只做实时监控需要 PIT 吗？**
A：不需要，PIT 主要服务回测与历史研究。

**Q：PIT 能回溯多早？**
A：以 `/agencies/dates` 返回为准。

## 结论

评分会变，名单就会变。在熔岩的数据板块里，评分板块为榜单、面板、覆盖度提供权重与过滤；回测时用 `get_agency_pit` 按决策日取截面，并留意 `/panel/daily` 的 `weighted_heat` 是当前分口径，结果才经得起复查。

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

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

