네이버 쇼핑 검색 MCP 설치 가이드 — Claude로 상품 가격 비교 자동화

Q: API 키 없이도 네이버 쇼핑을 MCP로 검색할 수 있나요?

AgentWebSearch-MCP를 사용하면 Chrome 원격 디버깅(CDP) 방식으로 API 키 없이 네이버를 검색할 수 있습니다. 단, Chrome이 설치되어 있어야 하고, 원격 디버깅 포트(9222)를 열어서 실행해야 합니다.

Q: 검색 결과에 최저가·판매처 정보가 포함되나요?

네이버 오픈API 쇼핑 검색은 상품명, 가격(lprice/hprice), 쇼핑몰명, 상품 링크, 이미지 URL, 카테고리 정보를 반환합니다. Claude가 이 데이터를 바탕으로 최저가 순 정렬이나 판매처 비교를 자동으로 해줍니다.

Q: Claude Code에서도 네이버 쇼핑 MCP를 사용할 수 있나요?

네, 사용 가능합니다. Claude Code는 프로젝트 루트의 .mcp.json 파일에 서버를 등록합니다. 설정 형식은 claude_desktop_config.json과 동일합니다.

Q: 쇼핑 검색 결과를 엑셀이나 CSV로 저장할 수 있나요?

Claude에게 '결과를 CSV 형식으로 표 만들어줘'라고 요청하면 즉시 마크다운 표나 CSV 텍스트를 생성해줍니다. 파일로 저장하려면 Claude Code의 파일 쓰기 도구와 함께 사용하거나, 출력 텍스트를 직접 복사해 사용하세요.

Q: 네이버 쇼핑 MCP로 가격 추적 알림을 만들 수 있나요?

MCP 단독으로는 주기적 알림 기능이 없습니다. 하지만 Claude Code나 별도 스크립트에서 MCP를 주기적으로 호출하고, 가격 변동 시 LINE WORKS(네이웍스 MCP 서버 활용) 등으로 알림을 보내는 워크플로를 구성할 수 있습니다.

네이버 쇼핑 검색 MCP를 Claude에 연결하면, 대화창에 상품명을 입력하는 것만으로 국내 쇼핑몰 가격과 판매처를 조회하고 비교 표를 자동 생성할 수 있습니다. 연결 방법은 두 가지입니다. 네이버 오픈API 키(무료, 하루 25,000건)를 발급해 쓰는 방식과, API 키 없이 Chrome 원격 디버깅으로 검색하는 방식입니다. 이 가이드는 두 방식을 모두 다루며, 키 발급부터 Claude에서 첫 쇼핑 쿼리를 실행하는 것까지 순서대로 설명합니다.

두 가지 연결 방식, 무엇을 고를까

설치를 시작하기 전에 어느 쪽이 본인 환경에 맞는지 먼저 정하는 편이 빠릅니다. 핵심 차이는 다음과 같습니다.

구분	오픈API 방식 (방법 B)	Chrome CDP 방식 (방법 A)
API 키	Client ID·Secret 필요 (무료 발급)	불필요
사전 준비	네이버 개발자 센터 애플리케이션 등록	Chrome을 원격 디버깅 모드로 실행
반환 데이터	가격·판매처·카테고리 등 구조화된 필드	브라우저가 본 검색 결과 화면 기반
호출 한도	하루 25,000건	명시적 한도 없음(브라우저 동작에 의존)
안정성	응답 필드가 고정되어 후처리가 정확	페이지 구조 변화에 영향받을 수 있음

가격 정렬·판매처 비교처럼 정확한 수치 후처리가 필요하면 오픈API 방식을, 키 발급 없이 빠르게 시험해 보고 싶다면 Chrome CDP 방식을 권장합니다.

동작 흐름

어느 방식이든 사용자는 자연어 한 문장만 입력하고, 데이터 수집과 정렬·비교·표 작성은 Claude가 처리합니다.

사용자 (Claude 대화창)
    │
    ▼
MCP 클라이언트 (Claude Desktop / Claude Code)
    │
    ▼
네이버 쇼핑 MCP 서버
    │
    ├─ 방법 B ─▶ 네이버 쇼핑 검색 API (오픈API)
    │
    └─ 방법 A ─▶ AgentWebSearch-MCP → Chrome CDP → 네이버 쇼핑
    │
    ▼
Claude — 가격 정렬 / 판매처 비교 / 보고서 생성

오픈API가 반환하는 데이터 필드

오픈API 방식(방법 B)을 쓰면 네이버 쇼핑 검색은 요청 한 번에 다음 필드를 반환합니다. Claude는 이 원시 필드를 받아 후처리를 즉석에서 수행합니다.

필드	설명	활용 예
`title`	상품명 (HTML 태그 포함)	태그 정제 후 목록 출력
`lprice`	최저가 (원)	가격 오름차순 정렬 기준
`hprice`	최고가 (원)	가격 편차 분석
`mallName`	판매 쇼핑몰명	판매처 비교·중복 제거
`link`	상품 페이지 URL	바로가기 링크
`image`	썸네일 이미지 URL	이미지 확인
`category1`~`category4`	대·중·소·세 카테고리	카테고리별 필터
`productId`	네이버 쇼핑 고유 ID	동일 상품 중복 제거

예를 들어 “lprice 기준 오름차순 정렬”, “mallName 중복 제거”, “10만 원 이하만 필터” 같은 요청을 별도 코드 없이 자연어로 지시할 수 있습니다.

준비물

Claude Desktop 최신 버전 또는 Claude Code CLI
Node.js 18 이상 — npx·node 기반 MCP 서버 실행 시
Chrome 브라우저 — 방법 A(AgentWebSearch-MCP) 사용 시
네이버 오픈API Client ID·Client Secret — 방법 B 사용 시 (무료 발급)

단계별 설치 및 설정

1단계: 네이버 오픈API 키 발급 (방법 B 선택 시)

오픈API 기반 서버를 쓸 계획이면 이 단계를 진행합니다. Chrome CDP 방식(방법 A)만 쓸 거라면 2단계로 건너뛰어도 됩니다.

developers.naver.com에 접속해 네이버 계정으로 로그인합니다.
상단 메뉴에서 Application → 애플리케이션 등록을 클릭합니다.
애플리케이션 이름(예: claude-shopping-mcp)을 입력합니다.
사용 API 목록에서 검색을 체크합니다. 쇼핑 검색 엔드포인트는 검색 API에 포함됩니다.
환경 항목에서 WEB 설정을 선택하고 서비스 URL에 http://localhost를 등록합니다.
등록 후 발급된 Client ID와 Client Secret을 복사해 안전한 곳에 보관합니다.

발급 직후 수 분간 활성화 지연이 있을 수 있으므로, 다음 단계를 진행하는 동안 준비되도록 키부터 먼저 발급해 두는 것을 권장합니다.

2단계: MCP 서버 선택 및 준비

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

에이전트웹서치 MCP는 Chrome 원격 디버깅(CDP)을 사용해 API 키 없이 네이버를 브라우저처럼 검색합니다. GitHub 저장소를 로컬에 클론해서 사용합니다.

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

이 서버를 쓰려면 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 직접 호출

네이버 오픈API를 직접 호출해 쇼핑 검색 결과를 반환하는 MCP 서버를 직접 구성하거나, GitHub에서 naver shopping mcp 키워드로 검색해 적합한 서버를 찾을 수 있습니다. 어떤 서버를 쓰든 환경변수 키 이름과 실행 방법은 그 서버의 README를 기준으로 삼으세요. npx로 배포된 패키지가 있다면 별도 설치 없이 3단계 설정에서 바로 실행됩니다.

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

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

운영체제	설정 파일 경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

방법 A — AgentWebSearch-MCP 설정 예시:

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

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

방법 B — 네이버 오픈API 기반 MCP 설정 예시 (npx):

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

패키지명과 환경변수 키 이름(NAVER_CLIENT_ID, NAVER_CLIENT_SECRET)은 사용하는 서버마다 다를 수 있으므로 해당 서버의 README에서 정확한 값을 확인하세요. 임의로 패키지명을 추정해 넣으면 실행되지 않습니다.

Claude Code 사용자: 설정 형식은 동일하되, 파일 위치만 프로젝트 루트의 .mcp.json으로 바뀝니다. mcpServers 객체 구조는 그대로 사용하면 됩니다.

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

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 새 대화창 입력란 왼쪽 하단의 **도구 아이콘(망치 모양)**을 눌렀을 때 쇼핑 검색 관련 도구가 목록에 나타나면 연결이 완료된 것입니다.

도구가 보이지 않으면 가장 먼저 설정 파일의 JSON 문법을 확인하세요. 중괄호나 쉼표 하나가 빠져도 MCP 서버 전체가 로드되지 않습니다.

5단계: 첫 번째 가격 비교 쿼리 실행

연결이 확인됐다면 다음과 같이 요청해 보세요.

기본 가격 비교:

네이버 쇼핑에서 "에어팟 프로 2세대" 검색 결과를 가져와서
가격 낮은 순으로 상위 5개 판매처를 표로 정리해줘.

복수 상품 비교:

네이버 쇼핑에서 "다이슨 에어랩"과 "다이슨 슈퍼소닉"의 최저가를 각각 검색하고
두 제품의 가격 차이와 주요 판매처를 비교해줘.

가격대 필터:

네이버 쇼핑에서 "무선 청소기"를 검색해서
10만 원 이하 제품만 최저가 순으로 10개 알려줘.

오픈API 방식에서는 Claude가 응답의 lprice 값을 기준으로 정렬·필터·표 생성을 즉시 수행합니다.

실전 활용 시나리오

시나리오	Claude 요청 예시	결과
소싱 조사	”무선 이어폰 카테고리에서 5만 원 이하 신제품 10개 리스트업”	상품명·가격·링크 표
경쟁사 모니터링	”브랜드 A의 신제품과 경쟁 브랜드 유사 상품 가격 비교”	가격 편차 분석 요약
구매 대행 견적	”특정 상품의 최저가·최고가·평균가를 계산해줘”	가격 범위 산출
트렌드 파악	”캠핑 용품 카테고리 인기 상품 20개 카테고리별 분류”	분류 리스트
리포트 작성	”이번 주 검색한 상품 목록을 카테고리별로 정리해 보고서 초안 작성”	마크다운 보고서

흔한 오류와 해결 방법

도구 목록에 서버가 나타나지 않을 때

설정 파일(claude_desktop_config.json 또는 .mcp.json)의 JSON 문법 오류가 가장 흔한 원인입니다. 온라인 JSON 검증 도구(예: jsonlint.com)에 내용을 붙여넣어 오류 위치를 확인한 뒤, 수정하고 Claude Desktop을 완전히 종료했다가 다시 시작하세요.

”401 Unauthorized” 등 인증 오류 (방법 B)

먼저 Client ID와 Secret이 정확한지, 복사·붙여넣기 과정에서 앞뒤 공백이 섞이지 않았는지 확인합니다. 그다음 네이버 개발자 센터에서 해당 애플리케이션에 검색 API가 활성화되어 있는지 확인하세요. 키 발급 직후에는 수 분간 활성화가 지연될 수 있습니다.

API 호출 한도 초과 (방법 B)

네이버 오픈API 검색은 하루 25,000건이 무료 한도입니다. 대량 소싱 조사처럼 단시간에 많은 검색을 실행하면 한도에 도달할 수 있습니다. 이때는 요청 간 간격을 두거나, 받은 결과를 로컬에 저장해 재사용하는 방식을 고려하세요.

Chrome 연결 실패 (방법 A)

Chrome이 --remote-debugging-port=9222 옵션으로 실행 중인지 확인합니다. 이미 일반 모드로 Chrome이 열려 있다면 모두 종료한 뒤 2단계의 명령어로 새로 실행해야 합니다. 방화벽이나 보안 소프트웨어가 로컬 9222 포트를 차단하고 있을 수도 있습니다.

함께 활용하면 좋은 MCP 서버

한국어 맞춤법 검사 MCP를 함께 설치하면 검색어를 네이버에 보내기 전에 오타를 교정하는 파이프라인을 만들 수 있습니다. 예를 들어 “이 상품 목록의 한국어 표기를 먼저 교정한 뒤 각각 네이버 쇼핑에서 검색해줘”처럼 두 MCP를 이어 쓸 수 있습니다.

검색 결과를 팀에 공유해야 한다면 네이웍스 MCP 서버도 살펴보세요. LINE WORKS 채널로 결과를 자동 전송하는 워크플로를 구성할 수 있습니다.

더 많은 네이버·카카오 연동 서버는 카카오·네이버 카테고리에서, 그 외 서버는 전체 서버 목록에서 탐색할 수 있습니다.

자주 묻는 질문

네이버 쇼핑 검색 API 키는 무료로 발급받을 수 있나요?

네, developers.naver.com에서 회원가입 후 무료로 발급할 수 있습니다. 쇼핑 검색 API는 하루 25,000건까지 무료로 호출할 수 있어, 일반적인 가격 비교 자동화 용도라면 충분한 한도입니다.

API 키 없이도 네이버 쇼핑을 MCP로 검색할 수 있나요?

AgentWebSearch-MCP를 쓰면 Chrome 원격 디버깅(CDP) 방식으로 API 키 없이 검색할 수 있습니다. 단, Chrome이 설치되어 있어야 하고 원격 디버깅 포트(9222)를 열어 실행해야 합니다.

검색 결과에 최저가·판매처 정보가 포함되나요?

오픈API 쇼핑 검색은 상품명, 최저가(lprice), 최고가(hprice), 쇼핑몰명(mallName), 상품 링크, 이미지 URL, 카테고리 정보를 반환합니다. Claude가 이 데이터를 바탕으로 최저가 순 정렬이나 판매처 비교를 자동으로 처리합니다.

Claude Code에서도 네이버 쇼핑 MCP를 사용할 수 있나요?

네. Claude Code는 프로젝트 루트의 .mcp.json 파일에 서버를 등록하며, 설정 형식은 claude_desktop_config.json과 동일합니다.

쇼핑 검색 결과를 엑셀이나 CSV로 저장할 수 있나요?

Claude에게 “결과를 CSV 형식으로 만들어줘”라고 요청하면 즉시 표나 CSV 텍스트를 생성합니다. 파일로 저장하려면 Claude Code의 파일 쓰기 기능을 함께 활용하거나, 출력 텍스트를 복사해 사용하세요.

네이버 쇼핑 MCP로 가격 추적 알림을 만들 수 있나요?

MCP 단독으로는 주기적 알림 기능이 없습니다. 다만 Claude Code나 외부 스크립트에서 MCP를 주기적으로 호출하고, 가격 변동 시 네이웍스 MCP 서버로 LINE WORKS 알림을 보내는 워크플로를 구성할 수 있습니다.

다음 단계

설치가 끝났다면 평소 자주 찾는 상품을 먼저 검색해 보세요. 결과를 표로 정리하거나 최저가 판매처를 링크로 바로 받아보는 경험이 자동화의 출발점입니다.

더 많은 국내 MCP 활용 가이드는 가이드 목록에서 확인할 수 있고, 새로운 쇼핑 관련 MCP 서버를 발견했다면 서버 등록도 환영합니다.