Stocklens MCP — Data skill for Claude Code

---

배포 상태

StockLens의 공개 설치 안내는 2026-06-01 기준으로 종료했습니다.

현재 신규 설치는 구매자 안내문을 통해 제공되는 설치 명령어와 가이드를 기준으로 진행합니다. 이미 설치한 기존 사용자는 보유한 공개 버전을 계속 사용할 수 있지만, 신규 배포·설치 지원·활용 템플릿은 구매자 패키지 기준으로 정리합니다.

왜 필요한가

AI에게 차트 이미지를 보여주면 **숫자를 추측해서 틀린 분석**을 합니다 (할루시네이션).

**StockLens**는 Claude에 네이버 증권의 **실제 시세 데이터**를 직접 연결해서, AI가 추측이 아닌 **진짜 숫자를 읽고 분석**하도록 만듭니다.

❌ "삼성전자 8만원대인 것 같아요" (추측, 틀림)
✅ "삼성전자 206,000원, 20일 이평선 대비 +5.3%" (실제 데이터)

주요 기능

• 📊 56개 도구 — 시장 캘린더, 현재가, 차트, 수급, 재무, 실적, 배당, 스크리닝, Excel 출력
• 🕐 결과 메타 v3 — 요청한 범위와 실제로 돌려준 범위, 미완성 봉, 수정주가 불확실성, 재무 기간 혼재를 응답에 함께 실어 보냅니다. 60일을 물어 20일이 왔으면 그렇게 적힙니다. v3에서 늘어난 필드는 전부 선택적이라 기존 소비자는 무시해도 됩니다 (TOOLS.md)
• 🔑 API 키 불필요 — 네이버 증권 + Yahoo Finance 공개 데이터
• 📈 분봉·시간봉 (선택) — 한국투자증권 Open API 를 연결하면 국내·미국 1분~240분봉과 분봉 지표를 사용할 수 있습니다 (시세 조회 전용, 계좌·주문 미지원, 연결 방법)
• 🚀 빠른 응답 — TTL 캐시 + Semaphore 최적화
• 📁 Excel 스냅샷 — 한 번 스캔 → 반복 쿼리 즉시
• 🤖 Gemini/GPT 연동 — Excel 내보내기로 다른 AI에서도 활용

설치 안내

구매자에게 제공되는 안내문에는 다음 과정이 포함됩니다.

1. uv 확인 및 설치
2. StockLens MCP 설치
3. Claude Desktop 또는 Claude Code MCP 설정 자동 등록
4. 설치 진단과 첫 실행 확인

공개 README에는 더 이상 직접 설치 명령어를 게시하지 않습니다.

동작 확인

Claude에서:

삼성전자 현재가 알려줘

종목명, 현재가, 전일대비, 거래량이 나오면 설치 완료입니다.

설치 문제 진단

stocklens-doctor

uv·패키지·명령·config 4단계 자동 점검. 문