simonlin1212/a-stock-data

해결하는 문제

A주식(중국 주식 시장) 데이터를 위한 포괄적이고 인증 없이 사용 가능한 데이터 툴킷을 제공합니다. 개발자와 AI 에이전트가 수십 개의 분산된 금융 데이터 소스를 다룰 때 복잡한 API 파라미터, 인증 헤더, 레이트 제한 로직을 수동으로 처리할 필요 없이, 이를 하나의 AI 준비 완료 인터페이스로 통합합니다.

작동 방식

이 프로젝트는 Claude Code, Codex, OpenClaw와 같은 AI 프로그래밍 보조 도구에 직접 삽입 가능한 "스킬 파일"(임베디드 파이썬을 포함한 구조화된 마크다운)로 설계되었습니다. 19개의 다양한 소스(예: mootdx, Tencent, Eastmoney, 공식 거래소 API 등)에서 TCP 및 HTTP 요청을 조합하여 데이터를 가져오는 11계층 아키텍처를 구현합니다. IP 차단을 방지하기 위해 비차단 소스(mootdx, Tencent 등)를 우선적으로 사용하고, Eastmoney와 같은 제한이 엄격한 소스에는 내장된 레이트 제한 래퍼(em_get())를 사용합니다.

대상 사용자

• AI 개발자: 여러 API 키를 관리하지 않고도 신뢰할 수 있는 A주식 데이터가 필요한 금융 에이전트나 투자 연구 도구를 개발하는 사람.
• AI 프로그래밍 보조 도구 사용자: Claude Code 또는 유사 도구를 사용하여 에이전트가 실시간 주가 평가, 테마 연구, 매크로 분석을 수행할 수 있도록 하고 싶은 사람.
• 양적 연구자: 중국 시장용 K라인, 보고서, 자금 흐름 데이터를 간편하게 추출하고자 하는 사람.

주요 특징

• 광범위한 커버리지: 실시간 시세, K라인, 연구 보고서, 자금 흐름, 매크로 지표(PMI, 사회융자)까지 포함한 11계층에 걸쳐 54개의 엔드포인트.
• 인증 없음: 대부분의 데이터 소스는 완전히 무료이며 등록이나 API 키가 필요 없음(단, iwencai 의미 검색은 제외).
• 내구성 있는 아키텍처: 주요 소스가 차단되었을 경우 자동으로 대체 데이터 제공업체로 전환하는 "백업 소스" 전략을 포함.
• AI 중심 설계: LLM 기반 코딩 에이전트와의 원활한 통합을 위해 특별히 포맷된 스킬 파일 형식.
• 넓은 데이터 범위: ETF 옵션(Greeks/IV), 주주 수, 2016년 이후의 역사적 평가(PE/PB/PS)와 같은 전문 데이터 포함.