네이버 검색 MCP 서버

이 MCP(Multi-platform Communication Protocol) 서버는 네이버 검색 API에 대한 접근을 제공하여 AI 에이전트가 네이버에서 다양한 유형의 콘텐츠를 검색할 수 있도록 합니다.

개요

블로그, 뉴스, 책, 이미지, 쇼핑 아이템 등을 검색하세요
페이지 매김을 지원하는 다양한 검색 카테고리
LLM 소비에 최적화된 구조화된 텍스트 응답
성인용 콘텐츠 확인
키보드 입력 오류(errata) 변환

설정

필수 조건

파이썬 3.12+
네이버 개발자 API 자격 증명
- 이러한 자격 증명은 Naver 개발자 포털에 가입하여 얻을 수 있습니다.
- 그리고 저의 블로그 Naver 검색 API MCP 서버 도 확인하실 수 있습니다.

설치

저장소를 복제합니다.

지엑스피1

자외선 설치

curl -LsSf https://astral.sh/uv/install.sh | sh

가상 환경을 만들고 종속성을 설치합니다.

uv venv -p 3.12
source .venv/bin/activate
pip install -r requirements.txt

Naver API 자격 증명으로 .env 파일을 만듭니다.

cp env.example .env
vi .env

NAVER_CLIENT_ID=your_client_id_here
NAVER_CLIENT_SECRET=your_client_secret_here

Docker 사용하기

Docker 이미지를 빌드합니다.

docker build -t py-mcp-naver-search .

컨테이너를 실행합니다.

docker run py-mcp-naver-search

로컬 사용

서버를 실행합니다:

mcp run server.py

MCP 설정 구성

MCP 설정 파일에 서버 구성을 추가합니다.

클로드 데스크톱 앱

Smithery를 통해 자동으로 설치하려면:

npx -y @smithery/cli install @jikime/py-mcp-naver-search --client claude

수동으로 설치하려면 ~/Library/Application Support/Claude/claude_desktop_config.json 엽니다.

mcpServers 개체에 다음을 추가합니다.

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

커서 IDE

~/.cursor/mcp.json 엽니다

mcpServers 개체에 다음을 추가합니다.

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-naver-search",
        "run",
        "server.py"
      ]
    }
  }
}

도커를 위해

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "py-mcp-naver-search"
      ]
    }
  }
}

클라이언트 사용

저장소에는 테스트를 위한 클라이언트 스크립트가 포함되어 있습니다.

# Basic search
uv run client.py blog "Python programming" display=5 page=1

# News search with sorting
uv run client.py news "AI" display=10 page=1 sort=date

# Image search with filtering
uv run client.py image "cat" display=10 filter=large

# Check for adult content
uv run client.py adult "your query"

# Errata correction
uv run client.py errata "spdlqj"

사용 가능한 검색 카테고리

이 서버는 다음과 같은 검색 카테고리를 지원합니다.

blog - 블로그 게시물
news - 뉴스 기사
book - 책
adult - 성인 콘텐츠 확인
encyc - 백과사전 항목
cafe_article - 카페 기사
kin - 지식 iN Q&A
local - 지역 비즈니스 정보
errata - 키보드 입력 오류 수정
shop - 쇼핑 품목
doc - 학술 논문 및 문서
image - 이미지
webkr - 웹 문서

API 참조

도구

블로그 검색

search_blog(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드를 사용하여 네이버에서 블로그를 검색합니다.

뉴스 검색

search_news(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 뉴스를 검색합니다.

책 검색

search_book(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 도서정보를 검색합니다.

성인 쿼리 확인

check_adult_query(query: str) -> str

입력 쿼리가 성인 검색어인지 여부를 확인합니다.

백과사전 검색

search_encyclopedia(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 백과사전 정보를 검색합니다.

카페 기사 검색

search_cafe_article(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 카페기사를 검색합니다.

KnowledgeiN 검색

search_kin(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 Knowledge iN Q&A를 검색합니다.

지역 검색

search_local(query: str, display: int = 5, page: int = 1, sort: str = "random") -> str

주어진 키워드를 사용하여 지역 비즈니스 정보를 검색합니다.

정정된 오류

correct_errata(query: str) -> str

한국어/영어 키보드 입력 오류를 변환합니다.

상점 검색

search_shop(query: str, display: int = 10, page: int = 1, sort: str = "sim") -> str

주어진 키워드로 네이버에서 쇼핑 상품 정보를 검색합니다.

문서 검색

search_doc(query: str, display: int = 10, page: int = 1) -> str

주어진 키워드를 사용하여 학술 논문, 보고서 등을 검색합니다.

이미지 검색

search_image(query: str, display: int = 10, page: int = 1, sort: str = "sim", filter: str = "all") -> str

주어진 키워드를 사용하여 이미지를 검색합니다.

웹 문서 검색

search_webkr(query: str, display: int = 10, page: int = 1) -> str

주어진 키워드를 사용하여 웹 문서를 검색합니다.

자원

사용 가능한 검색 카테고리

GET http://localhost:8000/available-search-categories

이 MCP 서버에서 사용 가능한 Naver 검색 카테고리 목록을 반환합니다.

응답 형식

모든 도구는 LLM 처리에 최적화된 구조화된 텍스트 형식으로 응답을 반환합니다.

Naver Blog search results (total 12,345 of 1~10):

### Result 1
Title(title): Sample Blog Post
Link(link): https://blog.example.com/post1
Description(description): This is a sample blog post about...
Blogger name(bloggername): John Doe
Blogger link(bloggerlink): https://blog.example.com
Post date(postdate): 20250429

### Result 2
...

감사의 말

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Integrations