naverstock-web-apilisted

# NaverStock Web API ## 목적 이 스킬은 네이버 증권, 네이버페이 증권, Npay 증권으로 불리는 공개 `stock.naver.com` 화면에서 확인되는 비공식 읽기 전용 내부 API를 점검하고 호출할 때 사용합니다. 국내·해외 주식, 시세, 지수, 가상자산, 통합 검색, 홈 콘텐츠, 뉴스, 리서치, 랭킹, IPO, ETF, 시장지표, 종목토론 데이터를 다룹니다. 현재 종목 페이지가 연결하는 WiseReport v3 기업분석과 신버전에 없는 제한된 기술적 조건검색만 명시적인 외부 소스로 보완합니다. ## 핵심 안전 규칙 - 공개 `stock.naver.com/api/...`에서 관찰되는 비공식·미문서화 read-only 엔드포인트를 우선합니다. 네이버, 네이버페이, 네이버파이낸셜 또는 증권사가 지원하는 공개 API처럼 표현하지 않습니다. - 출력은 정보 제공용입니다. 금융, 법률, 세무, 투자 자문이나 매수/매도 추천처럼 표현하지 않습니다. - 주문, 계좌잔고, 보유종목, 포트폴리오, 이체, 로그인, 인증, 관심종목, 알림, 프로필, 댓글/반응 작성 같은 계정·mutation 워크플로는 중단합니다. - 쿠키, 인증 헤더, 토큰, 세션 파일, 브라우저 스토리지, 계좌번호, 개인 식별자, 원본 HAR를 저장하거나 요청하지 않습니다. - 대량 scraping, 고빈도 polling, rate limit/anti-bot/access-control 우회를 하지 않습니다. - 일반적인 누락 데이터를 `finance.naver.com` HTML로 대체하지 않습니다. 예외는 `scripts/legacy_screeners.py`가 allowlist로 고정한 기술적 5종과 가격 위치 2종뿐이며, WiseReport는 `scripts/wisereport.py`만 사용합니다. 자세한 경계는 [references/external-sources.md](references/external-sources.md)를 따릅니다. - 로컬 계산값이나 추정값을 현재 엔드포인트로 검증된 API 제공 필드처럼 설명하지 않습니다. - 중요한 답변, 제품 연동, 공개 보고서, 의사결정에 쓰기 전에는 현재 라이브 요청으로 엔드포인트와 데이터 의미를 재확인하고, 신선도·지연·비공식 상태의 불확실성을 밝힙니다. - 번들 요청 도우미의 공개 GET allowlist, 민감 경로 차단, 제한된 read-only POST allowlist, 페이징 상한을 우회하지 않습니다. ## 재확인 기준 로컬 카탈로그는 관찰 기록입니다. 조회 실패, 404, 빈 응답, 응답 구조 변경, route 변경 의심이 있으면 현재 공개 페이지를 다시 확인합니다. 새 엔드포인트 캡처나 카탈로그 갱신은 사용자가 명시적으로 요청했을 때만 수행하고, 절차는 [references/capture-workflow.md](references/capture-workflow.md)를 따릅니다. 404를 자동으로 "자료 없음"이나 빈 목록으로 바꾸지 않습니다. 단일 조회는 구조화된 API 오류로 실패시