AI导哈

Naver搜索MCP服务

一个将Naver搜索功能（新闻、博客、网页、图像、购物、知识问答、本地、书籍、咖啡馆）作为工具暴露给Claude和其他MCP客户端的服务器，为无法直接访问互联网的AI代理提供实时韩国网络搜索能力。

  • by kimgeonhee317
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kimgeonhee317/simple-naver-search-mcp

使用说明

简单导航搜索mcp

An MCP server that exposes Naver Search（新闻、博客、网络、图像、购物、知识iN、地区、书籍、咖啡厅）as tools for Claude and other MCP clients。

专为无法直接访问互联网的AI代理而设计，使LLM能够实时访问韩国网络搜索，而无需模型本身的出站HTTP。

需求

设置

# 1. Clone the repo
git clone https://github.com/kimgeonhee317/simple-naver-search-mcp
cd simple-naver-search-mcp

# 2. Install dependencies
uv sync

# 3. Set credentials
cp .env.example .env
# Edit .env and fill in NAVER_CLIENT_ID and NAVER_CLIENT_SECRET

# 4. (Optional) Install dev dependencies for manual API testing
uv sync --extra dev

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "naver-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/simple-naver-search-mcp",
        "run",
        "naver-search-mcp"
      ],
      "env": {
        "NAVER_CLIENT_ID": "your_client_id_here",
        "NAVER_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

可用工具

工具 说明 支持 sort 价值观
naver_search_news 搜索Naver新闻文章 sim, date
naver_search_blog 搜索Naver博客文章 sim, date
naver_search_web 搜索Naver网页 sim, date
naver_search_image 搜索Naver图片 sim, date
naver_search_shop 搜索Naver购物 sim, date, asc （价格↑), dsc （价格↓)
naver_search_doc 搜索Naver学术/办公文档 （对于大多数一般查询，返回空） sim, date
naver_search_local 搜索Naver当地景点 （不支持）
naver_search_kin Search Naver知识iN（Q&A） sim, date, point
naver_search_book 搜索Naver图书 sim, date, count, score
naver_search_cafe 搜索Naver咖啡馆文章 sim, date

所有工具均接受：

参数 类型 必填 默认 说明
query string 是 -- 搜索关键字
display integer 否 10 要返回的结果数（1-100）
sort string 否 "sim" 排序顺序——每个工具的有效值见上表
start integer no 1 分页偏移量（从1开始，最大1000）

分页示例 --获取页面2时 display=10:

start=1  → results  1–10
start=11 → results 11–20
start=21 → results 21–30

结果标头始终显示上下文： total: 1420 | showing: 1~10 | sort: date

注： total Naver的数据是近似值。无论报告的总数如何，实际可检索的结果上限为1000。

示例输出

naver_search_news 
total: 48200 | showing: 1~3 | sort: date

[1] 한국은행, 기준금리 0.25%p 인하 결정
    Mon, 16 Feb 2026 14:32:00 +0900
    한국은행 금융통화위원회가 기준금리를 연 2.75%로 0.25%포인트 인하했다...
    https://www.yna.co.kr/view/AKR20260216XXXXXX

[2] 금리 인하에 부동산 시장 반응은?
    Mon, 16 Feb 2026 15:10:00 +0900
    전문가들은 이번 금리 인하가 침체된 부동산 시장에 온기를 불어넣을 것으로...
    https://www.chosun.com/economy/2026/02/16/XXXXXX
naver_search_blog 
total: 125000 | showing: 1~2 | sort: sim

[1] 제주도 3박4일 혼자 여행 완벽 후기
    by 여행하는곰 (20260110)
    제주도를 혼자 여행하고 왔어요. 숙소는 애월 게스트하우스를 선택했는데...
    https://blog.naver.com/travelbear/XXXXXX

[2] 제주 맛집 총정리 - 현지인 추천 TOP 10
    by 제주토박이 (20260205)
    제주에서 20년 살면서 알게 된 진짜 맛집만 모았습니다. 관광객 맛집 말고...
    https://blog.naver.com/jejunative/XXXXXX
naver_search_web 
total: 980000 | showing: 1~2 | sort: sim

[1] 파이썬 가상환경 설정 방법 - venv, conda 비교
    파이썬 프로젝트를 시작할 때 가상환경을 설정하는 방법과 venv와 conda의 차이점을 설명합니다...
    https://wikidocs.net/XXXXX

[2] Python 가상환경(venv) 완전 정복
    venv 모듈을 사용해 가상환경을 생성하고 활성화하는 방법, 패키지 관리까지 정리했습니다...
    https://dojang.io/mod/page/view.php?id=XXXXX
naver_search_image 
total: 53000 | showing: 1~2 | sort: sim

[1] 골든 리트리버 강아지
    1200x800px
    image: https://shopping-phinf.pstatic.net/XXXXXX.jpg
    thumb: https://thumb.pstatic.net/XXXXXX.jpg

[2] 귀여운 골든 리트리버
    800x600px
    image: https://blogfiles.pstatic.net/XXXXXX.jpg
    thumb: https://thumb.pstatic.net/XXXXXX.jpg
naver_search_shop 
total: 8420 | showing: 1~2 | sort: asc

[1] 나이키 에어맥스 90 화이트 (270mm)
    89000원 ~ 89000원
    나이키공식온라인스토어 | Nike
    https://smartstore.naver.com/XXXXXX

[2] 나이키 에어맥스 90 블랙 (270mm)
    92000원 ~ 95000원
    스포츠용품몰 | Nike
    https://smartstore.naver.com/XXXXXX
naver_search_local 
total: 38 | showing: 1~2 | sort: n/a

[1] 스타벅스 강남점
    카페,음료 | 02-XXX-XXXX
    서울특별시 강남구 테헤란로 XXX
    https://map.naver.com/v5/entry/place/XXXXXX

[2] 스타벅스 강남역점
    카페,음료 | 02-XXX-XXXX
    서울특별시 강남구 강남대로 XXX
    https://map.naver.com/v5/entry/place/XXXXXX
naver_search_kin 
total: 32400 | showing: 1~2 | sort: point

[1] 강아지가 갑자기 밥을 안 먹어요, 이유가 뭔가요?
    강아지가 갑자기 밥을 거부할 때는 여러 가지 원인이 있을 수 있습니다. 스트레스, 환경 변화...
    https://kin.naver.com/qna/detail.naver?d1id=XXXXXX

[2] 강아지 밥 안 먹을 때 해결 방법
    저도 같은 문제로 고민했는데, 사료 브랜드를 바꾸거나 습식 사료를 섞어주면 잘 먹더라고요...
    https://kin.naver.com/qna/detail.naver?d1id=XXXXXX
naver_search_book 
total: 240 | showing: 1~2 | sort: score

[1] 클린 코드
    로버트 C. 마틴 | 인사이트 | 20131231
    22000원
    나쁜 코드도 돌아간다. 하지만 코드가 나쁘면 개발 속도가 크게 떨어진다...
    https://search.shopping.naver.com/book/XXXXXX

[2] 리팩터링 2판
    마틴 파울러 | 한빛미디어 | 20200101
    36000원
    코드 구조를 체계적으로 개선하여 효율적인 리팩터링 구현하기...
    https://search.shopping.naver.com/book/XXXXXX
naver_search_cafe 
total: 15800 | showing: 1~2 | sort: date

[1] 2월 탁구 횡회전 서브 연습 후기
    탁구사랑 (https://cafe.naver.com/tabletennis)
    오늘 드디어 횡회전 서브를 제대로 익혔습니다. 핵심은 라켓 각도보다 손목 스냅이더라고요...
    https://cafe.naver.com/tabletennis/XXXXXX

[2] 횡회전 서브 교정 받고 나서 달라진 점
    탁구동호회 (https://cafe.naver.com/pingpong)
    코치님께 자세 교정 받은 후 서브 성공률이 확 올라갔어요. 팔꿈치 위치가 핵심...
    https://cafe.naver.com/pingpong/XXXXXX

推荐系统提示

工具描述处理单个工具选择，但多工具策略、一致的排序行为和特定于领域的工作流需要系统提示。下面是一个通用的韩语例子。

당신은 네이버 검색 도구를 활용하는 한국어 정보 검색 전문 AI입니다.

## 검색 전략

**다중 도구 활용:**
- 사용자가 종합적인 정보를 요청하면 여러 도구를 함께 사용하세요.
  - 부동산/시세 조회 → news(sort=date) + blog + cafe 조합
  - 상품 구매 결정 → shop(sort=asc) + blog(리뷰) 조합
  - 장소/맛집 탐색 → local + blog 조합
  - 사회적 이슈/트렌드 → news(sort=date) + kin 조합

**정렬 기본값:**
- 최신 뉴스, 시세, 정책, 사건 관련 쿼리 → 반드시 sort=date 사용
- 리뷰, 추천, 일반 정보 쿼리 → sort=sim (기본값) 유지

**쿼리 작성 규칙:**
- naver_search_local: 사용자 문장에서 장소명/상호명만 추출하여 전달
  - 예) "강남에 있는 스타벅스 찾아줘" → query="강남 스타벅스"
- naver_search_news: 핵심 키워드 위주로 간결하게 작성
- naver_search_shop: 브랜드명 + 모델명으로 구체적으로 작성

**검색하지 않아도 되는 경우:**
- 사용자가 일반 상식이나 역사적 사실을 묻는 경우
- 검색 없이 충분히 답할 수 있는 개념 설명 요청

## 결과 처리

- 검색 결과를 그대로 나열하지 말고, 핵심 내용을 요약하여 전달하세요.
- 출처(링크)는 중요한 정보에만 인용하세요.
- 결과가 없거나 부족하면 다른 도구나 다른 키워드로 재시도하세요.
- 페이지네이션: 첫 결과가 불충분하면 start를 늘려 추가 결과를 가져오세요.

这是一个通用模板。为您的特定领域定制它（例如房地产经纪人、购物助理、新闻摘要）。

API测试手册

uv run python scripts/test_api.py

导航搜索API-类型参考

类型 关键字段 注释
news title, originallink, link, description, pubDate 有原始和Naver链接
blog title, link, description, bloggername, bloggerlink, postdate 优秀作者信息
webkr title, link, description 通用网络，元数据最少
image title, link, thumbnail, sizeheight, sizewidth 无描述
shop -- 非产品查询为空
doc -- 对于大多数查询为空
local -- 需要查询地名，而不是句子
kin title, link, description 知识iNQ&A
book -- 非图书查询为空
cafearticle title, link, description, cafename, cafeurl 有咖啡馆名称信息

笔记：

  • title 和 description 包含HTML <b> 标签——在返回结果之前由服务器自动剥离
  • shop, doc, book 非产品/非书籍查询返回空结果
  • local 需要一个地名或企业名称作为查询，而不是一个完整的句子

许可证

麻省理工学院

相关 MCP