TL;DR

a-stock-data는 중국 A주용 데이터 엔드포인트 집합으로 10계층 아키텍처와 40개 엔드포인트를 통해 시세·리포트·자금·공고·舆情을 통합 제공한다. 실시간 가격과 호가 등 민감한 시계열은 mootdx/Tencent로 우선 확보하고 Eastmoney 같은 독점 데이터는 em_get로 직렬 한정과 재시도를 적용해 IP 봉쇄 위험을 낮추는 방식으로 동작한다. V3.3에서 Limit-Up, ETF 옵션, 舆情互动 레이어가 추가되어 거래 신호·옵션 그리스·투자자 질의 응답까지 범위를 확장했으며 tdx_client와 em_get 헬퍼로 mootdx 초기화·Eastmoney 한계점을 보완했다. 단점으로는 일부 Eastmoney 엔드포인트가 주거용 대역폭에서 간헐적 차단(HTTP 000 등)을 보일 수 있어 배치 호출 시 EM_MIN_INTERVAL을 늘리거나 네트워크를 변경해야 안정성이 확보된다.

주요 기능

• 실시간 K선과 5단 호가 같은 시장 데이터를 mootdx/Tencent로 우선 확보한다.
• Eastmoney·同花顺·新浪·巨潮 등 13개 소스에서 리포트·자금·공고·舆情 데이터를 집계해 40개 엔드포인트로 노출한다.
• em_get를 통해 Eastmoney 호출을 직렬화하고 재시도·지터를 적용해 접근 안정성을 높인다.
• SKILL.md 형식으로 AI 코딩 어시스턴트에 컨텍스트 주입해 즉시 도구처럼 호출할 수 있다.

어떻게 동작하는가

레포는 단일 SKILL.md 파일에 내장된 Python 헬퍼와 엔드포인트 매핑으로 동작한다. 시장 시세는 mootdx TCP 프로토콜로 직접 수집하고 재무·뉴스·리포트 등 HTTP 기반 데이터는 각 공급원에 직결 호출하며 Eastmoney 계열은 em_get로 전용 스로틀링을 거친다. tdx_client와 em_get 같은 헬퍼가 버전·네트워크 이슈와 Eastmoney 풍부하지만 민감한 엔드포인트 접근을 안정화하는 역할을 수행한다.

해결 문제

분산된 중국 A주 공개 API들을 개별로 다뤄야 하는 복잡성을 제거하고 AI 어시스턴트가 바로 사용할 수 있는 통합 엔드포인트 집합을 제공한다. 또한 Eastmoney의 접속 제한과 mootdx 버전·BESTIP 이슈를 헬퍼 유틸로 완화해 실무에서 반복적으로 발생하는 실패 경로를 줄인다.

지금 주목받는 이유

최근 V3.x 대규모 업데이트로 엔드포인트가 28에서 40으로 늘어나고 ETF 옵션·涨停打板·舆情互动 같은 실시간 트레이딩·리서치 수요가 큰 영역을 커버해 주목을 받았다.

차별점

• 원본 소스에 대한 제3자 래퍼 의존을 제거하고 HTTP/TCP를 직접 호출하는 구조를 채택함으로써 중간 레이어의 버전·호환성 문제를 회피한다. 이로 인해 V3.0에서 akshare 의존을 제거했고 tdx_client로 mootdx 초기화 실패를 우회했다.
• 데이터 소스 우선순위를 명확히 규정해 mootdx/Tencent를 고빈도로 사용하고 Eastmoney는 독점 데이터에만 한정해 사용하도록 설계해 IP 봉쇄 리스크를 체계적으로 낮췄다. 모든 Eastmoney 호출은 em_get을 통해 일괄 제한된다.
• V3.3에서 Limit-Up, ETF 옵션, 舆情互动 등 세 개의 레이어를 추가해 판별 신호·옵션 데이터·투자자 질의 응답까지 범위를 확장했으며 이들 엔드포인트는 모두 제로 인증(키 불필요)으로 동작 가능한 경우가 많다.

사용 사례

• 실시간 단일종목 가치평가와 다종목 배치 비교에 사용된다. 라이브 가격, 합의 EPS, 전향 PE·PEG 계산을 연결해 즉시 투자 지표를 산출할 수 있다.
• 시장 감시와 모니터링 워크플로에서 활용된다. 동시다발적涨停池·炸板·资金流 지표를 수집해 단타·중기 신호 탐지 파이프라인에 투입할 수 있다.
• 리서치 자동화와 보고서 수집에 이용된다. iwencai의 NL 검색과 Eastmoney PDF 다운로드를 조합해 주제별 리포트 수집과 요약 입력 데이터로 활용할 수 있다.

시작하기

빠른 시작은 세 단계로 구성되어 있으며 SKILL.md를 ~/.claude/skills/a-stock-data에 복사하고 의존 패키지를 설치한 뒤 AI 어시스턴트에서 관련 문구를 호출하면 기능이 활성화된다. 예시 명령은 curl로 SKILL.md를 가져온 뒤 pip install mootdx requests pandas stockstats를 실행하는 것이다. Codex나 OpenClaw 환경에서는 SKILL.md 내용을 시스템 프롬프트나 컨텍스트 파일에 붙여 넣어도 동일하게 동작한다.

요구사항

• Python 런타임이 필요하며 README의 설치 예시는 pip 기반 패키지 설치를 전제로 한다.
• 명시된 주요 의존 패키지는 mootdx, requests, pandas, stockstats이며 V3.0 이후로 akshare 의존은 제거되었다.
• iwencai의 NL 검색을 사용하려면 별도 API Key가 필요하며 그 외 데이터 소스는 대부분 무키(무료)로 접근 가능하다.