naver-shopping-search-mcp

이 프로젝트는 네이버 쇼핑 검색 API를 Model Context Protocol(MCP) 인터페이스로 제공하는 서버입니다.

기능

쇼핑 검색

• 네이버 쇼핑 검색 API의 키워드 기반 상품 검색 기능 제공
• 다양한 정렬 옵션 지원 (정확도순, 날짜순, 가격 오름차순/내림차순)
• 네이버페이 상품 필터링 지원
• 상품 유형 제외 기능 (중고, 렌탈, 해외직구/구매대행)
• 페이지네이션 지원 (최대 1000개)
• 한 번에 표시할 결과 개수 조절 (최대 100개)

설치

npm을 통한 설치

npm install -g naver-shopping-search-mcp-server

소스코드로 설치

# 저장소 클론
git clone https://github.com/your-username/naver-shopping-search-mcp.git
cd naver-shopping-search-mcp

# 의존성 설치 및 빌드
npm install
npm run build

개발 환경 설정

환경 변수 설정

.env 파일을 생성하고 다음 내용을 추가합니다:

# .env.example 파일을 복사하여 .env 파일 생성
cp .env.example .env

# .env 파일을 열고 다음 내용을 수정
NAVER_CLIENT_ID=your_naver_client_id_here
NAVER_CLIENT_SECRET=your_naver_client_secret_here

개발 서버 실행

# 개발 모드로 실행
npm run dev

# 빌드
npm run build

# 실행
npm start

API 사용 방법

쇼핑 검색 파라미터

{
  query: string;              // 검색을 원하는 질의어 (UTF-8 인코딩 필요)
  display?: number;           // 한 번에 표시할 검색 결과 개수 (기본값: 10, 최대: 100)
  start?: number;             // 검색 시작 위치 (기본값: 1, 최대: 1000)
  sort?: 'sim' | 'date' | 'asc' | 'dsc';  // 정렬 옵션 (sim: 정확도순, date: 날짜순, asc: 가격↑, dsc: 가격↓)
  filter?: 'naverpay';        // 네이버페이 상품만 표시
  exclude?: string;           // 제외할 상품 유형 (예: 'used:rental:cbshop')
}

MCP 서버 설정

MCP 서버 실행

npx -y naver-shopping-search-mcp-server

MCP 설정 예시

{
  "naver-shopping-search": {
    "command": "npx",
    "args": [
      "-y",
      "naver-shopping-search-mcp"
    ],
    "env": {
      "NAVER_CLIENT_ID": "your_naver_client_id_here",
      "NAVER_CLIENT_SECRET": "your_naver_client_secret_here"
    }
  }
}

시스템 요구사항

• Node.js >= 18.0.0

라이선스

MIT