naverstock-web-apilisted

# NaverStock Web API ## 목적 이 스킬은 공개 `stock.naver.com` 페이지에서 확인되는 비공식 읽기 전용 내부 API를 점검하고 호출할 때 사용합니다. 국내 주식, 시세, 지수, 가상자산, 뉴스, 리서치, 랭킹, IPO, ETF, 시장지표, 종목토론 데이터를 다룹니다. ## 핵심 안전 규칙 - 공개 `stock.naver.com/api/...`에서 관찰되는 비공식·미문서화 read-only 엔드포인트만 다룹니다. 네이버, 네이버페이, 네이버파이낸셜 또는 증권사가 지원하는 공개 API처럼 표현하지 않습니다. - 출력은 정보 제공용입니다. 금융, 법률, 세무, 투자 자문이나 매수/매도 추천처럼 표현하지 않습니다. - 주문, 계좌잔고, 보유종목, 포트폴리오, 이체, 로그인, 인증, 관심종목, 알림, 프로필, 댓글/반응 작성 같은 계정·mutation 워크플로는 중단합니다. - 쿠키, 인증 헤더, 토큰, 세션 파일, 브라우저 스토리지, 계좌번호, 개인 식별자, 원본 HAR를 저장하거나 요청하지 않습니다. - 대량 scraping, 고빈도 polling, rate limit/anti-bot/access-control 우회를 하지 않습니다. - 누락된 정보를 채우기 위해 `finance.naver.com` HTML을 사용하지 않습니다. 구버전 네이버 증권 페이지는 [dd3ok/naverfinance-api-skills](https://github.com/dd3ok/naverfinance-api-skills) 범위로 안내합니다. - 로컬 계산값이나 추정값을 현재 엔드포인트로 검증된 API 제공 필드처럼 설명하지 않습니다. - 중요한 답변, 제품 연동, 공개 보고서, 의사결정에 쓰기 전에는 현재 라이브 요청으로 엔드포인트와 데이터 의미를 재확인하고, 신선도·지연·비공식 상태의 불확실성을 밝힙니다. ## 재확인 기준 로컬 카탈로그는 관찰 기록입니다. 조회 실패, 404, 빈 응답, 응답 구조 변경, route 변경 의심이 있으면 현재 공개 페이지를 다시 확인합니다. 새 엔드포인트 캡처나 카탈로그 갱신은 사용자가 명시적으로 요청했을 때만 수행하고, 절차는 [references/capture-workflow.md](references/capture-workflow.md)를 따릅니다. ## 작업 라우팅 | 사용자 의도 | 우선 사용 | 참고 | | --- | --- | --- | | 국내 종목 상세, 현재가, 컨센서스, 관련 업종 종목 | `scripts/stock_summary.py` | [references/response-notes.md](references/response-notes.md) | | 종목 상세 하위 페이지: 가격표, 호가, 차트 가격, 뉴스, 공시, IR, 리서치, 투자자 통계, ETF 상세 | `scripts/stock_detail_pages.py` | [references/api-catalog.md](references/api-catalog.md) | | 국내 시장 랭킹, 시총 목록, 배당,