智能数据接口服务

把国际能源信息数据库接入您的程序与智能助手。

服务介绍

通过能源信息 API 或 MCP 服务，按网站分类、标准标签、国家和发布日期查找资料。先检索能源资讯摘要与来源，再按账号权益读取已发布文章的正文和现有译文，接入研究程序或智能助手。

用户中心 · 数据接口使用说明

先选择接入方式

程序调用：API

适合 Python、企业系统和定时任务。在用户中心创建 API Key，通过 HTTPS 请求检索资料、获取文章或同步更新。

https://e.biaoshuds.com/data-api/v1

查看完整 API 示例 →

智能助手调用：MCP

适合 OpenClaw、WorkBuddy 等支持远程 MCP 的客户端。在用户中心创建 API Key，复制自动生成的完整 JSON，粘贴保存后即可用自然语言提出研究问题。

https://e.biaoshuds.com/mcp

查看 OpenClaw / WorkBuddy 接入步骤 →

API 与 MCP 共用账号月调用额度。检索、分类查询、获取更新和读取全文，每次成功调用计 1 次，重复调用和零条结果也计数。检索默认返回 20 条，一次返回多条只计 1 次，不设每日上限。

从一个具体问题开始

例如：“查找 2026 年 10 月 1 日至 10 日发布的 LNG 项目进展，先给我 20 条摘要和来源，等我选择后再读取全文。”天然气信息库对应 topic=gas；API 请求体如下，MCP 的 search_energy 工具使用相同参数。也可先浏览 LNG市场研究、储能电站与氢能项目导读，再确定检索问题。

{"query":"LNG 项目进展","topic":"gas","start_date":"2026-10-01","end_date":"2026-10-10","limit":20}

使用说明

1. 登录账号，准备凭证

注册或登录本站账号，完成邮箱验证。
进入用户中心，打开左侧“数据接口”菜单，查看本月额度。
点击“创建密钥”，选择名称、有效期和权限；可勾选“长期有效”，或设置 1—90 天。完整 API Key 会一直显示在数据接口页面，并自动提供已填好密钥的客户端 JSON 和 API 示例。API 与 MCP 使用同一把密钥。

打开用户中心的数据接口 →

月调用额度：普通用户 100 次、VIP 1,000 次、VVIP 3,000 次。以北京时间自然月重置，API 与 MCP 共享；账号当前额度以用户中心显示为准。

2. 选择分类、关键词和时间

topic 对应网站信息库的大分类。选石油填 oil，选新能源填 newenergy；不填 topic 时跨分类检索。query 是必填关键词，建议写具体项目、公司或政策名称，而不是只写“能源”。

网站分类	topic	检索问题示例
石油	`oil`	原油供应
天然气 / LNG	`gas`	LNG 项目进展
新能源	`newenergy`	新能源项目政策
氢能	`hydrogen`	绿氢项目
储能	`storage`	电池储能项目
电力	`power`	电力市场改革
煤炭	`coal`	煤炭供应
核能	`nuclear`	核电项目
太阳能	`solar`	光伏项目
风能	`wind`	海上风电

新能源是综合信息库，涵盖可再生能源及相关储能等内容；只研究光伏或风电时，直接选择 solar 或 wind。更细的国家、能源和技术标签，请先调用 GET /taxonomy，MCP 使用 get_energy_taxonomy，从返回的 code 中选择，不要把中文标签名直接当作代码。

参数	如何填写
`query`	必填，1–200 个字符，例如“原油供应”“绿氢项目”。
`topic`	可选，上表中的大分类代码。GET /topics 可查询当前目录。
`start_date / end_date`	YYYY-MM-DD，按文章发布日期筛选，开始与结束当天都包含，以北京时间解释。只填开始日期表示“从这天起”；只填结束日期表示“截至这天”；都不填表示不限时间。开始日期不能晚于结束日期。带时间条件时排除发布日期未知的资料。
`limit`	每次检索返回 1–20 条，默认 20 条；一次成功检索只扣 1 次，与返回条数无关。
`tag_codes_all`	数组，同时满足全部标签；例如 ["country.au"] 表示澳大利亚。标签与 topic 条件同时生效。
`tag_codes_any`	数组，满足其中任意一个标签。all 与 any 每组最多 20 个代码。
`include_descendants`	默认 true，选择上级标签时包含其子标签。
`relevance`	默认 related；primary 只取主要相关资料，all 包含所有关联等级。

API · 查找澳大利亚标签

curl "https://e.biaoshuds.com/data-api/v1/taxonomy?q=Australia&limit=20" \
  -H "Authorization: Bearer $ENYINFO_API_KEY"

示例 A · 石油，指定日期

{"query":"原油供应","topic":"oil","start_date":"2026-10-01","end_date":"2026-10-10","limit":20}

示例 B · 新能源，从指定日期起

{"query":"新能源项目政策","topic":"newenergy","start_date":"2026-10-01","limit":20}

示例 C · 澳大利亚 LNG，分类与标签组合

{"query":"LNG 项目","topic":"gas","tag_codes_all":["country.au"],"include_descendants":true,"start_date":"2026-10-01","end_date":"2026-10-10","limit":20}

3A. 用 API 完成第一次检索与全文读取

先在您自己的运行环境中设置 ENYINFO_API_KEY 为用户中心创建的密钥。以下 cURL 示例适用于 bash / zsh；将日期和关键词换成您需要的条件。

cURL · POST /search

curl "https://e.biaoshuds.com/data-api/v1/search" \
  -H "Authorization: Bearer $ENYINFO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"原油供应","topic":"oil","start_date":"2026-10-01","end_date":"2026-10-10","limit":20}'

返回 items 是摘要列表，id 是全文读取需要的文章标识。下面只展示关键字段，标题和标识是示意值。

摘要返回示意 · 不含全文

{"items":[{"id":"ARTICLE_ID","title":"原油供应相关新闻（示例）","access":{"full_text_included":false}}]}

检索成功计 1 次。从结果选择一篇，将 ARTICLE_ID 替换为实际 id 再获取全文。每次成功调用此全文接口扣 1 次，重复获取也扣次数；正文和现有译文在同次响应中提供。

cURL · GET /documents/{id}

curl "https://e.biaoshuds.com/data-api/v1/documents/ARTICLE_ID" \
  -H "Authorization: Bearer $ENYINFO_API_KEY"

Python · 检索并打印候选资料（计 1 次）

import json
import os
from urllib.request import Request, urlopen

base = "https://e.biaoshuds.com/data-api/v1"
headers = {"Authorization": "Bearer " + os.environ["ENYINFO_API_KEY"],
           "Content-Type": "application/json"}
body = {"query": "绿氢项目", "topic": "hydrogen",
        "start_date": "2026-10-01", "end_date": "2026-10-10", "limit": 20}
request = Request(base + "/search",
                  data=json.dumps(body).encode("utf-8"), headers=headers)
with urlopen(request, timeout=30) as response:
    result = json.load(response)
for item in result["items"]:
    print(item["id"], item["title"])

# After choosing an article, retrieve its text (one additional call):
# article_id = "actual id from search"
# request = Request(base + "/documents/" + article_id, headers=headers)
# with urlopen(request, timeout=30) as response:
#     article = json.load(response)

API	用途
`GET /topics`	查看可用信息库分类。
`GET /taxonomy`	查找稳定标签代码，可用 q、dimension、parent、offset、limit 筛选。
`POST /search`	按关键词、分类、标签与日期检索摘要。
`GET /documents/{id}`	获取文章正文与现有译文，成功计 1 次。
`GET /changes`	按游标获取更新与移除通知。

3B. 在 OpenClaw、WorkBuddy 中使用 MCP

MCP 与 API 统一使用 API Key。普通用户只需在用户中心创建密钥，复制带完整 Key 的客户端 JSON，粘贴保存并启用即可。

打开用户中心 → 数据接口，创建 API Key；一般使用可保留默认权限，需要长期连接时可选择“长期有效”。
打开数据接口页面，即可看到完整 API Key，以及已填好密钥的 OpenClaw 和 WorkBuddy JSON；点击“复制完整 JSON”即可。
在客户端的 MCP / 自定义连接器设置中粘贴 JSON，保存并启用。确认看到四个工具后，就可以直接提问。

查看您的完整 API Key 和 JSON →

下方公开示例展示 JSON 字段格式；用户中心直接显示属于您的完整 API Key 和可用 JSON，无需填写、生成或展开。

OpenClaw

将 enyinfo 合并到 OpenClaw 配置的 mcp.servers，保留已有服务，保存并重新加载连接。

OpenClaw · API Key JSON

{
  "mcp": {
    "servers": {
      "enyinfo": {
        "url": "https://e.biaoshuds.com/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer YOUR_FULL_API_KEY"
        }
      }
    }
  }
}

WorkBuddy

在 WorkBuddy 的“连接器 → 自定义连接器”中粘贴 JSON，保存并启用。传输类型为 streamableHttp。

WorkBuddy · API Key JSON

{
  "mcpServers": {
    "enyinfo": {
      "type": "streamableHttp",
      "url": "https://e.biaoshuds.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FULL_API_KEY"
      },
      "timeout": 30000
    }
  }
}

连接后，可以直接这样提问

复制到智能助手

请使用智能数据接口服务，查询 2026-10-01 至 2026-10-10 发布的石油供应新闻。先调用 search_energy，参数 query="原油供应"、topic="oil"、start_date="2026-10-01"、end_date="2026-10-10"、limit=20。只展示标题、摘要、发布日期和来源链接，先不要读取全文，等我选定文章后再调用 get_document，并同时整理正文和现有译文。

换成新能源：把 topic 改为 newenergy，query 改为“新能源项目政策”；要选国家或细分类，先让助手调用 get_energy_taxonomy 查代码，再带 tag_codes_all / tag_codes_any 检索。时间参数与 API 完全相同。

工具对应：search_energy 检索摘要；get_document(document_id) 读取全文（document_id 填检索结果的 id）；get_energy_taxonomy 查标签；get_topic_updates 按主题读取更新摘要。其他支持远程 MCP 和自定义 Authorization 请求头的客户端，也可用同一地址和 API Key 连接。

自建客户端：API Key 请求头

使用 MCP SDK 连接 https://e.biaoshuds.com/mcp，并设置 Authorization: Bearer 后接完整 API Key。客户端按 MCP 协议初始化、发现工具并调用，无需额外申请客户端凭证。

MCP · API Key

{
  "url": "https://e.biaoshuds.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_FULL_API_KEY"
  }
}

4. 管理用量与密钥

用户中心 → 数据接口集中显示本月已用 / 剩余次数、API Key 列表、完整 MCP JSON和近期调用记录。每次成功业务调用扣 1 次，包括检索摘要、查询分类与标签、获取更新和读取全文。重复调用、零条结果也计数；一次返回 20 条只计 1 次。API、MCP 和同账号所有密钥共享月额度。连接初始化、工具列表查询和密钥管理不扣次数。

密钥在数据接口页面持续完整显示，可随时点击复制。更换程序密钥时，可选择立即停用旧密钥，或保留 1 / 24 小时交接期；不再使用的密钥直接撤销。API 和 MCP 都通过密钥管理；撤销 Key 会停止使用它的全部连接，轮换后请更新客户端 JSON。

会员到期后按普通用户额度执行，已用次数保留；每月额度不结转。不设每日上限，服务仍有每分钟请求频率限制。失败请求不扣次数；如调用方未收到响应但服务已成功返回，重试成功仍会再计一次。

调用遇到问题

401 / 403: API 与 MCP 均检查密钥是否有效、是否粘贴完整 JSON、Bearer 请求头是否正确、是否勾选对应权限；同时确认本站邮箱已验证。
422: 检查关键词非空、日期格式为 YYYY-MM-DD 且开始不晚于结束、limit 为 1–20，并使用目录返回的分类与标签代码。
429: 查看错误代码区分月调用额度用完或请求过频。月额度在用户中心查看；请求过频请按 Retry-After 等待重试。
没有结果 / 没有译文: 先放宽日期和标签，使用更具体或中英文替换关键词。译文只在文章已有译文时提供；文章附件和研究报告全文不在供数范围内。