Enlvon API

把中国电力的政策、电价与标准，以结构化、可溯源的方式供给你的程序与 AI。所有接口返回 JSON；每一条结论都附带政府原文链接。

Base URL https://enlvon.com

快速开始

1. 在申请内测页面免费获取 API Key（enl_ 开头）。检索接口没有 Key 也可调用，走每 IP 每天 5 次的匿名额度；问答接口须携带 Key。

2. 发起第一次问答：

# 一条命令，得到带引用的结构化答案 curl "https://enlvon.com/api/ask?q=煤电容量电价现在什么标准" \ -H "X-API-Key: YOUR_API_KEY"

3. 返回包含 answer（带 [编号] 引用的答案）与 references（结构化引用资料，含政府原文链接）。也可以先在工作台里可视化地试，每次请求都会同步生成对应的 cURL / Python 代码。

鉴权与额度

鉴权只认请求头 X-API-Key: enl_…（不接受在 URL 上传 Key，避免日志与浏览历史泄露）。网页端支持邮箱 / 手机验证码登录，登录后自动签发个人 Key 供网页使用。 MCP 与程序化接入请通过申请内测获取专用 API Key。

模式	检索 /api/search	问答 /api/ask
匿名（按 IP）	5 次 / 天	需登录
网页登录 Key	20 次 / 天	3 次 / 天（独立计数）
API Key（申请）	按 Key 配置的额度；用于 MCP 与程序化接入

额度为公测期设置，后续可能调整。超出额度返回 429；无效或缺失 Key 返回 401。

问答

GET/api/ask需鉴权

跨文档合成答案：先在结构化语料库中检索相关政策，再合成一段带 [编号] 引用的答案。资料不足时会明确说明缺口，不编造。

参数	类型	说明
q	string，必填	自然语言问题，如「独立储能的容量电价怎么算？」
top_k	int，默认 8（1–12）	用作依据的资料篇数

# Python import requests resp = requests.get( "https://enlvon.com/api/ask", params={"q": "新能源上网电价改革对售电公司有什么影响？"}, headers={"X-API-Key": "YOUR_API_KEY"}, ) data = resp.json() print(data["answer"]) # 带 [1][2] 引用的答案 for ref in data["references"]: # 引用对应的结构化资料 print(ref["标题"], ref["原文链接"])

检索

GET/api/search需鉴权

语义检索：按含义（而非仅关键词）查找文档，返回结构化卡片列表。支持按数据类型与来源过滤。

参数	类型	说明
q	string，必填	检索词，支持自然语言
top_k	int，默认 10（1–50）	返回条数
data_type	string，可选	政策 / 解读 / 新闻 / 统计数据
source	string，可选	ndrc（发改委）/ nea（能源局）/ gd / sd / sx / js / nmg / sc / yn / heb / hen / fj / nx / ah / hun

curl "https://enlvon.com/api/search?q=分时电价&data_type=政策&source=gd" \ -H "X-API-Key: YOUR_API_KEY"

返回字段说明

检索结果与问答引用中的每一条资料，都是同一种结构化卡片：

字段	类型	说明
标题 / 日期 / 来源	string	来源为标识符，如 ndrc、nea、gd
数据类型	string	政策 / 解读 / 新闻 / 统计数据 / 市场数据
地域	string[]	省份列表，全国性政策为 ["全国"]
核心要点	string[]	结构化提炼的要点
影响分析	string	按发电侧 / 储能 / 工商业用户等角色分述的影响
电价数值	object[]	{电价类型, 数值, 单位, 浮动范围, 执行时间}——可直接计算的电价事实
相关标签 / 电力实体	string[]	主题标签与涉及的机构/主体
原文链接	string	政府官网原文地址，每条资料可溯源
相关度	number	仅检索/问答结果中出现

MCP 接入 —— 让你的 AI 直接调用电力数据

Enlvon 提供标准 MCP（Model Context Protocol）服务：任何支持 MCP 的 AI 助手、Agent 或开发框架（Claude、Cursor、各类 Agent harness 等），都可以把 Enlvon 当作一组开箱即用的电力数据工具接入—— 你的 AI 从此能自己查政策、问电价。

工具	能力
enlvon_ask	跨文档问答，返回带引用的结构化答案
enlvon_search	语义检索结构化政策库

接入配置（Streamable HTTP）

// 通用 MCP 配置（mcp.json / 各客户端的 MCP 设置） { "mcpServers": { "enlvon": { "type": "http", "url": "https://enlvon.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } }

# Claude Code 一行接入 claude mcp add --transport http enlvon https://enlvon.com/mcp \ --header "X-API-Key: YOUR_API_KEY"

为什么这很重要：电力行业的数据到今天仍以「人读网页」的形态存在。 Enlvon 把它变成 AI 可直接调用的结构化工具——无论你在构建内部知识助手、行业 Agent，还是给现有系统加一层电力政策感知，都不必自己维护抓取与解析管线。

数据边界与合规

· 数据全部来自政府等权威公开渠道，每条资料附原文链接可溯源。
· API 只返回结构化摘要与原文链接，不返回、也不存储对外提供的原文全文。
· 问答在资料不足时会明确声明缺口，不编造结论；引用编号与资料一一对应，可逐条核验。