eatery-trend 사용 가이드
여행지나 동네에서 지금 뜨는 맛집·음식 트렌드를 검색량 surge로 찾아드립니다.
/eatery-trend 제주 요즘 뜨는 맛집 알려줘, /eatery-trend 성수에서 트렌디한 국밥집 찾아줘처럼 말하면 됩니다. 평점이 높은 곳이 아니라 지금 관심이 급증하는 곳을 찾는 스킬입니다.
처음 설정하기
이 스킬은 네이버 오픈API로 검색량 변화(데이터랩)를 재고 가게(지역검색)를 찾습니다. 요청은 사용자 PC 의 itda-hyve 앱이 보냅니다.
- itda-hyve 0.10.4 이상을 설치하고 Claude 에 연결합니다(내려받기).
- 네이버 개발자센터에서 애플리케이션을 등록하고, 사용 API 에 검색과 데이터랩(검색어트렌드) 을 함께 넣습니다. 발급되는 Client ID 와 Client Secret 을 복사합니다. 자세한 절차: 네이버 오픈API 발급 가이드.
- itda-hyve 앱의 시크릿 탭에
NAVER_CLIENT_ID·NAVER_CLIENT_SECRET이름으로 등록합니다. web-search 스킬에 이미 등록했다면 그대로 쓰입니다.
키 값을 대화창에 붙여 넣지 마세요 — 받아도 쓰지 않고 시크릿 탭 등록을 안내합니다. 키를 Claude Code 설정 파일·환경변수·.env 에 넣는 방식은 쓰지 않습니다(스킬이 읽지 않습니다).
⚠️ 신규 발급 안내 (2026-07-31부터): 네이버가 이 API들을 네이버클라우드의 NAVER API HUB로 옮기고 있어요. 이미 발급받은 키는 2027-06-30까지 그대로 쓸 수 있습니다.
지금 빠지는 것
| 기능 | 지금 |
|---|---|
| 검색량 surge 측정 · 가게 찾기 | 됩니다 |
| 월 검색량(레벨) · 협찬 거품 거르기 | 빠집니다 — 네이버 검색광고 API 가 itda-hyve 의 요청 서명 기능을 기다립니다. 결과에 “월검색 미확인 · 거품 판정 보류” 로 표시됩니다 |
| 자동완성으로 후보 넓히기 | 쓰지 않습니다 — 네이버 자동완성 주소가 자동 수집을 막고 있습니다. 후보는 지역×음식 조합(맛집·카페·디저트·국밥 등 10가지)입니다 |
한 번 물을 때 itda-hyve 가 네이버에 보내는 요청은 지역만 말하면 13번 안팎, 동네+주제면 3번입니다. 데이터랩은 하루 1,000번 한도가 있습니다.
이렇게 말해보세요
| 하고 싶은 것 | 이렇게 말하세요 |
|---|---|
| 여행지에서 뜨는 음식 탐색 | /eatery-trend 제주 요즘 뜨는 맛집 알려줘, /eatery-trend 부산 트렌디한 카페 뭐야 |
| 특정 동네 + 음식 조합 | /eatery-trend 성수에서 트렌디한 국밥집 찾아줘, /eatery-trend 연남동 지금 뜨는 파스타 |
| 디저트·카페 트렌드 | /eatery-trend 강릉 지금 핫한 디저트 뭐야, /eatery-trend 홍대 요즘 뜨는 카페 |
| 넓게 본 뒤 좁히기 | 먼저 /eatery-trend 제주 뜨는 음식으로 넓게 보고, 관심 키워드가 보이면 /eatery-trend 제주 디저트로 좁혀서 다시 물어보세요 |
지역만 말하면 지금 뜨는 음식·디저트·테마 키워드를 찾아드리고, 동네+주제를 같이 말하면 그 조합이 실제로 트렌디한지 가게 목록과 함께 알려드립니다.
결과 읽는 법
결과에는 세 가지 유형의 키워드가 나뉘어 표시됩니다.
| 표시 | 의미 |
|---|---|
| 🆕 신규출현 | 최근 검색량이 급격히 생겨난 신흥 키워드 |
| 🔥 검증상승 | 검색량이 꾸준히 오르는 확인된 상승세 |
| 📺 미디어스파이크 | 성시경·흑백요리사 등 방송 효과로 급증한 키워드 |
📺 미디어스파이크 키워드에 “막주 모멘텀 붕괴” 경고가 있으면 방송 직후보다 지금은 줄이 빠졌을 수 있습니다.
레벨(월 검색량)과 속도(surge)는 다릅니다. 월 검색량이 많아도 최근 변화가 없으면 유명한 클래식이지 유행이 아닙니다. 이 스킬은 유행의 속도를 봅니다(월 검색량은 지금 “미확인” 으로 나옵니다).
팁
- 속도 vs 레벨 구분: 검색량 surge(속도)가 유행 지표입니다. 월 검색량(레벨)이 높아도 최근 변화가 없으면 이미 유명한 곳이지 지금 뜨는 곳이 아닙니다.
- 모드 A(동네+주제)에서 모든 가게에 “뜬다”를 붙이지 않습니다 — 평범하게 영업 중인 가게는 surge가 없는 게 정상입니다. 실제로 이름이 바이럴된 소수에만 표기됩니다.
- 협찬 거품 판정은 지금 보류입니다 — 블로그 리뷰 수를 실제 월 검색량과 견줘야 하는데 월 검색량을 아직 받지 못합니다.
⚠️ 지원하지 않는 것
- 예약·결제·메뉴 가격 조회 (트렌드 탐지 전용입니다)
- 실시간 분 단위 변화 (데이터랩은 일/주 단위 lag이 있습니다)
- 갓 터진 신상 (검색 데이터가 쌓이기 전이라 늦게 잡힙니다)
- 인스타그램 직접 스크래핑 (검색량이 인스타 유행의 그림자이므로 별도 수집은 비목표입니다)
- 전국 단위 디저트 트렌드 (로드맵에 있습니다)
안 될 때
| 증상 | 원인 / 해결 |
|---|---|
소스 상태 경고(🚨 소스 상태) |
검색광고·자동완성은 늘 “사용 안 함” 으로 표시됩니다(위 “지금 빠지는 것”). 데이터랩·지역검색이 실패로 나오면 잠시 후 다시 시도하세요 |
“시크릿이 없다”는 안내 (secret_missing) |
itda-hyve 시크릿 탭에 NAVER_CLIENT_ID·NAVER_CLIENT_SECRET 을 등록한 뒤 다시 물어보세요 |
“Client ID 나 Secret 이 맞지 않는다” (errorCode 024) |
시크릿 탭의 두 값을 다시 복사해 넣으세요. 데이터랩을 사용 API 에 넣지 않았으면 010 이 나옵니다 |
| 결과가 비었는데 경고도 있을 때 | 데이터를 못 가져온 것입니다. 없는 트렌드가 아니라 연결 문제일 수 있으니 잠시 후 재시도하세요 |
| 가게가 0개 매핑될 때 | 팝업 스토어이거나 네이버 지역검색에 미등록된 곳일 수 있습니다. 웹 검색으로 보완해 달라고 말하세요 |