EIA — U.S. Energy Information Administration

Официальные данные США по энергетике: нефть, природный газ, электроэнергия, уголь, возобновляемые источники, ядерная энергия, общая энергетика, международная энергетика. Производство, потребление, цены, запасы, импорт/экспорт — на национальном, уровне штатов и (для электроэнергии) уровне электростанций. Бесплатно, требуется бесплатный API-ключ.

Часть Pipeworx — MCP-шлюза, соединяющего ИИ-агентов с 1476+ живыми источниками данных.

Почему это важно для ИИ-агентов

Для вопросов об энергетике — «какова цена природного газа?», «сколько электроэнергии поступает от солнечных панелей?», «растут ли цены на бензин?» — EIA является источником. Данные государственного уровня, без коммерческой наценки. Сочетайте с FRED для макроэкономических показателей, связанных с энергетикой, и NOAA для контекста погоды, важного для энергетики.

Типичные сценарии:

• Спотовые цены. «По какой цене торгуется нефть WTI?» → серия спотовых цен на сырую нефть.

• Структура электроэнергии по штатам. «Какой процент электроэнергии Калифорнии приходится на солнечную?» → генерация на уровне штатов по источникам.

• Розничный бензин. «Средняя цена за галлон на прошлой неделе?» → еженедельные розничные цены.

• Хранение природного газа. «Сколько рабочего газа в хранилищах?» → еженедельные отчеты EIA-915.

Related MCP server: EIA MCP Server

Аутентификация

API открытых данных EIA требует бесплатный ключ с https://www.eia.gov/opendata/register.php. Передавайте через _apiKey. Щедрые лимиты запросов.

Основные наборы данных

Идентификаторы серий

Серии EIA следуют шаблонам dataset_id.frequency.region.product. Примеры:

• PET.RWTC.D — нефть WTI, ежедневно

• NG.RNGC1.D — природный газ Henry Hub, ежедневно

• ELEC.GEN.SUN-CA-99.M — солнечная генерация Калифорнии, ежемесячно

• PET.EMM_EPMR_PTE_NUS_DPG.W — средняя еженедельная цена на обычный бензин в США

Используйте инструмент eia_search для поиска идентификаторов, а не создавайте их вручную.

Частые ошибки

• Задержка отчетности варьируется. Цены на нефть обновляются еженедельно с задержкой ~3 дня. Генерация электроэнергии — ежемесячно с задержкой ~2 месяца. Не предполагайте, что «текущие» данные совпадают по всем наборам данных.

• Теплосодержание против объема. Природный газ указывается в BCF (миллиардах кубических футов), MMcf и энергетических единицах (BTU, MMBtu). Преобразования важны для сравнения разных видов топлива.

• Чистая и валовая генерация. Генерация электростанций имеет тонкие определения. «Чистая» вычитает внутреннее потребление станции. EIA в основном публикует чистую. Не учитывайте дважды.

• Электроэнергия штатов по первичному двигателю. Структура на уровне штатов EIA учитывает первичный двигатель (паровая турбина, комбинированный цикл и т.д.) И топливо — одна и та же станция может иметь несколько категорий. Агрегируйте до уровня, необходимого для вашего вопроса.

• Прогнозы — это сценарии. AEO (Ежегодный энергетический прогноз) — это проекция базового сценария плюс дополнительные сценарии. Не рассматривайте базовый сценарий как «то, что произойдет».

• Нет рыночных цен в реальном времени. Спотовые цены EIA являются официальными на конец дня; для внутридневных рыночных цен нужен коммерческий источник, а не EIA.

Быстрый старт

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т.д.):

{
  "mcpServers": {
    "eia": {
      "url": "https://gateway.pipeworx.io/eia/mcp"
    }
  }
}

Что на самом деле предоставляет эта конечная точка

tools/list по адресу https://gateway.pipeworx.io/eia/mcp возвращает инструменты из таблицы выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор, общий для всего шлюза. Таким образом, количество инструментов, которое вы видите, больше, чем в этой таблице: конечная точка одного пакета в настоящее время перечисляет примерно 30 общих инструментов вместе с собственными инструментами пакета. Ответ initialize соединения указывает его точную область действия и является авторитетным ответом для данного дня.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты позволяют ограниченному соединению ответить на вопрос, который этот пакет не охватывает — через ask_pipeworx, который маршрутизирует по всему каталогу — без добавления второго MCP-сервера. В настоящее время невозможно подключить конечную точку пакета без них; если дополнительные схемы стоят вам больше контекста, чем стоит маршрутизация, подключитесь к полному шлюзу один раз, а не к нескольким конечным точкам пакетов.

Или подключитесь к полному шлюзу Pipeworx, чтобы получить список инструментов всех пакетов напрямую, а не только этого:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Оба URL-адреса ведут к одному и тому же шлюзу и к одним и тем же 1476+ источникам данных. Единственное отличие — какие инструменты пакета перечислены напрямую; ask_pipeworx достигает всех из них с любого из них.

Использование с ask_pipeworx

Вместо прямого вызова инструментов вы можете задавать вопросы на простом английском — это работает как на конечной точке пакета выше, так и на полном шлюзе:

ask_pipeworx({ question: "your question about Eia data" })

Шлюз выбирает подходящий инструмент и автоматически заполняет аргументы.

Дополнительно

• Документация и руководства

• pipeworx.io

Лицензия

MIT