mcp-naver-commerce

MCP Server for Naver Commerce API - AI-powered developer assistant for Korean e-commerce

What is this?

네이버 스마트스토어 개발 시 자주 찾는 정보를 Claude Code에서 바로 검색할 수 있는 MCP(Model Context Protocol) Server입니다.

This MCP server helps developers working with Naver Commerce API by providing instant access to:

• GitHub Discussions Q&A - 인증 에러, API 사용법 등 개발 질문과 답변
• Wiki Guide Documents - 그룹상품 연동, 주문 상태 흐름도 등 구현 가이드
• Release Notes - API 변경 공지 및 업데이트 정보

Features

| Tool | Description | |------|-------------| | search_discussions | Q&A 검색 (키워드, 카테고리 필터) | | get_discussion_detail | 특정 Discussion 상세 조회 | | get_wiki_pages | Wiki 문서 목록/내용 조회 | | get_releases | 최신 API 변경 공지 조회 |

Category Filters

| Category | Slug | |----------|------| | 상품관리 | product | | 주문처리 | order-process | | 주문수집 | order-collect | | API호출 | api-call | | FAQ | faq |

Installation

Option 1: npx (Recommended)

Add to your ~/.mcp.json:

{
  "mcpServers": {
    "naver-commerce": {
      "command": "npx",
      "args": ["-y", "@baekho-lim/mcp-naver-commerce"]
    }
  }
}

Option 2: Global Install

npm install -g @baekho-lim/mcp-naver-commerce

Then add to ~/.mcp.json:

{
  "mcpServers": {
    "naver-commerce": {
      "command": "mcp-naver-commerce"
    }
  }
}

Option 3: Build from Source

git clone https://github.com/baekho-lim/mcp-naver-commerce.git
cd mcp-naver-commerce
npm install
npm run build

Then add to ~/.mcp.json:

{
  "mcpServers": {
    "naver-commerce": {
      "command": "node",
      "args": ["/path/to/mcp-naver-commerce/dist/index.js"]
    }
  }
}

Usage

After restarting Claude Code, ask questions in natural language:

"네이버 API 401 인증 에러 해결법 알려줘"
→ search_discussions("401 인증", "api-call")

"주문 상태 변경 흐름도 보여줘"
→ get_wiki_pages("주문-상태-변경-흐름도")

"최근 API 변경사항 알려줘"
→ get_releases(5)

"Discussion #123 상세 내용 보여줘"
→ get_discussion_detail(123)

Tool Details

search_discussions

Q&A 검색

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | Yes | 검색어 (예: "401 인증", "주문 상태") | | category | string | No | 카테고리 필터 | | limit | number | No | 결과 개수 (기본 10, 최대 20) |

get_discussion_detail

특정 Discussion 상세 조회

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | number | number | Yes | Discussion 번호 |

get_wiki_pages

Wiki 문서 조회

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | page | string | No | 페이지 이름 (생략 시 목록 반환) |

get_releases

API 변경 공지 조회

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | limit | number | No | 조회 개수 (기본 5, 최대 20) |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GITHUB_TOKEN | No | GitHub Personal Access Token (Rate Limit 증가용) |

Without a token, you're limited to 60 requests/hour. With a token, the limit increases to 5,000 requests/hour.

Related Links

• Naver Commerce API GitHub - 공식 기술 지원 레포
• Naver Commerce API Docs - 공식 API 문서
• MCP Protocol - Model Context Protocol 소개

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see the LICENSE file for details.

Author

Baekho Lim — AI Engineer & E-commerce Consultant

• Website: baekho.io
• GitHub: @baekho-lim

Building AI-powered tools for Korean e-commerce ecosystem.