edgar-mcp

Claude가 SEC 공시 문서 전체 텍스트를 검색할 수 있게 하는 MCP 서버입니다.

Claude에게 *"올해 10-K에서 에이전트 AI를 논의한 기업이 어디인가요?"*라고 물어보세요. 그러면 EDGAR를 직접 검색해 실제 공시 235건과 링크를 보여줍니다.

https://github.com/user-attachments/assets/afa2e1e5-ee79-42ad-a736-6f016b8f6c64

가장 어려운 문제

EDGAR는 CIK로 필터링합니다. CIK는 10자리 숫자로 사람에게는 아무 의미가 없지만 API에는 전부를 뜻하는 식별자입니다. 흔한 설계는 도구 파라미터로 CIK를 받아 모델이 그 값을 제공하게 하는 것입니다. 이 방식은 최악으로 실패합니다. 언어 모델은 외우지 못한 어떤 기업에 대해서도 CIK를 확신을 가지고 지어낼 것이고, 잘못된 기업의 공시는 올바른 기업의 공시와 똑같아 보입니다. 형식은 정확하고 그럴듯하지만 완전히 잘못되어 있어서, 오류를 알려줄 신호도 없습니다. 그래서 도구들은 티커 또는 기업명을 받아 코드에서 SEC 자체 매핑 파일을 참고해 이를 해석합니다. 이름이 불명확한 경우 — 예를 들어 "American"은 66개 기업과 일치합니다 — 해석기가 가장 적합한 하나를 고르는 대신 후보 목록을 반환합니다. 그러면 Claude가 사용자가 의도한 것이 어떤 회사인지 묻습니다. 모델은 문맥을 통해 쉬운 경우를 처리하고, 코드는 모델이 틀린 경우를 잡아냅니다.

Related MCP server: EdgarTools MCP

설치

npm install -g @alinarashid/edgar-mcp

claude_desktop_config.json에 추가합니다.

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "@alinarashid/edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app your@email.com"
      }
    }
  }
}

SEC_USER_AGENT는 필수입니다. 요청자를 식별하지 않는 요청을 SEC는 거부하며, 헤더가 없으면 빈 결과 대신 403 오류가 반환됩니다.

Claude Desktop을 다시 시작합니다.

도구

search_filings — 2001년 이후의 모든 SEC 공시에 대한 전체 텍스트 검색. 보고서 유형, 날짜 범위, 기업으로 필터링할 수 있습니다. 결과에는 공시 기업, 보고서 유형, 날짜, 문서 링크가 포함됩니다.

list_company_filings — 한 기업의 공시를 최신순으로 보여줍니다. 티커 또는 기업명을 인식합니다. 보고서 유형으로 필터링하지 않으면 대부분 내부자 거래(Form 4) 내역만 나옵니다.

예시

올해 10-K 보고서에서 "agentic AI"를 언급한 기업은 어디인가요?

American Airlines의 최근 분기 보고서를 보여주세요.

"material weakness"를 언급한 2026년 8-K 공시를 찾아주세요.

알려진 제한 사항

• 검색은 메타데이터만 반환하며 본문 텍스트는 반환하지 않습니다. 어느 공시가 일치하는지는 알 수 있지만, 그 내용이 뭔지는 알 수 없습니다. URL을 따라가서 원문을 읽어야 합니다.

• 순위는 키워드 관련성 기준이지 기업 규모 순위가 아닙니다. 긴 문구를 계속 반복하는 짧은 공시가 같은 문구를 두 번 언급한 300페이지 분량의 10-K보다 높은 순위에 오릅니다.

• 상장 기업만 지원합니다. 비상장 기업은 SEC에 아무것도 제출하지 않습니다.

• 기업 검색에는 해당 CIK가 붙은 제3자 공시 포함되기도 합니다. 예를 들어 외부 단체가 제출한 주주 제안 등이 그렇습니다.

참고 사항

efts.sec.gov의 전체 텍스트 엔드포인트는 공식적으로 문서화되어 있지 않습니다. SEC는 매개변수 목록, 응답 스키마, 안정성 보장을 제공하지 않습니다. 이 패키지는 방어적으로 데이터를 읽도록 만들어져 있으며, API 형태가 바뀌면 업데이트가 필요할 수 있습니다.

요청은 약 초당 건으로 직렬화되어, SEC가 제시한 초당 10회 한도 아래에 유지합니다.

라이선스

MIT