熔岩 · 消息面热度监测 API

4 步上手（不用写代码）

1. 登录熔岩：打开 熔岩，登录你的账号。
2. 拿 API Key：左侧点「AI数据服务」→ 上方点「API Key」→ 点「创建」。
   API Key＝你的专属钥匙（lvk_ 开头），只显示一次，请马上复制保存。第一次创建会自动送 100 元代金券。　直接去拿 Key →
3. 接到 AI 办公软件：按下面对应软件的步骤，把「地址」和「Key」填进去。
4. 新建对话直接问：例如「宁德时代最近一周消息面热不热？」「固态电池概念里哪些股票被提到最多？」

接到 AI 办公软件（MCP）

MCP＝让 AI 办公软件直接调数据的接口。装好后，你像平时聊天一样提问，AI 会自己去熔岩查数据。

{
    "mcpServers": {
        "lava": {
            "type": "streamable-http",
            "url": "https://lava.ai-dolphin.com/subscribe/v1/mcp",
            "headers": {
                "Authorization": "Bearer lvk_你的Key"
            }
        }
    }
}

豆包办公（豆包电脑版 · 豆包工作）

1. 打开豆包电脑版，进入「豆包工作」，左侧点「技能 · 连接器 · 伙伴」（部分版本叫「插件 · 技能 · 伙伴」）。
2. 点右上角「新建」（或「管理」→「+ 添加」）→「新建自定义连接器」。
3. 服务名称填 lava；传输类型选 HTTP；服务器 URL 填上面的地址。
4. 「自定义 Headers」点添加：名称 Authorization，值 Bearer lvk_你的Key。
5. 点「保存」，确认 lava 右边的开关已打开。
6. 点「新工作任务」开始提问；运行位置保持「本地电脑」。

WorkBuddy

1. 打开 WorkBuddy，左侧点「连接器」（部分版本在「插件」→「MCP 服务器」）。
2. 点右上角「自定义连接器」（或「配置 MCP」）。
3. 新建远程 MCP：名称填 lava，传输方式选 Streamable HTTP（或 HTTP），地址填上面的地址。
4. 请求头添加 Authorization = Bearer lvk_你的Key；如果看到的是 JSON 编辑框，直接粘贴上面的 JSON。
5. 保存，状态变绿（已连接）就成功了。
6. 新建一个任务开始提问。

千问办公

1. 打开千问办公电脑版，左侧点「扩展」→「连接器」。
2. 点右上角「+ 添加」→「粘贴 JSON 配置」。
3. 粘贴上面的 JSON（先把 lvk_你的Key 换成你的 Key），点「导入」。
   也可以选「手动填写配置」：类型选 Streamable HTTP，填地址，再点「+ 添加 Header」填 Authorization 和 Bearer lvk_你的Key。
4. 到「已安装」→「自定义」，打开 lava 的开关。
5. 新建一个对话再提问（旧对话里不会生效）。

各软件版本不同，按钮名字可能略有差别，找「连接器 / MCP / 自定义」相关入口即可。

连不上？依次检查：① Key 复制完整；② Bearer 后面有空格；③ 连接器开关已打开；④ 新建对话再问；⑤ 在「AI数据服务」看余额是否还有。

小词典（看不懂的词）

• API Key：你的专属钥匙，lvk_ 开头，用来认出你并扣费。不要发给别人；丢了就删掉重建。
• MCP：让 AI 办公软件直接调数据的接口。
• Streamable HTTP：MCP 的联网方式，添加时选它（豆包里叫 HTTP）。
• 请求头（Header）：随请求一起发过去的附加信息，Key 就填在这里。
• API：给程序调用的数据接口。不写代码的话可以不管它。
• 消息面热度：一只股票或一个概念最近被提到多少次、有多少机构/大V提到。
• 机构/大V ID（agency_id）：机构/大V的匿名编号（AG 开头）。同一个机构/大V永远是同一个编号，但看不出真实名称。
• 机构/大V分：按历史表现给机构/大V打的分，大约 450~1500，1000 左右算中等。
• PIT：只用当时已经知道的数据算出来的历史分数，不会“偷看未来”，适合做回测。
• 按次计费：每成功请求一次扣一次钱，约 1000 次 5 元；失败的请求不扣钱。

概览（能查什么）

• 查什么：A 股个股和概念板块的消息面热度——被提到几次、有多少机构/大V提到、什么时候提到的。
• 给什么：结构化文字（一句话摘要 + 要点 + 涉及的股票/概念）+ 匿名机构/大V ID 和机构/大V分。没有多空观点，没有原文，不荐股。
• 怎么用：不写代码→用上面的 MCP 接到 AI 办公软件；写代码→调用只读接口，地址前缀 https://lava.ai-dolphin.com/subscribe/v1。
• 给 AI 读的说明：OpenAPI（接口说明书）、llms.txt（给大模型看的简介）、技能模板。

写代码调用（开发者）

1. 按上面「4 步上手」拿到 API Key（熔岩左侧「AI数据服务」→「API Key」→「创建」）。可建多个 Key，随时删除。
2. 在请求头带上 Key，调用接口，例如：

curl -H "Authorization: Bearer lvk_xxxxxxxx" \
  "https://lava.ai-dolphin.com/subscribe/v1/opinions?stock_name=宁德时代&days=7"

MCP 参数（技术细节）

分软件的图文步骤见上方 接到 AI 办公软件。这里是完整参数：全部工具只读；AI 每调用一次工具算 1 次请求，查余额（get_account）不算钱。

{
    "mcpServers": {
        "lava": {
            "type": "streamable-http",
            "url": "https://lava.ai-dolphin.com/subscribe/v1/mcp",
            "headers": {
                "Authorization": "Bearer lvk_你的Key"
            }
        }
    }
}

工具列表：

• get_stock_news_heat：个股消息面热度：某只股票最近被提到的记录
• search_news_flow：按关键词搜消息面记录
• get_concept_stock_heat：概念板块热度：某个概念里哪些股票被提到最多
• get_stock_concept_heat：个股概念热度：某只股票关联哪些概念最热
• get_agency_ranking：匿名机构/大V评分排行（当前）
• get_agency_pit：匿名机构/大V历史截面评分（PIT）
• get_agency_history：单个匿名机构/大V的历史评分走势（PIT）
• list_agency_pit_dates：有历史评分（PIT）的日期列表
• get_account：查余额和用量（不扣钱）

技能模板（教 AI 怎么查热度）：https://lava.ai-dolphin.com/subscribe/v1/skill（可另存为 SKILL.md 导入支持技能的软件）。

鉴权（怎么带上 Key）

鉴权＝证明“是你在调用”。

• 在请求头带上 Authorization: Bearer <key>（也可以用 X-API-Key: <key>）。Key 不能放在网址里。
• 可选：创建 Key 时限定数据范围（scope：opinions 消息面 / agencies 机构/大V / concepts 概念板块），或只允许某些 IP 使用（IP 白名单）。不懂就保持默认。
• 别把 Key 写进网页前端代码或发到群里。

怎么收费

1. 先送 100 元代金券：第一次创建 Key 时自动到账（每个账号一次）。
2. 按请求次数扣费：每次 0.005 元，约 1000 次 5 元，从余额里扣。
3. 不扣钱的情况：请求失败（参数错、查不到、Key 不对、服务出错）；查余额。
4. 余额用完：会提示“余额不足”（HTTP 402 INSUFFICIENT_BALANCE），到熔岩「AI数据服务」→「概览与充值」用微信充值即可。

开发者：每次响应头会带 X-Billing-Charged-Yuan（本次扣费）和 X-Balance-Yuan（剩余余额）。

接口列表（开发者）

接口＝程序取数据的网址。用 AI 办公软件的话不用看这部分，AI 会自己调用。

GET /subscribe/v1/opinionsscope: opinions

按股票查最近一段时间的消息面记录：一句话摘要、要点、涉及的股票/概念、匿名机构/大V ID 和机构/大V分；同时给出被提到几次、有多少机构/大V提到等热度数字。不含多空观点、不含原文。

GET /subscribe/v1/opinions/searchscope: opinions

在要点里搜关键词（最多 5 个词，用空格隔开，要全部包含），最新的排在前面。

GET /subscribe/v1/agencies/rankingscope: agencies

机构/大V用不变的匿名编号 agency_id 表示；返回机构/大V分（约 450~1500，1000 左右算中等）、有效样本数、胜率等。

GET /subscribe/v1/agencies/pitscope: agencies

查某一天当时的机构/大V分（PIT＝只用那天已经知道的数据计算，不会“偷看未来”），适合回测。返回不晚于 as_of_date 的最近一个已发布日期的数据。

GET /subscribe/v1/agencies/{agency_id}/historyscope: agencies

按日期从早到晚，返回这个匿名机构/大V每个发布日的评分。

GET /subscribe/v1/agencies/datesscope: agencies

从新到旧列出已发布的评分日期，以及当天有多少机构/大V。

GET /subscribe/v1/concepts/stocksscope: concepts

统计最近一段时间，某个概念下每只股票被提到几次、有多少机构/大V提到（数据约 10 分钟更新一次）。

GET /subscribe/v1/concepts/by-stockscope: concepts

统计最近一段时间，某只股票关联的各个概念被提到几次、第一次和最近一次被提到的时间、有多少机构/大V提到。

GET /subscribe/v1/account不计费

返回余额、单价、预计还能调用几次、今天调用了几次。查这个不扣钱。

结构化记录字段（opinions 系列 data.list[]）

响应格式（开发者）

所有接口都返回同样的外层结构：ok 是否成功、code 结果码、data 数据、meta 附加信息。HTTP 状态码与 code 一致：

{
    "ok": true,
    "code": "OK",
    "message": "success",
    "data": {
        "count": 1,
        "list": [
            "…"
        ]
    },
    "meta": {
        "api_version": "v1",
        "request_id": "req_0123456789abcdef",
        "server_time": "2026-10-27T10:00:00+08:00",
        "billing": {
            "charged_yuan": "0.005",
            "balance_yuan": "99.995"
        }
    }
}

{
    "ok": false,
    "code": "INSUFFICIENT_BALANCE",
    "message": "余额不足：代金券/余额已用完，请充值后再调用",
    "data": null,
    "meta": {
        "api_version": "v1",
        "request_id": "req_0123456789abcdef",
        "server_time": "2026-10-27T10:00:00+08:00"
    },
    "error": {
        "balance_yuan": "0.003",
        "price_per_call_yuan": "0.005"
    }
}

错误码（出错时看这里）

匿名化说明

机构/大V只用匿名编号 agency_id 表示（AG + 12 位字母数字），每条记录用 opinion_id 表示。同一个机构/大V永远是同一个编号（跨接口、跨日期都不变，可以拿来做关联和回测），但看不出、也反推不出真实名称。