EDGAR Answers — отчеты SEC для ИИ-агентов

Дайте вашему агенту ответы из SEC EDGAR, а не сырые ответы API.

В этом репозитории хранятся документация и реестровый манифест для хостируемого MCP-сервера. Устанавливать и запускать ничего не нужно: подключайтесь к указанной ниже конечной точке из любого MCP-клиента. Сам сервер работает как управляемый сервис.

Каждая публичная компания США подает свою финансовую отчетность в SEC бесплатно, в формате XBRL. Загвоздка в том, что «бесплатно и публично» — это не то же самое, что «пригодно к использованию»: компании помечают одну и ту же строку десятком разных способов, годовые и квартальные показатели находятся в одном потоке, пересмотренные отчеты молча перезаписывают историю, а инсайдерские формы Form 4 приходят в виде сырого XML. Существующие MCP-серверы для EDGAR передают вашему агенту этот хаос и желают удачи.

Этот сервер сначала выполняет разбор. Ваш агент запрашивает выручку — и получает выручку.

Инструменты

get_financials — нормализованная годовая отчетность

Многолетний отчет о прибылях и убытках, баланс и отчет о движении денежных средств для любой компании, торгующейся в США, по тикеру или CIK.

get_financials(company: "AAPL", years: 4)
→ revenue, grossProfit, operatingIncome, netIncome, epsDiluted,
  operatingCashFlow, capex, totalAssets, totalLiabilities,
  stockholdersEquity, cashAndEquivalents, longTermDebt, sharesDiluted
  — one clean row per fiscal year

За этим стоит: упорядоченная цепочка резервных тегов для каждой строки (филеры расходятся во мнениях о том, какой тег us-gaap означает «выручку»), фильтрация по длительности, чтобы годовые показатели не смешивались с квартальными накопительными итогами, и разрешение пересмотренных отчетов в пользу последнего поданного значения. Непредставленные статьи возвращаются как null, а не угадываются.

filing_diff — что изменилось год к году

filing_diff(company: "NVDA", section: "risk_factors")
→ paragraphs added and removed between the two most recent 10-Ks

Вопрос, который аналитик задает на самом деле — что они начали сообщать в этом году и что тихо перестали указывать? — получает ответ на уровне абзацев, при этом шаблонный текст, который просто переформатировали, отфильтровывается.

insider_activity — Form 4, разобранная

insider_activity(company: "MSFT", filings: 10)
→ who, role, transaction type, shares, price, holdings after — tidy rows

Покупки на открытом рынке отделены от налоговых удержаний и исполнения опционов, чтобы ваш агент не принял плановое наделение акциями за осознанную покупку.

filing_section — любой раздел в виде чистого текста

filing_section(company: "TSLA", section: "risk_factors" | "mdna" | "business" | "1A")

Ловушки в виде оглавления отфильтрованы; вы получаете реальное тело раздела.

search_filings — полнотекстовый поиск с 2001 года

search_filings(query: "\"supply chain disruption\"", forms: "10-K", startDate: "2025-01-01")

Related MCP server: FinImpulse MCP Server

Подключение

Конечная точка Streamable HTTP:

https://aion-org--edgar-answers-mcp.apify.actor/mcp

Аутентифицируйтесь с помощью вашего API-токена Apify в качестве bearer-токена. В конфиге MCP-клиента:

{
  "mcpServers": {
    "edgar-answers": {
      "url": "https://aion-org--edgar-answers-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Для клиентов, которые поддерживают только stdio, используйте мост через npx mcp-remote <url> --header "Authorization: Bearer YOUR_APIFY_TOKEN".

Сервер работает в режиме ожидания: он масштабируется до нуля в простое и просыпается при первом запросе, поэтому первый вызов после периода тишины занимает несколько секунд.

Цены

Оплата за каждый успешный вызов — неудачные вызовы не тарифицируются.

Данные и соответствие требованиям

Исходные данные — SEC EDGAR: государственные отчеты США, общественное достояние. Запросы выполняются с объявленным User-Agent и с ограничением частоты, значительно ниже опубликованного потолка SEC, согласно их руководству по доступу. Здесь ничего не скрейпится с сайтов, которые это запрещают.

Ограничения, изложенные прямо

• Филеры US GAAP. Иностранные частные эмитенты, отчитывающиеся по МСФО, не возвращают нормализованную финансовую отчетность; get_financials сообщает об этом, а не угадывает.

• Покрытие следует за EDGAR. Полнотекстовый поиск охватывает период с 2001 года; финансовая отчетность в XBRL существует примерно с 2009 года.

• Это не инвестиционная рекомендация. Это данные отчетности, добросовестно разобранные. Выводы, которые вы из них делаете, — ваши.

• filing_diff сравнивает две самые последние поданные формы; произвольные пары отчетов пока не поддерживаются.

Нашли ошибку в разборе или нужен инструмент, которого здесь нет? Откройте issue здесь или на Actor — конкретные сообщения о конкретных тикерах исправляются.

Указан в Apify Store. Документация в этом репозитории © Aion; сервис является проприетарным.