global-stock-data – AI 코딩 어시스턴트를 위한 시장 데이터 스킬

개요

• AI 코딩 어시스턴트(Claude Code, OpenAI Codex, OpenClaw 등)가 미국 중심의 다양한 시장 데이터를 즉시 가져올 수 있는 단일 스킬 파일(Python이 포함된 Markdown)입니다.
• 리포지토리에는 공개 데이터 소스와 통신하는 코드만 포함되어 있으며, 실제 데이터는 사용자가 요청 시에 가져옵니다.

중요성

• AI 어시스턴트는 코딩 관련 질문(예: "AAPL의 0일 만기 옵션 플로우 표시")에 답하기 위해 최신 금융 정보가 필요한 경우가 많습니다.
• 각 어시스턴트 개발자가 수십 개의 스크래퍼를 다시 구현하는 대신, 이 스킬은 16개의 논리적 레이어(종목 정보, K-라인, 펀더멘털, 옵션 Greeks, 공매도 관심, SEC 제출, 매크로 금리, FX 등)와 50개 이상의 엔드포인트를 다루는 즉시 사용 가능한, 인증 불필요, requests 전용 인터페이스를 제공합니다.

주요 기능(README에 설명됨)

레이어	주요 데이터 및 소스	하이라이트
시장 데이터	Sina, Tencent, Eastmoney(실시간 미국/홍콩 종목 정보)	심볼당 25-78개 필드
K-라인/차트	Sina(1984년까지) + Yahoo(글로벌)	일봉, 주봉, 월봉, 분봉; 미국, 일본, 대만, 한국, 인도, EU 시장 지원
기술적 지표	순수 Python 계산	MA, EMA, MACD, RSI, KDJ, 볼린저
펀더멘털	Eastmoney, Yahoo, SEC XBRL	손익계산서, 대차대조표, 현금흐름, 503 GAAP 지표
자금 흐름	Eastmoney push2his	시가총액 계층별 일일 자금 흐름
옵션	Yahoo crumb(폴백)	미국 종목의 전체 체인
공식 소스 옵션	CBOE(cdn.cboe.com)	전체 체인 + 내재 변동성 + Greeks + 0일 만기(0DTE) 플로우 감지
공매도 거래량	FINRA Reg SHO	약 12,000개 종목에 대한 시장 전체 일일 공매도 거래량
공매도 관심	FINRA(월 2회)	공매도 잔량, 매수에 필요한 일수, 약 22,000개 종목 순위
SEC 제출	EDGAR 일일 인덱스 + XBRL	당일 Form 4, 8-K, 13F; 2001년까지 전체 텍스트 검색
내부자 거래/13F	SEC Form 4 및 13F 파서	내부자 거래 세부 사항, 분기별 기관 보유
매크로/캘린더	미국 재무부, CFTC, Nasdaq 실적 캘린더	수익률 곡선(1M-30Y), COT 포지션, 실적 발표일
글로벌 금리 및 FX(V2.1)	BIS, ECB, 뉴욕 연준, 연준 이사회, 재무부	38개 중앙은행 정책 금리, EUR/USD, SOFR/EFFR, 유로존 수익률 곡선
대만 시장(V2.2)	TWSE 및 TPEx 공개 API	최신 종목 정보, P/E, 배당 수익률, 월간 매출, 신용 거래 데이터
에너지(V2.2)	미국 EIA	주간 원유/가솔린 재고, WTI, 브렌트, 헨리 허브 일일 현물 가격
도구	다양함	종목 검색, 시장 전체 티커 목록, 뉴스, 티커↔CIK 매핑

컴플라이언스 계층

• README는 모든 데이터 소스를 S(무료, 상업적 사용 가능)부터 D(개인 사용 전용)까지 등급을 매기고, B(상업적 재사용 시 허가 필요) 또는 C/D(자동 스크래핑 금지)인 소스를 표시합니다. 이를 통해 개발자는 프로덕션에 안전한 엔드포인트를 결정할 수 있습니다.

시작하기

1. ~/.claude/skills/global-stock-data 디렉토리를 생성합니다.
2. 리포지토리에서 단일 SKILL.md 파일을 다운로드합니다.
3. 유일한 런타임 종속성을 설치합니다: pip install requests (Windows는 tzdata도 필요).
4. (선택 사항) SEC에서 요구하는 사용자 에이전트에 SEC_CONTACT에 이름/이메일을 입력합니다.
5. AI 어시스턴트에서 스킬을 호출합니다. 예: "Claude, AAPL의 재무제표를 보여줘".

일반적인 사용 사례 프롬프트(README에서)

• "NVDA의 0DTE 옵션 플로우 표시 – 비정상적인 활동."
• "이번 주 TSLA의 공매도 거래량 비율 추세."
• "주요 중앙은행의 현재 정책 금리."
• "지난 1년간 WTI 가격 차트."
• "버크셔의 최신 13F 상위 10개 보유 종목."

대상

• AI 어시스턴트 기반 금융 도구를 개발하는 개발자.
• 수십 개의 API를 다루지 않고 공개 시장 데이터를 코드만으로 빠르게 가져오려는 퀀트 리서처.
• 공개 금융 피드를 인증 없이, Python 전용으로 래핑한 것이 필요한 모든 사람.

제한 사항

• 리포지토리는 코드만 제공합니다. 각 소스의 약관(특히 C/D 계층)을 존중해야 합니다. 상업 프로젝트는 계층 S 소스만 사용해야 합니다.
• 일부 데이터(예: Yahoo, Nasdaq)는 기술적으로 자동 스크래핑이 금지되어 있으며, 스킬에는 코드가 포함되어 있지만 사용자에게 경고합니다.

결론 global-stock-data는 공개된 미국 및 글로벌 시장 데이터 소스의 광범위한 세트를 단일 AI 어시스턴트 친화적인 Python 인터페이스로 통합하고 명확한 컴플라이언스 지침을 제공하는 잘 문서화된 오픈 소스 "스킬"입니다.