snowball-cli은(는) 무엇을 하나요?
AI 에이전트가 Xueqiu 주식 데이터를 가져올 수 있도록 지원하는 CLI 도구로, 30개의 CLI 명령어, JSON 출력, A주, 홍콩, 미국 주식 및 펀드 커버리지를 제공합니다.
개요
snowball-cli는 Xueqiu(설구) 플랫폼의 주식 데이터를 터미널에서 쉽게 조회할 수 있는 커맨드라인 인터페이스입니다. AI 에이전트(예: Claude Code, Cursor, Codex)와의 통합에 최적화되어 있으며, JSON 형식으로 데이터를 출력하여 후처리 및 분석이 용이합니다.
주요 기능
- 30개 이상의 CLI 명령어: 다양한 주식 데이터 조회 기능 제공
- 다중 시장 지원: A주(중국), 홍콩 주식, 미국 주식 및 펀드
- JSON 출력: AI 에이전트가 쉽게 파싱하고 처리할 수 있는 표준 출력
- 실시간 데이터: Xueqiu 플랫폼의 실시간 데이터를 기반으로 정보 제공
설치
pip install snowball-cli
또는 소스 코드에서 직접 설치:
git clone https://github.com/Amethystine-warji453/snowball-cli.git
cd snowball-cli
pip install -e .
사용법
기본 명령어 형식:
snowball <명령어> [옵션]
예시:
# 특정 주식의 실시간 가격 조회
snowball quote 600519.SH
# 홍콩 주식 정보 조회
snowball quote 0700.HK
# 미국 주식 정보 조회
snowball quote AAPL
# 펀드 정보 조회
snowball fund 000001.OF
명령어 목록
| 명령어 | 설명 |
|---|---|
quote | 실시간 주가 조회 |
history | 과거 가격 데이터 조회 |
financial | 재무 정보 조회 |
news | 관련 뉴스 조회 |
fund | 펀드 정보 조회 |
| ... | (기타 명령어) |
환경 변수
SNOWBALL_TOKEN: Xueqiu API 인증 토큰 (선택 사항)
지원 플랫폼
- Linux, macOS, Windows
- Python 3.7 이상
라이선스
MIT License
기여
버그 리포트 및 기능 제안은 GitHub Issues를 통해 제출해 주세요.