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"
사용 방법
스킬은 다음 작업을 지원합니다:
-
기업 공시 검색:
search_filings(ticker, form_type, limit)- 티커 심볼로 기업의 최근 공시를 검색합니다.
- 예:
search_filings("AAPL", "10-K", 3)(Apple의 최근 10-K 3개 검색)
-
공시 내용 조회:
get_filing_content(accession_number)- 특정 공시의 전체 내용을 가져옵니다.
-
재무 데이터 추출:
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 라이선스에 따라 배포됩니다.