사용자 에이전트가 없거나 형식이 잘못되었습니다. SEC에는 '이름(email@example.com)' 형식이 필요합니다.

SEC EDGAR MCP MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

티커/이름 → CIK 해상도; 회사 사실 끝점
파일링: 10-K, 10-Q, 8-K 검색 및 섹션 추출
XBRL 재무는 대차대조표/손익계산서/현금 흐름으로 분석됩니다.
내부자 거래 — 양식 3/4/5 거래
모든 답변에는 확인을 위해 SEC 제출 URL이 인용되어 있습니다.

라이브 데모

실제 사용 모습

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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

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"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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는 맵이 아닌 서버 오브젝트 배열 사용.

~/.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-K 읽기를 수행하세요.

👤 분석가, 투자자, 상장 기업을 취재하는 언론인 ⏱ ~30 min intermediate

언제 쓸까: 이번 주가 아니라 오늘 오후에 10-K를 읽어야 합니다.

사전 조건

SEC_EDGAR_USER_AGENT가 귀하의 이름과 이메일로 설정되었습니다. — SEC에는 프로그래밍 방식 액세스를 위해 연락 가능한 사용자 에이전트가 필요합니다.

흐름

회사를 해결하다

Microsoft용 CIK를 찾아보세요.✓ 복사됨

→ CIK 0000789019 반환됨
최신 10-K를 가져와

최신 10-K를 다운로드하여 위험 요인 섹션을 추출하세요.✓ 복사됨

→ 제출 URL과 함께 반환된 위험 요소 섹션
숫자를 당겨

FY2025의 대차대조표 및 손익계산서를 추출합니다.✓ 복사됨

→ 값 + 단위 + 파일링 URL로 행 정리

결과: EDGAR로 돌아가는 검증 가능한 링크가 포함된 소화 가능한 10-K 읽기입니다.

함정

회계 연도와 달력 연도를 혼동함 — 사용자가 온전한지 확인할 수 있도록 항상 답변에 회계 기간을 인쇄하세요.

함께 쓰기: yahoo-finance

관심 목록에 대한 내부 거래 추적

👤 내부자 정서를 따르는 투자자들 ⏱ ~20 min intermediate

언제 쓸까: 관심 목록에 대한 Form 4 활동에 대한 일일 요약을 원합니다.

흐름

각 종목별 내부자 나열

AAPL, MSFT, NVDA의 경우 — 지난 30일 동안 Form 4 거래를 가져옵니다.✓ 복사됨

→ 내부자 이름, 역할, 구매/판매, 주식, 가격, 날짜가 포함된 행
골재

순 내부자 매수와 매도를 티커별로 요약합니다.✓ 복사됨

→ 순 방향이 포함된 티커당 한 줄

결과: EDGAR를 손으로 긁지 않고도 깔끔한 내부 브리핑입니다.

함정

옵션 관련 거래를 '매수'로 계산 — 거래 코드 필터링 P/S 대 A/M/D 문제

함께 쓰기: alpaca

오늘의 8-K 서류를 관심 목록에 요약하세요.

👤 뉴스룸, 기업 개발팀, 투자자 관계 ⏱ ~10 min beginner

언제 쓸까: 중요한 일이 발생했습니다. 당신은 일반 영어 요약을 빨리 원합니다.

흐름

최근 8-K 가져오기

내 관심 목록의 종목에 대한 오늘의 8-K 파일을 가져옵니다.✓ 복사됨

→ 제출 기준: 품목 코드 + 링크
요약

각각에 대해 항목 코드가 포함된 한 문장의 일반 영어 요약입니다.✓ 복사됨

→ SEC URL을 포함한 명확한 요약

결과: 신뢰할 수 있고 연결할 수 있는 관심 목록 다이제스트입니다.

함께 쓰기: fetch

두 회사의 재무 상태를 나란히 비교

👤 주식 분석가, 모델을 구축하는 학생 ⏱ ~20 min intermediate

언제 쓸까: 빠른 사과 대 사과 비교가 필요합니다.

흐름

두 회사의 XBRL을 가져옵니다.

FY2024에 대한 AAPL 및 MSFT의 수익, 총 이익, 영업 이익, 순이익을 가져옵니다.✓ 복사됨

→ 단위 및 제출 URL이 포함된 정렬된 표
여백 차이

총이익률과 영업이익률을 계산하고 비교합니다.✓ 복사됨

→ 여백이 나란히 있음; 각 서류에 대한 링크

결과: 정확한 소스 URL과의 방어 가능한 비교입니다.

함께 쓰기: antv-chart

조합

다른 MCP와 조합해 10배 효율

sec-edgar-mcp + yahoo-finance

SEC 펀더멘털과 현재 시장 시세를 결합하세요

MSFT의 최근 10-K 순이익과 오늘의 시가총액을 살펴보세요. 묵시적인 배수를 계산합니다.✓ 복사됨

sec-edgar-mcp + alpaca

내부 신호를 화면으로 사용

지난 30일 동안 내부자 순 매수가 발생한 종목 코드의 경우 Alpaca의 현재 가격을 나열하세요.✓ 복사됨

sec-edgar-mcp + antv-chart

추출된 XBRL 숫자를 차트로 표시합니다.

5년간의 수익을 뽑아 antv-chart로 표시합니다.✓ 복사됨

도구

이 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 속도 제한: IP당 최대 10개 요청/초 — 이를 준수하세요.
호출당 토큰: 메타데이터의 경우 소규모이지만 파일링 규모가 매우 클 수 있습니다(수만 개의 토큰).
금액: 무료 — EDGAR는 공개입니다
팁: 전체 파일을 버리는 대신 extract_section을 사용하십시오. 일반적으로 MD&A 또는 위험 요소 섹션만으로도 충분합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: SEC_EDGAR_USER_AGENT는 SEC에 귀하를 식별합니다. 실명과 연락 가능한 이메일을 사용하세요. 개인 이메일을 공유 구성에 커밋하지 마십시오.

데이터 외부 송신: 모든 전화는 sec.gov로 연결됩니다. 기본 구성에는 타사 서비스가 없습니다.

이 MCP가 반환한 어떤 것도 투자 조언을 구성하지 않습니다. 행동하기 전에 항상 연결된 SEC 서류를 통해 확인하십시오.

문제 해결

자주 발생하는 오류와 해결

sec.gov의 403

사용자 에이전트가 없거나 형식이 잘못되었습니다. SEC에는 '이름([email protected])' 형식이 필요합니다.

확인: echo $SEC_EDGAR_USER_AGENT

요금 제한(429)

10req/s 미만으로 물러납니다. 많은 병렬 호출을 실행하는 대신 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	중개 시장 데이터 및 거래가 필요합니다.	서류가 없습니다. 데이터 모양이 다름

SEC EDGAR MCP