네이버 검색 MCP 설치 가이드 — 뉴스·블로그·쇼핑 검색을 Claude에 연결하기

네이버 검색 MCP 서버를 Claude에 연결하면, 대화창에서 자연어로 요청하는 것만으로 뉴스·블로그·쇼핑·이미지 검색 결과를 실시간으로 가져올 수 있습니다. 네이버 오픈API 키 하나(또는 API 키 없이 Chrome CDP 방식)를 준비하고 Claude Desktop 설정 파일에 서버를 등록하면, 5분 안에 국내 최대 포털의 검색 인프라를 AI 에이전트 워크플로에 붙일 수 있습니다. 이 가이드는 키 발급부터 첫 번째 검색 쿼리 실행까지 완전히 안내합니다.

왜 네이버 검색 MCP가 필요한가

Claude는 학습 데이터 기준일 이후의 최신 정보를 알지 못합니다. 트렌드 분석, 최신 뉴스 모니터링, 국내 쇼핑 가격 비교, 블로그 후기 조사 같은 작업은 실시간 검색이 필수입니다. 네이버는 국내 포털 점유율 1위로, 특히 한국어 블로그·카페·뉴스 데이터 품질이 타 검색 엔진 대비 압도적으로 풍부합니다.

MCP(Model Context Protocol) 서버를 사용하면 Claude가 네이버 검색 API에 직접 요청을 보내고, 반환된 검색 결과를 바탕으로 요약·분류·비교·보고서 작성까지 이어서 처리할 수 있습니다. 사용자가 직접 검색창을 열고 복사·붙여넣기 하는 번거로움 없이, 대화 한 문장으로 끝납니다.

사용자 (Claude 대화창)
    │
    ▼
MCP 클라이언트 (Claude Desktop / Claude Code)
    │
    ▼
네이버 검색 MCP 서버
    │
    ├─► 네이버 오픈API (검색 — 뉴스 / 블로그 / 쇼핑 / 이미지)
    └─► (AgentWebSearch-MCP 방식: Chrome CDP → 네이버·구글·Brave 병렬)
    │
    ▼
Claude — 결과 요약 / 비교 / 보고서 생성

사용 가능한 네이버 검색 MCP 서버 비교

현재 MCP모아에 등록된 네이버 연동 서버 중 검색 기능을 제공하는 서버는 다음과 같습니다.

서버 이름	설치 방식	API 키 필요	검색 대상	저장소
에이전트웹서치 MCP	stdio (로컬 실행)	불필요	네이버·구글·Brave 병렬	GitHub
한국어 맞춤법 검사 MCP	npx	불필요	네이버 맞춤법 검사기	GitHub
네이웍스 MCP 서버	npx	필요 (LINE WORKS)	LINE WORKS 업무 도구	GitHub

검색 목적에 가장 직접적인 서버는 AgentWebSearch-MCP입니다. API 키 없이 Chrome CDP를 통해 네이버를 포함한 복수 검색 엔진을 병렬로 쿼리합니다. 네이버 오픈API 공식 키를 사용하는 전용 MCP를 원한다면, GitHub에서 naver-search 혹은 naver mcp로 검색해 직접 클론하는 방법도 있습니다(아래 단계에서 오픈API 방식도 함께 안내합니다).

준비물

• Claude Desktop 최신 버전 또는 Claude Code CLI
• Node.js 18 이상 (npx 방식 서버 사용 시)
• Chrome 브라우저 (AgentWebSearch-MCP 사용 시)
• 네이버 오픈API Client ID·Client Secret — 오픈API 기반 MCP 서버 사용 시 필요 (developers.naver.com 무료 발급)

단계별 설치 및 설정

1단계: 네이버 오픈API 애플리케이션 등록 및 키 발급

오픈API 기반 MCP 서버를 사용할 계획이라면 이 단계를 진행하세요. API 키 없이 Chrome CDP 방식(AgentWebSearch-MCP)을 사용한다면 2단계로 바로 넘어가도 됩니다.

1. developers.naver.com에 접속해 네이버 계정으로 로그인합니다.
2. 상단 메뉴에서 Application → 애플리케이션 등록을 선택합니다.
3. 애플리케이션 이름(예: my-mcp-search)을 입력하고, 사용 API 목록에서 검색을 체크합니다.
4. 환경 항목에서 WEB 설정을 선택하고 로컬 테스트용으로 http://localhost를 등록합니다.
5. 등록 완료 후 Client ID와 Client Secret을 복사해 안전한 곳에 보관합니다.

발급된 키는 검색 API 기준 하루 25,000건 무료 호출이 가능합니다. 일반적인 개인 프로젝트·업무 자동화 용도라면 충분합니다.

2단계: MCP 서버 선택 및 설치

방법 A — AgentWebSearch-MCP (API 키 불필요)

GitHub 저장소를 로컬에 클론하고 의존성을 설치합니다.

git clone https://github.com/insung8150/AgentWebSearch-MCP
cd AgentWebSearch-MCP
npm install

이 서버는 Chrome 원격 디버깅(CDP)을 사용하므로, Claude Desktop을 시작하기 전에 Chrome을 다음과 같이 실행해야 합니다.

# macOS 예시
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 --no-first-run --no-default-browser-check

# Windows 예시 (PowerShell)
& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
  --remote-debugging-port=9222 --no-first-run --no-default-browser-check

방법 B — 네이버 오픈API 기반 MCP (Client ID·Secret 필요)

오픈API를 직접 호출하는 MCP 서버를 GitHub에서 찾아 클론하거나, npx 패키지가 배포되어 있다면 설정 파일에서 npx 명령으로 바로 실행할 수 있습니다. 아래 3단계의 JSON 예시를 참고해 본인이 선택한 서버에 맞게 경로와 명령을 조정하세요.

3단계: Claude Desktop 설정 파일 수정

Claude Desktop의 MCP 설정 파일 위치는 운영체제에 따라 다릅니다.

OS	설정 파일 경로
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

AgentWebSearch-MCP 설정 예시:

{
  "mcpServers": {
    "agentwebsearch": {
      "command": "node",
      "args": ["/절대경로/AgentWebSearch-MCP/index.js"]
    }
  }
}

/절대경로/AgentWebSearch-MCP/ 부분을 실제 클론한 디렉터리의 절대 경로로 바꾸세요. macOS라면 /Users/사용자명/AgentWebSearch-MCP/index.js 형태입니다.

네이버 오픈API 기반 MCP 설정 예시 (npx 방식 서버인 경우):

{
  "mcpServers": {
    "naver-search": {
      "command": "npx",
      "args": ["-y", "패키지명"],
      "env": {
        "NAVER_CLIENT_ID": "여기에_Client_ID_입력",
        "NAVER_CLIENT_SECRET": "여기에_Client_Secret_입력"
      }
    }
  }
}

환경변수 이름(NAVER_CLIENT_ID, NAVER_CLIENT_SECRET)은 사용하는 MCP 서버의 README를 확인하세요. 서버마다 다를 수 있습니다.

4단계: Claude Desktop 재시작 및 연결 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 새 대화창 입력창 왼쪽 하단의 **도구 아이콘(망치 모양)**을 클릭해 네이버 검색 관련 도구가 목록에 표시되면 연결 성공입니다.

5단계: 첫 번째 검색 쿼리 실행

연결이 확인됐다면 바로 검색을 시작해 보세요.

네이버 뉴스 검색 예시:

네이버 뉴스에서 "AI 에이전트" 최신 기사 5건을 가져와서 핵심 내용을 요약해줘.

네이버 블로그 후기 조사 예시:

네이버 블로그에서 "맥북 프로 M4 후기" 검색 결과 상위 10건의 제목과 링크를 표로 정리해줘.

네이버 쇼핑 가격 비교 예시:

네이버 쇼핑에서 "무선 청소기" 검색 결과 중 가격 낮은 순으로 5개 제품명과 가격을 알려줘.

네이버 검색 API 유형별 활용 사례

검색 유형	대표 활용 사례	반환 데이터
뉴스	키워드 트렌드 모니터링, 미디어 분석	제목·본문 요약·링크·발행일
블로그	제품 후기 수집, 맛집 조사, 여행 정보	제목·요약·블로거명·링크
쇼핑	가격 비교, 최저가 탐색	상품명·가격·쇼핑몰·이미지
이미지	레퍼런스 이미지 수집	이미지 URL·제목·썸네일
백과사전	개념 정의, 배경 조사	제목·본문 요약·링크
지역	음식점·숙박 검색, 지역 정보	장소명·주소·전화번호·링크

Claude는 검색 결과를 단순 나열하는 데 그치지 않고, 결과 간 비교·패턴 분석·요약 보고서 작성까지 이어서 처리합니다. 예를 들어 뉴스 20건을 가져온 뒤 “긍정/부정 논조를 분류하고 주요 키워드를 추출해줘”처럼 후속 분석을 요청할 수 있습니다.

흔한 오류와 해결 방법

오류: “도구 목록에 검색 도구가 안 보입니다”

• 설정 파일(claude_desktop_config.json)의 JSON 문법을 확인하세요. 중괄호·따옴표·쉼표 하나가 빠져도 서버 전체가 로드되지 않습니다. 온라인 JSON 검증 도구(예: jsonlint.com)에 붙여넣어 오류를 찾아보세요.
• Claude Desktop을 완전히 종료했다가 다시 시작했는지 확인하세요. 백그라운드에 프로세스가 남아 있으면 새 설정이 반영되지 않습니다.
• AgentWebSearch-MCP 사용 시 Chrome이 --remote-debugging-port=9222로 실행되고 있는지 확인하세요.

오류: “401 Unauthorized” 또는 “인증 오류”

• Client ID와 Client Secret이 올바르게 입력됐는지 확인합니다. 앞뒤 공백이 섞이는 경우가 많습니다.
• 네이버 개발자 센터에서 해당 애플리케이션에 검색 API가 활성화되어 있는지 확인하세요.
• 키 발급 직후에는 수 분간 활성화 지연이 있을 수 있습니다.

오류: “하루 호출 한도 초과”

네이버 오픈API 검색은 하루 25,000건이 무료 한도입니다. 대량 자동화 작업을 계획한다면 API 호출 수를 줄이거나, 결과를 로컬에 캐싱하는 방식을 고려하세요.

AgentWebSearch-MCP에서 Chrome 연결 실패

• Chrome이 실행 중인지, 9222 포트가 열려 있는지 확인합니다.
• 방화벽이나 보안 소프트웨어가 로컬 포트를 막고 있을 수 있습니다.
• Chrome을 종료 후 위에서 안내한 명령으로 다시 실행해 보세요.

활용 확장: 맞춤법 교정과 검색을 함께 사용하기

한국어 맞춤법 검사 MCP를 함께 설치하면, 검색 전 쿼리의 오타를 자동으로 교정한 뒤 네이버에 보내는 파이프라인을 만들 수 있습니다. Claude에게 “이 문장을 먼저 맞춤법 검사한 뒤 네이버 블로그에서 검색해줘”라고 요청하는 것만으로도 충분합니다. 두 MCP 서버를 동시에 등록해 두면 Claude가 상황에 맞게 두 도구를 조합합니다.

업무 협업 맥락에서 검색 결과를 LINE WORKS 채널로 공유해야 한다면 네이웍스 MCP 서버도 함께 살펴보세요. 검색 요약 결과를 팀 채널에 즉시 전송하는 워크플로를 구성할 수 있습니다.

더 많은 국내 검색·포털 관련 MCP 서버를 탐색하려면 카카오·네이버 카테고리 페이지를 방문하거나, 전체 서버 목록에서 원하는 서버를 직접 찾아보세요.

자주 묻는 질문

네이버 오픈API 키는 무료로 발급받을 수 있나요?

네, developers.naver.com에서 회원가입 후 무료로 발급받을 수 있습니다. 검색 API는 하루 25,000건까지 무료로 요청할 수 있으며, 초과 시 유료 플랜이 필요합니다.

API 키 없이 네이버를 검색하는 MCP 서버도 있나요?

네, AgentWebSearch-MCP는 Chrome CDP(원격 디버깅)를 활용해 API 키 없이 네이버·구글·Brave를 병렬 검색할 수 있습니다. 단, Chrome이 설치되어 있어야 하고 원격 디버깅 포트를 열어야 합니다.

네이버 블로그, 뉴스, 쇼핑을 동시에 검색할 수 있나요?

네이버 오픈API 기반 MCP 서버는 각 유형별 엔드포인트를 별도 도구로 제공합니다. Claude에게 ‘네이버 블로그와 뉴스에서 동시에 검색해줘’라고 요청하면 여러 도구를 순차 또는 병렬로 호출합니다.

Claude Desktop과 Claude Code 중 어디서 사용하나요?

두 환경 모두 지원합니다. Claude Desktop은 claude_desktop_config.json을, Claude Code는 프로젝트 내 .mcp.json 파일을 사용합니다. 설정 방법은 본문의 단계별 안내를 참고하세요.

검색 결과 건수를 조절할 수 있나요?

네이버 오픈API는 display 파라미터로 한 번에 최대 100건까지 반환할 수 있습니다. MCP 서버 도구 호출 시 Claude에게 “최대 30건 가져와줘”처럼 요청하면 해당 수만큼 반환됩니다.

맞춤법이 틀린 검색어도 제대로 검색되나요?

네이버 검색 API 자체에 오타 보정 기능이 내장되어 있습니다. 더 정확한 한국어 입력이 필요하다면 한국어 맞춤법 검사 MCP와 함께 사용하는 것을 권장합니다.

다음 단계

네이버 검색 MCP 서버 설치가 완료됐다면, 먼저 관심 키워드로 뉴스·블로그 검색을 시도해 보세요. 검색 결과를 요약하거나 시계열로 정리하는 자동화 워크플로를 만드는 것도 좋은 출발점입니다.

더 많은 MCP 서버와 활용 가이드는 가이드 목록에서 확인하실 수 있습니다. 새로운 국내 MCP 서버를 발견했다면 서버 등록도 환영합니다.