EdgarTools MCP
MCP-сервер к SEC EDGAR на Python: отчеты 10-K и 8-K, XBRL-финансы, сделки инсайдеров и портфели фондов без API-ключа.
- 2 849 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Читает публичные данные SEC и ничего не записывает; на сторону уходит только строка идентификации.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/edgartoolsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает публичные данные SEC и ничего не записывает; на сторону уходит только строка идентификации.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
EdgarTools читает данные SEC EDGAR и разбирает документы компаний США в структурированный вид. Библиотека на Python извлекает финансовые отчеты, формы 3, 4 и 5, портфели 13F, документы ADV и разделы годовых отчетов. Дополнение `ai` добавляет MCP-сервер с тринадцатью инструментами и семью готовыми подсказками. Инструменты сгруппированы по задачам: `edgar_company` собирает профиль, финансы, документы и владельцев компании за один вызов, `edgar_trends` строит ряды показателей с темпами роста, `edgar_compare` сравнивает компании, `edgar_text_search` ищет по тексту документов, `edgar_ownership` показывает сделки инсайдеров и портфели институтов. Для запуска нужна только строка идентификации для SEC, ключ API не требуется.
Для кого. Аналитикам и инвесторам-исследователям, которые разбирают отчетность американских компаний вместе с агентом и не читают документы вручную на сайте SEC.
Подходит, если
- Нужно сравнить выручку и маржу нескольких эмитентов за четыре квартала.
- Агент пересказывает раздел 1A из свежего 10-K.
- Аналитик следит за сделками инсайдеров по тикеру через формы 4.
- Исследователь смотрит, какие позиции фонд раскрыл в отчете 13F.
Не подходит, если
- Нужны котировки и торговые данные в реальном времени: EDGAR отдает только раскрытия.
- Требуется отчетность компаний вне США.
- Решение об инвестициях принимается без проверки цифр по первоисточнику.
Пример запроса к агенту
Сравни выручку и операционную маржу Apple и Microsoft за последние четыре квартала и покажи, где выросли расходы на исследования.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
EDGAR_IDENTITYобязательная- Имя и почта для идентификации клиента в SEC EDGAR.
Ограничения
Библиотека требует Python 3.11 или новее, версия 6.0 переименовала часть методов 5.x. Перед запуском задайте `EDGAR_IDENTITY` в формате «Имя email»: SEC требует идентификацию клиента. Для Claude Desktop нужен полный путь к `python3` или `uvx`, потому что приложение не наследует PATH оболочки. Данные приходят с сайта SEC и подчиняются его ограничениям частоты запросов. Результаты не служат инвестиционной рекомендацией.
Как отключить. Удалите запись edgartools из MCP-конфигурации (`claude mcp remove edgartools`). Пакет снимается командой `pip uninstall edgartools`, переменную `EDGAR_IDENTITY` уберите из окружения.
Частые вопросы
Как подключить EdgarTools к Claude Code?
Выполните `claude mcp add edgartools -- uvx --from "edgartools[ai]" edgartools-mcp` и экспортируйте `EDGAR_IDENTITY`. Для Claude Desktop добавьте тот же запуск в `claude_desktop_config.json` с полным путем к `uvx`.
Нужен ли ключ API?
Нет. Достаточно строки `EDGAR_IDENTITY` с именем и почтой, SEC использует ее для идентификации клиента.
Что делает `edgar_company`?
Это точка входа для вопросов о компании: за один вызов возвращает профиль, финансы, последние документы и владельцев. Параметр `include` выбирает разделы, `period` задает годовой, квартальный или скользящий год.
Чем отличается от размещенного коннектора edgar.tools?
Здесь сервер работает локально на вашей машине, а коннектор edgar.tools размещен на app.edgar.tools. Подключайте один из двух, они перекрываются и путают выбор инструмента.
Есть ли скилл вместе с MCP-сервером?
Да. Команда `python -c "from edgar.ai import install_skill; install_skill()"` ставит скилл для Claude Code и Claude Desktop. И скилл, и MCP-сервер входят в дополнение `ai`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к базе SEC EDGAR: отчетность компаний США, финансовые формы 10-K, 10-Q, 8-K, данные из XBRL и сделки инсайдеров
MCP-сервер к раскрытиям корейской DART и американской SEC EDGAR: отчетность компаний, сравнение и расчеты для агента.
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
MCP-эндпоинт графов RoboSystems: агент запрашивает финансовые данные компании и отчетность SEC XBRL в графе знаний
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
MCP-сервер для отбора компаний по метрикам из отчетности на любую прошлую дату, без заглядывания в будущее
Коротко о README
Библиотека разбирает формы SEC в типизированные объекты и поставляется под лицензией MIT. Дополнение `ai` добавляет локальный MCP-сервер и скилл для Claude Code и Claude Desktop.