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