{"_id":"@baekho-lim/mcp-naver-commerce","name":"@baekho-lim/mcp-naver-commerce","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@baekho-lim/mcp-naver-commerce","version":"1.0.0","description":"MCP Server for Naver Commerce API - Search Discussions, Wiki, Releases from GitHub","type":"module","main":"dist/index.js","bin":{"mcp-naver-commerce":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","naver","commerce-api","smartstore","claude","ai","ecommerce"],"author":{"name":"Baekho Lim","email":"bh@baekho.io","url":"https://baekho.io"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/baekho-lim/mcp-naver-commerce.git"},"bugs":{"url":"https://github.com/baekho-lim/mcp-naver-commerce/issues"},"homepage":"https://github.com/baekho-lim/mcp-naver-commerce#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@octokit/graphql":"^8.0.0","@octokit/rest":"^21.0.0","zod":"^4.3.6"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"_id":"@baekho-lim/mcp-naver-commerce@1.0.0","gitHead":"5452db05493c8ecfbe7afbcd74dfe41b0dee03ef","types":"./dist/index.d.ts","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-k2ns8v3BvrbA1/noDKZwZk1jT332JqQKDcu+YVVykYUgFDfjREYwTVFkhfZyThhBKYyPcrjEQ99hr5AyKIlFsw==","shasum":"5b1c407be201e8a2b69c5e2dcbaa0ecfc3427b57","tarball":"https://registry.npmjs.org/@baekho-lim/mcp-naver-commerce/-/mcp-naver-commerce-1.0.0.tgz","fileCount":13,"unpackedSize":30968,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFbZQKfzuDikOtmpsNwlsMtlTcLA7tBDkCru8NErUtnpAiEAsP7plJELiOPVD0wAeRm4njJXyvrtEdKwpo4uBjk6L+g="}]},"_npmUser":{"name":"baekholim","email":"bh@baekho.io"},"directories":{},"maintainers":[{"name":"baekholim","email":"bh@baekho.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-naver-commerce_1.0.0_1769522779915_0.7424193463392321"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-27T14:06:19.787Z","1.0.0":"2026-01-27T14:06:20.073Z","modified":"2026-01-27T14:06:20.378Z"},"maintainers":[{"name":"baekholim","email":"bh@baekho.io"}],"description":"MCP Server for Naver Commerce API - Search Discussions, Wiki, Releases from GitHub","homepage":"https://github.com/baekho-lim/mcp-naver-commerce#readme","keywords":["mcp","model-context-protocol","naver","commerce-api","smartstore","claude","ai","ecommerce"],"repository":{"type":"git","url":"git+https://github.com/baekho-lim/mcp-naver-commerce.git"},"author":{"name":"Baekho Lim","email":"bh@baekho.io","url":"https://baekho.io"},"bugs":{"url":"https://github.com/baekho-lim/mcp-naver-commerce/issues"},"license":"MIT","readme":"# mcp-naver-commerce\n\n> MCP Server for Naver Commerce API - AI-powered developer assistant for Korean e-commerce\n\n[![npm version](https://img.shields.io/npm/v/@baekho-lim/mcp-naver-commerce.svg)](https://www.npmjs.com/package/@baekho-lim/mcp-naver-commerce)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n\n## What is this?\n\n네이버 스마트스토어 개발 시 자주 찾는 정보를 [Claude Code](https://claude.ai/claude-code)에서 바로 검색할 수 있는 MCP(Model Context Protocol) Server입니다.\n\nThis MCP server helps developers working with Naver Commerce API by providing instant access to:\n\n- **GitHub Discussions Q&A** - 인증 에러, API 사용법 등 개발 질문과 답변\n- **Wiki Guide Documents** - 그룹상품 연동, 주문 상태 흐름도 등 구현 가이드\n- **Release Notes** - API 변경 공지 및 업데이트 정보\n\n## Features\n\n| Tool | Description |\n|------|-------------|\n| `search_discussions` | Q&A 검색 (키워드, 카테고리 필터) |\n| `get_discussion_detail` | 특정 Discussion 상세 조회 |\n| `get_wiki_pages` | Wiki 문서 목록/내용 조회 |\n| `get_releases` | 최신 API 변경 공지 조회 |\n\n### Category Filters\n\n| Category | Slug |\n|----------|------|\n| 상품관리 | `product` |\n| 주문처리 | `order-process` |\n| 주문수집 | `order-collect` |\n| API호출 | `api-call` |\n| FAQ | `faq` |\n\n## Installation\n\n### Option 1: npx (Recommended)\n\nAdd to your `~/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"naver-commerce\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@baekho-lim/mcp-naver-commerce\"]\n    }\n  }\n}\n```\n\n### Option 2: Global Install\n\n```bash\nnpm install -g @baekho-lim/mcp-naver-commerce\n```\n\nThen add to `~/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"naver-commerce\": {\n      \"command\": \"mcp-naver-commerce\"\n    }\n  }\n}\n```\n\n### Option 3: Build from Source\n\n```bash\ngit clone https://github.com/baekho-lim/mcp-naver-commerce.git\ncd mcp-naver-commerce\nnpm install\nnpm run build\n```\n\nThen add to `~/.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"naver-commerce\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-naver-commerce/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Usage\n\nAfter restarting Claude Code, ask questions in natural language:\n\n```\n\"네이버 API 401 인증 에러 해결법 알려줘\"\n→ search_discussions(\"401 인증\", \"api-call\")\n\n\"주문 상태 변경 흐름도 보여줘\"\n→ get_wiki_pages(\"주문-상태-변경-흐름도\")\n\n\"최근 API 변경사항 알려줘\"\n→ get_releases(5)\n\n\"Discussion #123 상세 내용 보여줘\"\n→ get_discussion_detail(123)\n```\n\n## Tool Details\n\n### search_discussions\n\nQ&A 검색\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `query` | string | Yes | 검색어 (예: \"401 인증\", \"주문 상태\") |\n| `category` | string | No | 카테고리 필터 |\n| `limit` | number | No | 결과 개수 (기본 10, 최대 20) |\n\n### get_discussion_detail\n\n특정 Discussion 상세 조회\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `number` | number | Yes | Discussion 번호 |\n\n### get_wiki_pages\n\nWiki 문서 조회\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `page` | string | No | 페이지 이름 (생략 시 목록 반환) |\n\n### get_releases\n\nAPI 변경 공지 조회\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `limit` | number | No | 조회 개수 (기본 5, 최대 20) |\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `GITHUB_TOKEN` | No | GitHub Personal Access Token (Rate Limit 증가용) |\n\nWithout a token, you're limited to 60 requests/hour. With a token, the limit increases to 5,000 requests/hour.\n\n## Related Links\n\n- [Naver Commerce API GitHub](https://github.com/commerce-api-naver/commerce-api) - 공식 기술 지원 레포\n- [Naver Commerce API Docs](https://apicenter.commerce.naver.com/docs) - 공식 API 문서\n- [MCP Protocol](https://modelcontextprotocol.io) - Model Context Protocol 소개\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nMIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Author\n\n**Baekho Lim** — AI Engineer & E-commerce Consultant\n\n- Website: [baekho.io](https://baekho.io)\n- GitHub: [@baekho-lim](https://github.com/baekho-lim)\n\nBuilding AI-powered tools for Korean e-commerce ecosystem.\n","readmeFilename":"README.md","_rev":"1-a003e57d1a383611e0b3665447fba062"}