SEC EDGAR MCP MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Тикер/название → Разрешение CIK; конечная точка фактов компании
Файлы: извлечение 10-K, 10-Q, 8-K и извлечение разделов.
Финансовые отчеты XBRL анализируются в балансовом отчете/отчете о прибылях и убытках/движении денежных средств
Инсайдерская торговля — сделки формы 3/4/5
В каждом ответе указывается URL-адрес заявки SEC для проверки.

Живое демо

Как выглядит на практике

sec-edgar-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

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

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: SEC EDGAR MCP

Быстро прочитайте 10-К с точными цифрами и цитатами.

👤 Аналитики, инвесторы, журналисты, освещающие публичные компании ⏱ ~30 min intermediate

Когда использовать: Вам нужно прочитать 10-К сегодня днем, а не на этой неделе.

Предварительные требования

SEC_EDGAR_USER_AGENT настроен с вашим именем и адресом электронной почты. — SEC требуется контактный пользовательский агент для программного доступа.

Поток

Решите проблему с компанией

Найдите CIK для Microsoft.✓ Скопировано

→ CIK 0000789019 возвращен
Возьмите последнюю версию 10-K

Получите последнюю версию 10-K и извлеките раздел «Факторы риска».✓ Скопировано

→ Раздел «Факторы риска» возвращен с URL-адресом для подачи заявки.
Вытащите цифры

Выписка из балансового отчета и отчета о прибылях и убытках за 2025 финансовый год.✓ Скопировано

→ Очистите строки со значениями + единицами измерения + URL-адресом файла.

Итог: Удобоваримое чтение на 10 тысяч с проверяемыми ссылками на EDGAR.

Подводные камни

Перепутанные финансовые и календарные годы — Всегда указывайте финансовый период в ответе, чтобы пользователи могли проверить работоспособность.

Сочетать с: yahoo-finance

Отслеживайте инсайдерские транзакции для списка наблюдения

👤 Инвесторы следят за настроениями инсайдеров ⏱ ~20 min intermediate

Когда использовать: Вам нужен ежедневный обзор деятельности по Форме 4 для вашего списка наблюдения.

Поток

Список инсайдеров для каждого тикера

Для AAPL, MSFT, NVDA — извлеките транзакции формы 4 за последние 30 дней.✓ Скопировано

→ Строки с именем инсайдера, ролью, покупкой/продажей, акциями, ценой, датой.
Совокупный

Подведите итоги чистой инсайдерской покупки и продажи по тиккеру.✓ Скопировано

→ Одна строка на тикер с чистым направлением

Итог: Четкий инсайдерский обзор без необходимости очищать EDGAR вручную.

Подводные камни

Считать транзакции, связанные с опционами, «покупками». — Фильтровать коды транзакций; P/S против A/M/D имеет значение

Сочетать с: alpaca

Обобщить сегодняшние заявки 8-K в списке наблюдения.

👤 Отделы новостей, корпоративные команды разработчиков, связи с инвесторами ⏱ ~10 min beginner

Когда использовать: Произошло что-то материальное; вам нужно быстрое изложение на простом английском языке.

Поток

Возьмите последние 8-K

Найдите сегодняшние заявки на 8-K, чтобы найти тикеры в моем списке наблюдения.✓ Скопировано

→ В каждой подаче: коды позиций + ссылка.
Подвести итог

Для каждого из них краткое описание на простом английском языке, состоящее из одного предложения, с кодом товара.✓ Скопировано

→ Очистить сводку с URL-адресом SEC

Итог: Дайджест списка наблюдения, которому вы можете доверять и на который можно ссылаться.

Сочетать с: fetch

Сравните финансовые показатели двух компаний рядом

👤 Аналитики акций, студенты, строящие модели ⏱ ~20 min intermediate

Когда использовать: Вам нужно быстрое сравнение яблок с яблоками.

Поток

Получите XBRL обеих компаний.

Получите выручку, валовую прибыль, операционную прибыль, чистую прибыль для AAPL и MSFT за 2024 финансовый год.✓ Скопировано

→ Выровненная таблица с единицами измерения и URL-адресами хранения
Разница в полях

Рассчитайте и сравните валовую и операционную прибыль.✓ Скопировано

→ Поля рядом; ссылка на каждую запись

Итог: Оправданное сравнение с точными исходными URL-адресами.

Сочетать с: antv-chart

Комбинации

Сочетайте с другими MCP — эффект x10

sec-edgar-mcp + yahoo-finance

Сопоставьте фундаментальные показатели SEC с текущими рыночными котировками

Получите последние данные по чистой прибыли MSFT за 10 тыс. и сегодняшнюю рыночную капитализацию; вычислить подразумеваемые кратные.✓ Скопировано

sec-edgar-mcp + alpaca

Используйте инсайдерские сигналы в качестве прикрытия

Для тикеров с чистой инсайдерской покупкой за последние 30 дней укажите текущие цены от Альпаки.✓ Скопировано

sec-edgar-mcp + antv-chart

Постройте диаграмму извлеченных чисел XBRL

Возьмите доход за 5 лет и постройте его с помощью antv-диаграммы.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
lookup_cik	ticker_or_name: str	Первый шаг для любого запроса компании	1 SEC request
get_company_facts	cik: str	Узнайте, о каких позициях сообщается	1 SEC request
get_filings	cik: str, form_type: str, limit?: int	Извлеките заявки 10-K / 10-Q / 8-K	1 SEC request
extract_section	accession_number: str, section: str	Прочтите конкретный раздел (например, «Факторы риска», MD&A).	1 SEC request
get_financials	cik: str, period: str	Структурированная финансовая отчетность с подразделениями	1 SEC request
get_insider_transactions	cik: str, days?: int	Форма 3/4/5 деятельности	1 SEC request

Стоимость и лимиты

Во что обходится

Квота API: Ограничение скорости SEC: ~10 запросов/сек на один IP — соблюдайте его.
Токенов на вызов: Небольшие для метаданных файлы могут быть очень большими (десятки тысяч токенов)
Деньги: Бесплатно — EDGAR является общедоступным
Совет: Используйте extract_section вместо того, чтобы выгружать весь файл; обычно достаточно только разделов MD&A или «Факторы риска».

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: SEC_EDGAR_USER_AGENT идентифицирует вас для SEC; используйте настоящее имя и контактный адрес электронной почты. Не связывайте свою личную электронную почту с общей конфигурацией.

Исходящий трафик: Все звонки идут на sec.gov. Никаких сторонних сервисов в конфигурации по умолчанию нет.

Ничто, возвращаемое по этому MCP, не является инвестиционным советом. Прежде чем действовать, всегда проверяйте связанный файл SEC.

Устранение неполадок

Частые ошибки и исправления

403 с сайта sec.gov

Ваш User-Agent отсутствует или имеет неверный формат. SEC требует формата «Имя ([email protected])».

Проверить: echo $SEC_EDGAR_USER_AGENT

Скорость ограничена (429)

Снизьте скорость до менее 10 запросов/с. Пакетная обработка с использованием CIK, а не выполнение множества параллельных вызовов.

Проверить: Inspect headers on the failing response

Концепция XBRL не найдена

Компания может не сообщать об этой концепции. Используйте get_company_facts, чтобы увидеть, какие концепции существуют.

Проверить: get_company_facts(cik) and grep for the concept

Альтернативы

SEC EDGAR MCP в сравнении

Альтернатива	Когда использовать	Компромисс
yahoo-finance	Вам нужны котировки + базовые показатели без точности уровня SEC.	Менее авторитетный; никаких прямых заявок
alpaca	Вам нужны брокерские рыночные данные и торговля	Никаких документов; другая форма данных

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills