Community연구 & 데이터 분석github.com

eggmasonvalue/sec-edgar-skill

SEC EDGAR 공시 자료를 기반으로 하는 미국 주식 리서치 AI 에이전트 스킬

sec-edgar-skill란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 SEC EDGAR 시스템에 접근하여 미국 상장 기업의 공시 자료(10-K, 10-Q, 8-K 등)를 검색, 조회 및 분석할 수 있도록 지원합니다. 투자자, 애널리스트, 개발자에게 유용하며, 공시 문서에서 핵심 재무 정보, 리스크 요인, 경영 논의 등을 추출할 수 있습니다. Python 기반으로 EDGAR API를 활용하며, 파일 경로, 환경 변수 설정 등 간단한 구성만으로 사용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add eggmasonvalue/sec-edgar-skill

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

sec-edgar-skill은(는) 무엇을 하나요?

SEC EDGAR 공시 자료를 기반으로 하는 미국 주식 리서치 AI 에이전트 스킬

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 SEC EDGAR 시스템에 접근하여 미국 상장 기업의 공시 자료(10-K, 10-Q, 8-K 등)를 검색, 조회 및 분석할 수 있도록 지원합니다. 투자자, 애널리스트, 개발자에게 유용하며, 공시 문서에서 핵심 재무 정보, 리스크 요인, 경영 논의 등을 추출할 수 있습니다.

설치 방법

이 스킬은 일반적으로 AI 에이전트 설정에 포함되어 제공됩니다. 별도의 설치는 필요하지 않지만, 필요한 종속성이 있는지 확인하세요.

pip install requests beautifulsoup4 lxml

설정

스킬을 사용하려면 환경 변수 SEC_API_KEY를 설정해야 할 수 있습니다 (선택 사항).

export SEC_API_KEY="your_api_key_here"

사용 방법

스킬은 다음 작업을 지원합니다:

  1. 기업 공시 검색: search_filings(ticker, form_type, limit)

    • 티커 심볼로 기업의 최근 공시를 검색합니다.
    • 예: search_filings("AAPL", "10-K", 3) (Apple의 최근 10-K 3개 검색)
  2. 공시 내용 조회: get_filing_content(accession_number)

    • 특정 공시의 전체 내용을 가져옵니다.
  3. 재무 데이터 추출: extract_financial_data(filing_content)

    • 공시 텍스트에서 주요 재무 데이터를 추출합니다.

예제

from sec_edgar_skill import search_filings, get_filing_content, extract_financial_data

# Apple의 최근 10-K 검색
filings = search_filings("AAPL", "10-K", 1)
if filings:
    content = get_filing_content(filings[0]["accession_number"])
    financial_data = extract_financial_data(content)
    print(financial_data)

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 에이전트

라이선스

이 프로젝트는 MIT 라이선스에 따라 배포됩니다.

관련 스킬