simonlin1212/global-stock-data

해결하는 문제

이 프로젝트는 개발자가 복잡한 인증 프로세스, 티커 매핑, 분산된 데이터 소스를 수동으로 처리할 필요 없이 미국 및 홍콩 주식 시장 데이터에 접근할 수 있는 포괄적인 툴킷을 제공합니다. 특히 Claude Code, Codex, OpenClaw와 같은 AI 코딩 어시스턴트에 '스킬'로 통합될 수 있도록 설계되어, Python 코드를 통해 실시간 시세, 재무 정보, 제출 서류를 직접 가져올 수 있게 합니다.

작동 방식

이 프로젝트는 Markdown과 내장된 Python을 포함한 단일 자가 포함형 '스킬' 파일(SKILL.md)로 구성되어 있습니다. requests 라이브러리를 사용해 11개의 다양한 소스에서 데이터를 가져오며, 공식 정부 피드(SEC EDGAR, 미국 재무부, CFTC)와 금융 플랫폼(Yahoo Finance, CBOE, FINRA, Eastmoney, Sina, Tencent)을 포함합니다. SEC의 초당 10회 요청 제한과 같은 소스 제한을 준수하기 위해 내장된 스레드 세이프 레이트 제한이 포함되어 있습니다.

대상 사용자

금융 분석을 자동화하거나, 옵션 흐름을 추적하거나, SEC 제출 서류를 기반으로 기업을 스크리닝하고자 하는 개발자 및 AI 사용자로, 이러한 작업을 수행하기 위해 AI 코딩 어시스턴트를 사용하는 사람들을 대상으로 합니다.

주요 특징

• 포괄적인 데이터 커버리지: 실시간 시세, K라인(1984년까지), 기초 재무 정보, 마크로 데이터(재무부 수익률 곡선, COT 보고서)에 접근 가능.
• 공식 소스 우선: CBOE(옵션 그리크 및 0DTE 흐름), FINRA(시장 전체 공매도량), SEC EDGAR(제출 서류 및 XBRL 메트릭스)에서 고정밀 데이터 포함.
• AI 네이티브 통합: AI 어시스턴트용 스킬로 설계되어, "NVDA의 0DTE 옵션 흐름을 보여줘"와 같은 작업을 위한 엔드포인트를 호출할 수 있음.
• 준수 레벨링: 상업적 및 재배포 조건에 따라 데이터 소스를 명확히 분류(S, B, C 레벨).
• 제로 인증: 대부분의 엔드포인트는 API 키가 필요 없으며, Yahoo의 쿠키/크럼 인증은 자동으로 처리됨.