Интерпретатор изменений EDGAR
cmdrvl/edgar-change-interpreterClaude-скилл для выявления материальных изменений, скрытых рисков и ловушек раскрытия информации в SEC-отчётах (10-K, 10-Q, 8-K). Фокус на дельтах между периодами, а не на общих сводках. Разработан CMD+RVL.
Установка
git clone https://github.com/cmdrvl/edgar-change-interpreter.gitREADME
Edgar Change Interpreter
Claude-скилл для интерпретации материальных изменений, скрытых рисков и ловушек раскрытия информации в SEC-отчётах. Фокусируется на том, что изменилось (и что исчезло) между отчётами 10-K, 10-Q и 8-K — чтобы вы могли отслеживать дельты, не упуская тонких сдвигов.
- Фокус: материальные изменения, пропущенные риски и явные свидетельства из текстов отчётов
- Намеренно исключено: общие сводки и инвестиционные рекомендации
Почему интерпретация изменений, а не сводки?
Сводки описывают содержимое одного отчёта. Решения зависят от того, что изменилось между периодами, что тихо исчезло и как сместился язык описания рисков. Этот скилл создан для того, чтобы выявлять такие дельты и делать неопределённость явной.
Быстрый старт
mkdir -p ~/.claude/skills
cp -R skills/edgar-change-interpreter ~/.claude/skills/Перезапустите Claude, затем спросите:
Compare the latest 10-K vs. prior year for material changes and silent risks in the Risk Factors section.Что делает этот скилл?
При анализе SEC-отчётов скилл помогает Claude:
- Выявлять материальные изменения между текущим и предыдущим отчётами
- Отмечать скрытые риски — то, что исчезло или изменилось без объяснений
- Цитировать доказательства непосредственно из текста отчёта
- Явно указывать на неопределённость — без домысленных выводов
Подробная установка
Предварительные требования
- Node.js v20 или выше (см. Приложение A, если не установлен)
- Claude CLI с поддержкой MCP (см. Приложение B)
Шаг 1: Установка Claude-скилла
Скопируйте папку скилла в директорию Claude-скиллов:
# Создайте директорию скиллов, если она не существует
mkdir -p ~/.claude/skills
# Скопируйте скилл
cp -R skills/edgar-change-interpreter ~/.claude/skills/Скилл установлен. Перейдите к шагу 2 для настройки автоматического получения отчётов или сразу к Примерам использования, если хотите вставлять текст отчётов вручную.
Шаг 2: Настройка MCP-сервера (рекомендуется)
MCP-сервер автоматически загружает SEC-отчёты — больше не нужно копировать текст с сайта SEC. Пропустите этот шаг, если хотите использовать скилл вручную.
# Перейдите в директорию сервера
cd mcp/edgar-server
# Установите зависимости
npm install
# Создайте файл окружения
cp .env.example .envОтредактируйте файл .env, указав свои данные (SEC требует user-agent для доступа к API):
SEC_USER_AGENT_NAME="Your Name or Company"
SEC_USER_AGENT_EMAIL="your@email.com"
SEC_MAX_RPS=2Соберите сервер:
npm run build
Запустите один раз, чтобы получить команду регистрации:
npm start
Сервер выведет примерно следующее:
[edgar-mcp-server] Started successfully!
To add this server to Claude CLI, run:
claude mcp add-json edgar '{"type":"stdio","command":"node","args":["/path/to/dist/index.js"],"env":{...}}'
Важно: Остановите сервер (Ctrl+C), затем скопируйте и выполните команду claude mcp add-json .... Claude Code управляет запуском сервера автоматически — держать его запущенным вручную не нужно.
Шаг 3: Запуск Claude Code
Запустите Claude Code:
claude
Готово! Claude будет автоматически запускать MCP-сервер в фоне по мере необходимости.
Шаг 4: Проверка установки
Выполните быстрые проверки для подтверждения настройки:
# Проверьте, что MCP-сервер зарегистрирован
claude mcp list
# Должен показать "edgar" в списке
# Проверьте, что скилл установлен
ls ~/.claude/skills/edgar-change-interpreter
# Должен показать файлы скиллаБыстрый тест — вставьте в Claude Code для проверки работы скилла и MCP-сервера:
Use the edgar tools to resolve the company "AAPL" and tell me their CIK number.
Если вы видите CIK-номер (например, 0000320193) — всё настроено корректно.
Примеры использования
Без MCP-сервера (вручную)
Вставьте текст отчёта напрямую в Claude:
Analyze the material changes and silent risks in this 10-Q excerpt:
[PASTE FILING TEXT HERE]С MCP-сервером (автоматически)
Попросите Claude загрузить отчёт самостоятельно:
Use the edgar tools to fetch Apple's latest 10-K and analyze it for material changes.Или более конкретно:
Fetch AAPL's latest 10-K with the prior period included, then analyze the changes in their risk factors.Доступные MCP-инструменты
| Инструмент | Описание |
|---|---|
edgar.resolve_company | Преобразует тикер (AAPL) в CIK-номер |
edgar.latest_filing | Получает метаданные последнего отчёта |
edgar.fetch_filing_text | Загружает и конвертирует отчёт в plain text |
edgar.get_and_prepare_for_skill | Всё в одном: загружает отчёт(ы) и подготавливает к анализу |
Устранение неполадок
Скилл не применяется
Если Claude анализирует отчёт без структурированного вывода (Material Changes, Silent Risks и т.д.), скилл может быть установлен некорректно.
Проверьте установку скилла:
ls ~/.claude/skills/edgar-change-interpreter/skill.md
Если файл не существует, повторите шаг 1.
Совет: Вы можете явно вызвать скилл, введя /edgar-change-interpreter в Claude Code или упомянув «use the edgar change interpreter skill» в запросе.
«File content exceeds maximum allowed size»
Текст отчёта слишком большой. Попробуйте запросить меньший фрагмент или конкретные разделы:
Fetch AAPL's 10-K but focus only on the Risk Factors section.
MCP-сервер не отвечает
- Убедитесь, что сервер зарегистрирован в Claude (
claude mcp listдолжен показывать «edgar») - Попробуйте удалить и добавить снова:
claude mcp remove edgar, затем выполните команду добавления - Проверьте, что в файле
.envуказаны корректные значенияSEC_USER_AGENT
О CMD+RVL
CMD+RVL создаёт данные, сигналы и доказательства уровня принятия решений для финансового анализа. Этот скилл — открытый автономный компонент этой работы, разработанный для прозрачного использования сообществом.