Naver Search Skill 명세서

이 문서는 OpenClaw 에이전트가 네이버 검색 스킬을 가장 효율적으로 호출하고 결과를 분석할 수 있도록 돕는 지침서입니다.

🎯 스킬 목적

네이버의 실시간 뉴스, 쇼핑 데이터, 영상 및 장소 정보를 정교한 파라미터 제어를 통해 확보합니다.

🛠️ 호출 명세 (Command Reference)

1. 통합 어그리게이터 (추천)

에이전트가 여러 카테고리의 정보를 한꺼번에 파악해야 할 때 사용합니다.

python3 scripts/naver_search.py "<검색어>"

• 반환 데이터: 최신 뉴스(3건), 쇼핑 트렌드(3건), 이미지 썸네일, 비디오 요약, 상위 웹 결과.

2. 고성능 뉴스 엔진

python3 scripts/naver_news.py "<검색어>" --sort <sort> --time <time>

• --sort: 0(관련도순), 1(최신순-추천), 2(오래된순)
• --time: all, 1h(1시간), 1d(1일), 1w(1주), 1m(1개월)
• 팁: 실시간 이슈 분석 시 --sort 1 --time 1d 조합이 가장 유용합니다.

3. 쇼핑/이미지/비디오 전문 엔진

기능	스크립트	특수 옵션
쇼핑	naver_shopping.py	가격, 판매처 정보 포함
이미지	naver_images.py	--num [n] (결과 개수 제어)
비디오	naver_video.py	출처 및 재생 시간 정보 포함

4. 예약 및 장소 엔진

장소의 물리적 위치나 예약 링크가 필요할 때 호출합니다.

python3 scripts/naver_booking.py "<맛집/장소명>"

• 반환 데이터: 업체명, 주소, 카테고리, 네이버 예약 상품 정보 및 링크.

📊 출력 포맷 제어

모든 명령어 뒤에 --format 옵션을 추가하여 데이터 구조를 선택할 수 있습니다.

• compact (기본): 에이전트가 읽기 좋은 핵심 요약 텍스트.
• json: 코드 레벨에서 정밀 분석이 필요한 경우 유용한 JSON raw 데이터.

🔐 보안 및 환경 변수

• 본 스킬은 SERPAPI_API_KEY 환경 변수가 필수입니다.
• 환경 변수가 설정되어 있지 않다면 스킬 루트 폴더의 .env 파일에 키를 기입하세요.

---

유의사항: 네이버 엔진 특성상 검색어 뒤에 '뉴스', '예약' 등의 단어를 직접 포함하면 더 정확한 결과를 얻을 수 있습니다. (naver_news.py, naver_booking.py 내부에 이미 일부 자동 보강 로직이 포함되어 있습니다.)