SEC EDGAR — Публичные документы компаний

База данных документов Комиссии по ценным бумагам и биржам. Каждая публичная компания в США подает документы здесь, каждый документ имеет временную метку и неизменен, и каждое раскрытие (выручка, долг, факторы риска, вознаграждение руководителей, активность M&A, инсайдерская торговля) структурировано для машинного поиска. Бесплатно и авторитетно.

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

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

Если ваш агент отвечает на любой вопрос о публичной компании США — финансовые показатели, юридические риски, интеллектуальная собственность, смена руководителей, недавние существенные события — ответ есть в EDGAR. Данные структурированы (XBRL), так что вам не нужно разбирать PDF-файлы.

Два ключевых потока:

1. Поток документов. «Покажи мне последний 10-Q Apple.» → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → список документов с номерами доступа, типами форм и датами подачи.

2. Поток концептов. «Какова была динамика выручки Apple за последние 4 квартала?» → edgar_company_concept(cik, "Revenues") → временной ряд значений, помеченных XBRL, за периоды.

Обычно перед ними вызывается edgar_ticker_to_cik или resolve_entity({type: "company", value: "AAPL"}) для получения канонического 10-значного CIK.

Related MCP server: SEC EDGAR MCP Server

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

Нет. SEC EDGAR — это бесплатный, публичный сервис без аутентификации. Pipeworx передает вежливый заголовок User-Agent для соблюдения рекомендаций API SEC.

Цитируемые URI

pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts

Встраивайте в свой вывод. Стабильны при реорганизациях — компании меняют бренд, но их CIK не меняется.

Типы форм, которые стоит знать

Для инсайдерских сделок в частности см. специальный пакет insider-trading — он показывает изменения Form 4 / 13D / 13G с более чистыми схемами.

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

• Дрейф названий концептов. Подающие в SEC иногда меняют концепт XBRL, которым они помечают выручку. Концепт по умолчанию Revenues может быть устаревшим для новых финансовых лет; попробуйте RevenueFromContractWithCustomerExcludingAssessedTax как запасной вариант.

• Несовпадение периодов. Финансовые годы заканчиваются в разное время у разных компаний (Apple = сентябрь, Microsoft = июнь, Google = декабрь). При сравнении всегда указывайте период.

• Форматирование CIK. Некоторые конечные точки требуют 10-значный с ведущими нулями (0000320193), некоторые — без (320193). Pipeworx принимает оба; поле cik_padded в edgar_ticker_to_cik является канонической формой для URI ресурсов.

• Почти в реальном времени, но не в реальном. Документы появляются на EDGAR в течение нескольких минут после подачи, но Pipeworx кэширует результаты. Для оперативности уровня срочных новостей установите Cache-Control: no-cache (применяется анонимный лимит) или проверьте поле _meta.cache.fresh_until.

• Доступность концептов различается. Мелкие подающие помечают меньше концептов XBRL, чем крупные. edgar_company_concept может возвращать пустые массивы для допустимых концептов, которые компания просто не сообщает. Используйте edgar_company_facts, чтобы увидеть, какие концепты компания действительно сообщает.

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

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

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

Что на самом деле обслуживает эта конечная точка

tools/list по адресу https://gateway.pipeworx.io/edgar/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 Edgar data" })

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

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

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

• pipeworx.io

Лицензия

MIT