TL;DR

레포지토리는 agent 통합형 플러그인·스킬 형태의 주식 심층분석 도구로, Claude Code·Codex·Gemini 등 에이전트에서 바로 설치해 사용할 수 있습니다. 입력한 티커에 대해 22개 차원과 기관급 분석 방법을 병행하고 66명의 페르소나 규칙을 합성해 자립형 HTML 보고서(5–8분)를 생성하며, lite/medium/deep 3단계로 분석 깊이와 소요 시간을 조절할 수 있습니다. 데이터는 전부 무료 소스(akshare, 东方财富, yfinance 등)를 페일오버로 가져오고, 리포트 생성 전 13개 자동 self‑review 체크로 치명적 문제를 막습니다. 빠르게 써보려면 git clone 후 requirements 설치 뒤 python run.py <티커>로 바로 실행해 주요 출력을 확인할 수 있습니다.

핵심 포인트

• 레포지토리는 에이전트 친화적 플러그인·스킬 형태의 주식 심층분석 툴로서 Claude Code·Codex·Gemini·Cursor·Hermes 등 여러 agent 생태계에서 바로 설치해 쓸 수 있습니다. 설치 후에는 agent 명령 한 줄로 특정 티커를 입력하면 22개 차원과 22종 기관 방법론을 동원해 66명(평가 패널)의 관점을 합성한 HTML 보고서를 생성합니다. 이 구조는 에이전트를 중간에 개입시켜 각 페르소나의 '역할놀이(role‑play) → 규칙 적용 → 근거 제시'를 거치게 하는 파이프라인으로 구현되어 있습니다.
• 아키텍처는 파이프라인 기반으로 collect → score → synthesize로 나뉘며, v3.x에서 리포트 렌더러와 순수 함수 점수 모듈로 분리되어 유지보수성이 높아졌습니다. 데이터는 전부 무료 소스(akshare, yfinance, 东方财富 push2 등)를 계층적 페일오버로 가져오며 글로벌 피어 보완과 소셜 핫트렌드(微博·知乎·抖音 등)도 포함합니다. 보고서 생성 전후로 13개 자동 self‑review 체크를 실행해 치명적 데이터 누락이나 분류 오류가 발견되면 물리적으로 HTML 출력이 차단되므로 품질 관리 장치가 내장되어 있습니다.
• 사용자 관점에서 산출물은 브라우저로 열 수 있는 자립형 HTML 리포트, 1080×1920 공유용 세로 이미지, 1920×1080 전파용 이미지와 요약 문단이며 기본 medium 분석은 5–8분, lite는 1–2분, deep는 15–20분이 소요됩니다. CLI로도 직접 실행 가능하고 `--versus`, `--portfolio`, `--school` 같은 옵션으로 다수 종목 비교·포트폴리오 분석·특정 투자 유파 관점 고정이 가능합니다. Hermes 사용자용 우회 스크립트와 XueQiu 로그인 opt‑in, Cloudflare Tunnel 원격공유 기능 등 실제 운용 환경 고려 설정이 제공됩니다.
• 한계와 위험도 명확히 명시되어 있으며 모든 출력은 알고리즘 산출물로서 투자 권고가 아니라는 면책 문구가 포함되어 있습니다. 일부 데이터 소스는 로그인 또는 지역 네트워크 제약을 받을 수 있고, 그럴 경우 `_data_gaps.json`에 결손 항목과 권장 복구 조치가 기록되어 자동·수동 보완 경로를 제공합니다. 또한 agent 역할놀이 단계가 핵심 의사결정 논리이므로 agent prompt·환경에 따라 결과 재현성이 달라질 수 있음을 염두에 둬야 합니다.

이미지 분석