SEC EDGAR MCP с Cursor: отчёты и CIK

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → SEC EDGAR, установите его без ключа, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

SEC EDGAR + Cursor

Отчёты и финансовые данные из SEC EDGAR, базы Комиссии по ценным бумагам и биржам США, бесплатно и без ключа: поиск CIK компании, её профиль и история подачи отчётов (10-K, 10-Q, 8-K, Form 4), значения XBRL из финансовой отчётности по концептам, сравнение компаний через frames, полнотекстовый поиск по отчётам с 2001 года и список документов отчёта. Нужен только User-Agent с контактом.

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

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

SEC_EDGAR_USER_AGENT (имя и контактный e-mail, а не ключ)

Шаг 1 — Настройте коннектор

Бесплатно, без ключа, одна настройка: настройка занимает около минуты. Коннектор читает публичные API EDGAR Комиссии по ценным бумагам и биржам США (SEC): профили, истории отчётности и финансовые данные XBRL с https://data.sec.gov, полнотекстовый поиск и поиск компаний с https://efts.sec.gov и папки отчётов из архива EDGAR на https://www.sec.gov. Аккаунт и ключ не нужны.

1. Правила SEC требуют, чтобы каждый автоматический запрос сообщал в заголовке User-Agent, кто его отправляет, с контактным e-mail; запросы без этого блокируются с кодом 403. Укажите в SEC_EDGAR_USER_AGENT название организации или своё имя и адрес e-mail, по которому SEC может с вами связаться, например Example Research LLC [email protected].
2. Установите коннектор. Шага Authorize with Provider нет.
3. Проверьте его через sec_edgar_full_text_search с forms 10-K: он покажет последние поданные годовые отчёты.

CIK: у каждого подающего отчёты есть Central Index Key. Инструменты data.sec.gov требуют его дополненным нулями до 10 цифр (0000320193 для Apple); sec_edgar_get_filing_index принимает его и без нулей. sec_edgar_search_companies превращает название или тикер в CIK: NVDA даёт 1045810, с нулями 0001045810.

Что он читает: любого, кто подаёт отчёты в SEC, включая компании, котирующиеся в США, иностранных эмитентов, фонды и инсайдеров.

• До 10 подходящих подателей по названию или тикеру, с CIK, названием и тикерами.
• Профиль подателя: название, тикеры, биржи, отрасль по SIC, конец финансового года, штат регистрации, адреса и прежние названия, а также 100 последних отчётов с accession number, формой (10-K, 10-Q, 8-K, 4, DEF 14A и другие), датой подачи, отчётной датой и основным документом. Более старая история берётся из файлов, перечисленных в olderFilingFiles.
• Финансовые данные XBRL: названия всех концептов, которые сообщает компания (us-gaap, ifrs-full, dei, srt), а затем все значения одного концепта, например us-gaap NetIncomeLoss в USD. Выручка у разных компаний часто называется Revenues или RevenueFromContractWithCustomerExcludingAssessedTax, поэтому ИИ сначала смотрит список концептов.
• Сравнение компаний через frames: один концепт за один календарный период, 250 наибольших значений с CIK, названием компании, местонахождением и концом периода. CY2024 означает весь год, CY2024Q3 квартал, CY2024Q4I дату баланса.
• Полнотекстовый поиск по отчётам с 2001 года: по словам или "точной фразе", типам форм, startdt и enddt, ciks или entityName и местонахождению бизнеса. Без q он выводит последние отчёты нужной формы, например сегодняшние 8-K.
• Документы одного отчёта: имена, типы и размеры основного документа, приложений, файлов XBRL и полного текста подачи.

Форматы данных: в recentFilings списки идут параллельно: элемент n в accessionNumber, form, filingDate, reportDate и primaryDocument описывает один и тот же отчёт, от новых к старым. Значения XBRL даны в указанной единице (USD, shares, USD-per-shares), а не в тысячах. fy и fp (FY, Q1–Q4) обозначают финансовый год и период отчёта, в котором было сообщено значение, а start и end дают фактический период. Один и тот же период встречается в нескольких отчётах, потому что 10-K повторяет прошлые годы: чтобы получить одно значение на период, ИИ выбирает записи с frame (например, CY2024). Квартальные значения из 10-Q могут быть нарастающим итогом с начала года, поэтому ИИ сравнивает start и end. Ссылка на документ имеет вид https://www.sec.gov/Archives/edgar/data/<cik>/<accession without dashes>/<file name>; id результата полнотекстового поиска выглядит как <accession>:<file name>.

Постраничный вывод: полнотекстовый поиск возвращает 100 результатов на страницу; ИИ листает дальше через from с шагом 100, максимум до 10 000 результатов на запрос, поэтому сужает поиск по форме и дате. История отчётности листается через olderFilingFiles.

Только чтение: все инструменты только читают, поэтому подтверждать нечего и при установке ни один инструмент не отключён.

Ограничения: не более 10 запросов в секунду с одного отправителя. При превышении SEC блокирует адрес примерно на 10 минут.

Частые ошибки: 403 означает, что User-Agent отсутствует или не принят, либо превышен лимит частоты. 404 означает неизвестный CIK, концепт, единицу или период; не каждая компания сообщает каждый концепт.

Коннектор не скачивает массовые ZIP-архивы и файл company_tickers.json размером 1 МБ, не читает полные документы отчётов (часто это мегабайты HTML) и не подаёт отчёты. Эндпоинты полнотекстового поиска и поиска компаний на efts.sec.gov обслуживают сайт EDGAR и не входят в документированный API SEC, поэтому могут измениться.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты SEC EDGAR.

Доступные инструменты

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

• «Какими были годовая выручка и чистая прибыль NVIDIA за последние пять финансовых лет по данным отчётов в SEC?»
• «Перечисли отчёты 8-K, которые Tesla подала в этом году, с датой и основным документом.»
• «У каких 10 компаний были самые большие совокупные активы на конец 2024 года?»
• «Найди отчёты 10-K с 2023 года, где упоминается «tariff exposure», и скажи, каким компаниям они принадлежат.»
• «Покажи инсайдерские отчёты Form 4 по Apple за последний месяц со ссылками на документы.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot