SEC EDGAR MCP 서버

로컬에서 압축 풀고 진행하는 순서

1. 압축을 풀고 해당 폴더로 이동합니다.

   cd sec-edgar-mcp
   

2. 패키지를 설치합니다.

   npm install
   

3. (선택) 로컬 테스트를 하려면:

   npm run dev
   

   브라우저에서 http://localhost:3000 접속 확인.

4. Vercel에 배포합니다.

   vercel --prod
   

   • 처음 실행하면 프로젝트 이름, 스코프 등을 물어봅니다. 기본값(Enter)으로 진행하면 됩니다.
   • 배포가 끝나면 https://sec-edgar-mcp-xxxx.vercel.app 같은 URL이 출력됩니다.

5. 환경변수 설정 (필수)

   • https://vercel.com 대시보드 → 방금 배포된 프로젝트 → Settings → Environment Variables
   • SEC_USER_AGENT = 포니링크 IT사업본부 실제이메일주소@ponylink.com 형태로 등록 (SEC는 User-Agent에 회사명+이메일이 없으면 요청을 차단합니다)
   • 저장 후 재배포: vercel --prod 다시 한 번 실행

6. claude.ai에 등록

   • claude.ai 설정 > 커넥터 > 사용자 지정 커넥터 추가
   • URL: https://[배포된 주소]/mcp

제공되는 도구 8개

• search_company: 회사명/티커로 CIK 검색
• get_company_filings: CIK로 최근 공시 목록(10-K, 10-Q, 8-K, 20-F 등) 조회
• get_company_facts: CIK로 XBRL 재무데이터(매출, 순이익 등) 조회
• get_filing_section: 10-K/20-F/8-K 원문에서 특정 섹션(지분구조, 위험요소 등)만 추출. keyword 없이 호출하면 문서 목차(Item 목록)를 먼저 보여줍니다.
• get_insider_transactions: Form 4(임원·주요주주 지분변동보고) 구조화 조회 (거래일, 거래유형, 수량, 단가, 거래후 보유량)
• full_text_search: 키워드로 SEC 전체 공시 통합검색 (DART 공시검색과 유사, 회사명 없이도 검색 가능)
• get_major_shareholders: 13D/13G(5% 이상 주요주주 보고) 목록 및 표지 원문 발췌 조회
• get_executive_compensation: 최근 DEF 14A(주주총회소집통지)에서 임원보수 섹션 원문 추출

get_filing_section 사용 팁

1. 먼저 keyword 없이 호출해서 목차를 확인: get_filing_section(url=..., keyword 생략)
2. 목차에서 원하는 항목명을 keyword로 넣어 재호출 예) 20-F의 지분구조 → keyword: "Share Ownership" 예) 10-K의 위험요소 → keyword: "Risk Factors"

참고

• SEC data.sec.gov API는 인증키가 필요 없습니다.
• 요청 빈도 제한: 초당 10회 권장 (SEC 공식 가이드라인)