edgar-mcp

MCP-сервер, который позволяет Claude искать по полному тексту документов SEC.

Спросите Claude «какие компании обсуждали агентный ИИ в своих 10-K в этом году?» и он выполнит поиск прямо в EDGAR — 235 реальных документов, со ссылками.

https://github.com/user-attachments/assets/afa2e1e5-ee79-42ad-a736-6f016b8f6c64

Самая сложная проблема

EDGAR фильтрует по CIK — десятизначному идентификатору, который ничего не значит для человека и значит всё для API. Очевидное решение принимает CIK как параметр инструмента и позволяет модели подставлять его. Это терпит неудачу самым худшим образом: языковая модель уверенно выдумает CIK для любой компании, которую она не запомнила, а документы не той компании выглядят точно так же, как документы нужной — правильно оформленные, правдоподобные и совершенно неверные, и ничто не сигнализирует об ошибке. Поэтому инструменты принимают тикер или название компании и разрешают его в коде с помощью собственного файла сопоставлений SEC. Если название неоднозначно — «American» соответствует 66 компаниям — резолвер возвращает список кандидатов, а не выбирает совпадение с наилучшим баллом, и Claude спрашивает, какую именно компанию вы имели в виду. Модель обрабатывает простые случаи через контекст; код ловит те, в которых она ошибается.

Related MCP server: EdgarTools MCP

Установка

npm install -g @alinarashid/edgar-mcp

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "@alinarashid/edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app your@email.com"
      }
    }
  }
}

SEC_USER_AGENT обязателен. SEC отклоняет запросы, которые не идентифицируют отправителя, а при отсутствующем заголовке возвращается 403, а не пустой результат.

Перезапустите Claude Desktop.

Инструменты

search_filings — полнотекстовый поиск по всем документам начиная с 2001 года. Фильтруйте по типу формы, диапазону дат и компании. Возвращает компанию, подавшую документ, форму, дату и ссылку на документ.

list_company_filings — документы одной компании, от новых к старым. Принимает тикер или название. Фильтруйте по типу формы, иначе в основном вы получите инсайдерские сделки по форме Form 4.

Примеры

Какие компании упоминали «агентный ИИ» в своих 10-K в этом году?

Покажи последние квартальные отчеты American Airlines.

Найди 8-K за 2026 год, в которых упоминается «существенный недостаток».

Известные ограничения

• Поиск возвращает метаданные, а не текст. Он сообщает, какие документы соответствуют запросу, а не что в них сказано. Перейдите по URL, чтобы прочитать текст.

• Ранжирование по релевантности ключевых слов, а не по размеру компании. Короткий документ, повторяющий фразу, оказывается выше, чем 300-страничный 10-K, в котором она упоминается дважды.

• Только публичные компании. Частные компании ничего не подают в SEC.

• Поиск внутри компании включает сторонние документы, помеченные этим CIK, например предложения акционеров, поданные внешними группами.

Примечания

Полнотекстовый эндпоинт на efts.sec.gov не документирован — SEC не публикует ни списка параметров, ни схемы ответа, ни гарантий стабильности. Этот пакет читает данные с защитой от ошибок и может потребовать обновления, если структура изменится.

Запросы выполняются последовательно с частотой примерно 8 в секунду, что ниже опубликованного SEC предела в 10.

Лицензия

MIT