프로젝트 소개
global-stock-data는 미국 주식 및 홍콩 시장 데이터 접근을 단일 SKILL.md 파일에 마크다운 지침과 내장 Python으로 통합합니다. 이는 Claude Code, Codex, OpenClaw와 같은 AI 코딩 어시스턴트를 위해 설계되었지만, Python은 일반 스크립트에도 복사할 수 있습니다. 프로젝트는 Python 3.9 이상과 requests 라이브러리를 요구하며, 별도의 API 키는 필요하지 않습니다. Yahoo 쿠키/크럼 처리 자동화가 포함되고, SEC EDGAR는 실제 연락처 정보가 포함된 선언된 User-Agent를 요구합니다.
도구 키트는 13개 레이어로 구성됩니다. 시장 데이터 엔드포인트는 Sina, Tencent, Eastmoney에서 미국/홍콩 견적을 제공하며, 소스에 따라 25–78개 필드를 포함합니다. K-라인 지원은 일, 주, 월, 분 단위 간격을 포함하며, 미국 종목의 Sina/Yahoo 히스토리는 1984년까지 거슬러 올라갑니다. 기술 지표(MA, EMA, MACD, RSI, KDJ, 볼린저 밴드)는 추가 의존성 없이 로컬에서 계산됩니다.
펀더멘털 데이터는 Eastmoney 재무제표 및 주요 지표, 재무, 애널리스트, 기관 보유를 다루는 Yahoo quoteSummary 모듈, 503개 GAAP 지표를 포함한 SEC XBRL 데이터를 포함합니다. Eastmoney는 일일 주요, 대형, 중형, 소형 주문 자금 흐름에도 사용됩니다. 유틸리티 함수는 주식 검색, 미국/홍콩 시장 목록, 티커 뉴스, 티커-대-CIK 매핑을 다룹니다.
버전 2.0은 공식 소스 우선 데이터를 강조합니다. CBOE 옵션 지원은 전체 체인, 내재 변동성, 델타, 감마, 베가, 세타, 로, 0DTE 필터링, 거래량/미결제약정 기반 이상 흐름 감지를 제공하며, Yahoo는 그리스 없는 대체 체인으로 제공됩니다. FINRA Reg SHO는 시장 전반 일일 숏 볼륨, 종목별 시리즈, 비율 순위를 제공합니다. SEC EDGAR 기능은 Form 4, 8-K, 13F, 144와 같은 양식에 대한 당일 일일 인덱스 접근, 2001년까지의 전체 텍스트 검색, 서류 목록, 구조화된 XBRL 재무 데이터를 포함합니다. EDGAR 프레임은 모든 XBRL 태그에 대한 시장 전반 스크리너로 사용됩니다. 매크로 및 캘린더 엔드포인트는 미국 국채 수익률 곡선, CFTC Commitments of Traders 보고서, Nasdaq 실적 캘린더를 다룹니다.
주목할 만한 기능은 소스 규정 준수 라벨링입니다. Tier S는 SEC EDGAR, 미국 국채, CFTC 소스를 상업적 사용 및 규칙 내 재배포에 적합한 것으로 설명합니다. FINRA는 Tier B이며 README는 상업적 사용 전 검증을 권고합니다. CBOE, Nasdaq, Yahoo, Eastmoney, Sina, Tencent는 Tier C로, 그들의 약관이 승인을 요구하거나 개인/연구 목적으로 제한하거나 검증되지 않았기 때문입니다. 프로젝트는 시장 데이터가 아닌 코드를 배포한다고 명시하며, 상업적 사용에는 Tier S 소스만 신뢰할 것을 권고하고, HKEX 스크레이퍼는 해당 소스의 제한으로 포함하지 않습니다.
요청은 직접 HTTP와 내장 스레드 안전 속도 제한기를 사용하며, SEC 트래픽은 EDGAR의 명시된 한도 아래로 제한됩니다. 저장소는 Apache-2.0 라이선스이며 투자 조언이 아닌 데이터 접근 도구라는 면책 조항을 포함합니다.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.