{
  "markdown": "# BuyKing MCP Server\n\n세일프라자(Saleplaza)의 쇼핑 지배자, 사자왕 Bㅏ이킹 페르소나를 제공하는 MCP(Model Context Protocol) 서버입니다.\n\n> 크하하! 짐은 세일프라자의 쇼핑 지배자, 사자왕 Bㅏ이킹이다! 네 녀석이 원하는 최고의 핫딜을 찾아주마!\n\n[![Glama.ai BuyKing MCP Server Badge](https://images.saleplaza.com/img-assets/glama-card-badge.png)](https://glama.ai/mcp/servers/accentist/buyking-mcp/score)\n\n> 🏆 **Glama.ai 공식 MCP Registry 인증**\n> License, Quality, Maintenance 3개 전 부문에서 **최고 등급(Triple A)**을 획득한 검증된 MCP 서버입니다!\n## 🚀 기능\n\n### 제공하는 도구 (Tools)\n\n- **`search_buyking_semantic`**: 사용자의 자연어 질문이나 키워드를 기반으로 세일프라자의 상품을 시맨틱 검색하여 핫딜 정보를 반환합니다.\n  - 지원 플랫폼: 알리익스프레스, 쿠팡, 11번가, G마켓 등\n  - 카테고리 필터링: IT/가전/디지털, 패션/뷰티/잡화, 식품/생활/리빙 등\n  - 정렬 옵션: 최신순, 가격순, 인기순\n\n### 서버 엔드포인트\n\n- **HTTP JSON-RPC**: `https://buyking.saleplaza.com/message`\n- **MCP Discovery**: `https://buyking.saleplaza.com/.well-known/mcp.json`\n- **LLMs.txt**: `https://buyking.saleplaza.com/llms.txt`\n\n## 📦 설치\n\n```bash\nnpm install buyking-mcp\n```\n\n## 🔧 설정\n\n### Claude Desktop에서 사용하기\n\nClaude Desktop의 설정 파일에 다음을 추가하세요:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"buyking-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"buyking-mcp@latest\"]\n    }\n  }\n}\n```\n\n> 💡 **팁**: `@latest` 태그를 사용하면 항상 최신 버전이 설치되어 캐시 문제를 방지할 수 있습니다.\n\n## 🎯 사용 예시\n\n### 자연어 검색\n\n```\n\"가성비 무소음 마우스 찾아줘\"\n\"최저가 제로 콜라 알려줘\"\n\"여름 이불 추천해줘\"\n```\n\n### 카테고리 필터링\n\n```\n\"IT/가전 디지털 제품 중에서 가성비 좋은 것 추천해줘\"\n\"패션 뷰티 잡화 할인 상품 보여줘\"\n```\n\n### 플랫폼 특정 검색\n\n```\n\"쿠팡에서 제로 콜라 최저가 찾아줘\"\n\"알리익스프레스 무소음 마우스 추천\"\n```\n\n## 🔌 API 직접 호출\n\n### HTTP JSON-RPC 예시\n\n```bash\ncurl -X POST https://buyking.saleplaza.com/message \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"search_buyking_semantic\",\n      \"arguments\": {\n        \"keyword\": \"무소음 마우스\"\n      }\n    }\n  }'\n```\n\n### 파라미터 상세 설명\n\n**`search_buyking_semantic` 도구 파라미터:**\n\n| 파라미터 | 타입 | 필수 | 설명 | 예시 |\n|---------|------|------|------|------|\n| `keyword` | string | ✅ | 검색할 상품명 키워드 | \"무소음 마우스\", \"제로 콜라\" |\n| `category` | string | ❌ | 카테고리 필터 | \"💻 IT/가전/디지털\", \"👚 패션/뷰티/잡화\" |\n| `platform` | string | ❌ | 플랫폼 필터 | \"coupang\", \"11st\", \"gmarket\", \"aliexpress\" |\n| `sort` | string | ❌ | 정렬 조건 | \"newest\", \"price_asc\", \"price_desc\", \"click_desc\" |\n\n**카테고리 허용값:**\n- `all` - 전체\n- `💻 IT/가전/디지털`\n- `👚 패션/뷰티/잡화`\n- `🍎 식품/생활/리빙`\n- `📚 도서/여행/취미`\n- `🛒 종합몰/기획전`\n- `📦 기타`\n\n**플랫폼 허용값:**\n- `all_rank` - 전체\n- `coupang` - 쿠팡\n- `11st` - 11번가\n- `gmarket` - G마켓\n- `auction` - 옥션\n- `aliexpress` - 알리익스프레스\n\n## 📸 실제 사용 예시\n\n### LMStudio에서의 사용 예시\n\n![LMStudio에서 BuyKing MCP를 활용한 마우스 검색 예시](https://images.saleplaza.com/img-assets/buyking-using-llm.png)\n\n*LMStudio에서 BuyKing MCP를 활용하여 \"마우스\"를 검색한 결과입니다. AI가 자동으로 최적의 핫딜을 찾아 추천해주는 것을 확인할 수 있습니다.*\n\n## 🏗️ 개발\n\n### 의존성\n\n- Node.js\n- TypeScript\n- @modelcontextprotocol/sdk\n\n### 빌드\n\n```bash\nnpm run build\n```\n\n### 로컬 테스트\n\n```bash\nnpm run dev\n```\n\n### Cloudflare Workers 배포\n\n```bash\nnpm run deploy\n```\n\n## 📝 라이선스\n\nISC\n\n## 🤝 기여\n\n이 프로젝트는 Saleplaza 팀에서 관리합니다. 버그 리포트나 기능 요청은 이슈를 통해 제출해 주세요.\n\n## 🌐 관련 링크\n\n- [세일프라자](https://saleplaza.com)\n- [MCP Install Guide](https://saleplaza.com/mcp)\n- [MCP Registry](https://registry.modelcontextprotocol.io)\n- [MCP 공식 문서](https://modelcontextprotocol.io)\n\n## 📋 MCP Registry\n\nBuyKing MCP Server는 공식 MCP Registry에 등록되어 있습니다.\n\n### Registry 정보\n- **서버 이름**: `io.github.accentist/buyking-mcp`\n- **버전**: 1.1.2\n- **레지스트리**: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)\n\n### Registry에서 검색\n```bash\n# API로 서버 정보 조회\ncurl \"https://registry.modelcontextprotocol.io/v0.1/servers/io.github.accentist%2Fbuyking-mcp/versions/latest\"\n\n# 웹에서 검색\nhttps://registry.modelcontextprotocol.io/?q=buyking-mcp\n```\n\n---\n\n> 크하하! 짐의 보물창고에서 최고의 전리품을 찾아가라!\n",
  "bytes": 3795,
  "sha": "17f8e593a82f877c1cd7f3158bd2ba4bd5acc9dddc56f03f7688702ad66d0bba",
  "repo_slug": "accentist/buyking-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_accentist_buyking_mcp_912a9589/readme"
}