sec-edgar-mcp

sec-edgar-mcp

stefanoamorelliAGPL-3.0
307 звёзд83 форков
SEC EDGAR — база данных Комиссии по ценным бумагам и биржам США. В ней публикуют отчётность все публичные компании США: от Apple до маленьких стартапов. sec-edgar-mcp подключает AI-ассистента к этой базе. Вы запрашиваете данные на естественном языке, ассистент сам находит отчёты, парсит XBRL-теги и возвращает точные цифры. В отличие от текстового поиска, числа из баланса, P&L и cash flow совпадают с официальными данными SEC до последнего цента. Для аналитиков, разработчиков и инвесторов, которые хотят автоматизировать доступ к корпоративной отчётности без написания сложных запросов к API.
Development
Открыть на GitHub

Установка

uvx sec-edgar-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикstefanoamorelli
  • ЛицензияAGPL-3.0

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Поиск компании по биржевому тикеру (AAPL, TSLA) или CIK-коду с получением полной информации
  • Загрузка полных текстов форм 10-K (годовой отчёт), 10-Q (квартальный отчёт) и 8-K (внеочередные события)
  • Извлечение любого раздела из отчёта: описание бизнеса, риск-факторы, обсуждение менеджментом (MD&A), финансовая отчётность
  • Получение трёх основных финансовых отчётов в структурированном виде: баланс, отчёт о прибылях и убытках, отчёт о движении денежных средств
  • Мониторинг и анализ инсайдерских сделок через формы 3 (первичное владение), 4 (изменение позиции) и 5 (годовая сводка)
  • Парсинг точных числовых значений из XBRL-тегов — никакого распознавания текста
  • Каждый ответ содержит прямую ссылку на оригинальный документ на сайте SEC для верификации данных
  • Поддержка потокового HTTP для интеграции с веб-платформами, например Dify

Как подключить

1. Установите сервер через uvx:

uvx sec-edgar-mcp

2. Добавьте конфигурацию в ваш MCP-клиент, например Claude Desktop:

{ "mcpServers": { "sec-edgar-mcp": { "command": "uvx", "args": ["sec-edgar-mcp"] } } }

Для Docker используйте такой конфиг (укажите своё имя и email):

{ "mcpServers": { "sec-edgar-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SEC_EDGAR_USER_AGENT=Your Name (your@email.com)", "stefanoamorelli/sec-edgar-mcp:latest" ] } } }

3. Перезапустите клиент. Сервер готов к работе.

Примеры запросов

  • «Покажи балансовый отчёт Apple (AAPL) за последний финансовый год с точными цифрами из XBRL»
  • «Найди инсайдерские продажи акций Tesla (TSLA) из формы 4 за последние 6 месяцев»
  • «Скачай последний 10-K отчёт Microsoft и извлеки раздел Risk Factors»
  • «Сравни выручку, операционную прибыль и чистую прибыль Google и Meta из последних квартальных отчётов»

Технические детали

  • Язык: Python 3.11+
  • Транспорт: stdio (основной), streamable HTTP (по желанию)
  • Лицензия: AGPL-3.0
  • Совместимость: Claude Desktop, Cursor, Dify, Continue и любые другие MCP-клиенты

Поделиться