BuyKing MCP Server

BuyKing MCP 服务

其他语言版本：English、日本語、한국어

一个 MCP（模型上下文协议）服务，提供「BuyKing，Saleplaza 的购物征服者」这一人设。

吼！我是 BuyKing，Saleplaza 的购物征服者！我会为你找到心仪的超值优惠！

🏆 Glama.ai 官方 MCP 注册表认证 通过认证的 MCP 服务，在许可、质量和维护三个类别中均获得了最高评级（AAA）！

🚀 功能

✨ [v1.2.5] 商品详情（result_detail_GLOBAL）

搜索结果现在会包含商品 ID 行，以便后续调用加载单个商品。所有国家的标题都只使用 title。

何时调用

1. 先调用搜索工具（search_buyking_semantic、search_buyking_semantic_KR、search_buyking_semantic_US 或 search_buyking_semantic_JP）。
2. 每条结果都包含 - 상품 ID: {id}（例如 25023）。
3. 只有当用户想进一步了解某件商品时，才调用 result_detail_GLOBAL，例如查看价格历史、商店购买链接、图片或评分。不要用它进行新的关键词搜索。

如何调用

工具名称：result_detail_GLOBAL。必需参数 id 必须是来自 상품 ID 的数字字符串。

curl -X POST https://buyking.saleplaza.com/message \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "result_detail_GLOBAL",
      "arguments": { "id": "25023" }
    }
  }'

响应规则

• 正文是 result.content[0].text 中的 Markdown。
• 可配送国家/地区是根据 currency 得出的 PRODUCT_SHIPPING_REGIONS 区域代码：KRW → KR、USD → US、JPY → JP。字段标签随货币变化（韩语、英语、日语）。
• 标题始终为 title。不会返回 title_en 和 title_ja。
• 图片始终为 origin_img_url，包括非 Amazon 商品。不会返回 image 列。如果 origin_img_url 为空，图片行会显示对应语言的“无”。
• Saleplaza 页面：KRW → https://saleplaza.com/{id}、USD → https://saleplaza.com/en/{id}、JPY → https://saleplaza.com/ja/{id}。购买链接是 link 列。
• Dealchelin 星级根据 sp_score 计算（85+ 为 3 星，70+ 为 2 星，否则为 1 星）。它不是数据库列。
• 非数字 id 会返回错误说明。未知 ID 和隐藏商品（is_visible 不为 1）会返回相同的“库中没有”说明，不包含标题、价格、链接或图片。

响应字段，按顺序排列

下方标签为韩语（KRW）名称。USD 使用英语名称，JPY 使用日语名称。

字段	KRW 标签	USD 标签	JPY 标签
id	商品 ID	商品 ID	商品ID
title	标题	标题	タイトル
shipping region code	可配送国家/地区	配送至	配送可能国
platform	平台	平台	プラットフォーム
category	类别	类别	カテゴリ
origin_img_url	图片	图片	画像
Saleplaza URL	Saleplaza	Saleplaza	セールプラザ
link	购买链接	购买链接	購入リンク
original_price	原价	原价	元の価格
price	当前优惠价	优惠价	特价
discount	折扣	折扣	割引
target_price	目标价	目标价	目標価格
price_history	价格历史	价格历史	価格履歴
lowest in history	期间内最低价	区间最低价	期間内最安値
highest in history	期间内最高价	区间最高价	期間内最高値
current vs first history row	当前价格与首次记录相比	当前价格与首次记录相比	最初の記録と比べた現在価格
deal_status	优惠状态	优惠状态	ディール状態
deal_checked_at	优惠检查时间	优惠检查时间	ディール確認時刻
sp_score	SP Score	SP Score	SP Score
computed stars	Dealchelin	Dealchelin	ディールシュラン
customer_grade	客户等级	客户等级	顧客グレード
buyking_comment	BuyKing 曰	BuyKing 说	バイキング曰く
recommend_reason	推荐理由	推荐理由	おすすめ理由
click_count	点击数	点击数	クリック数
likes_count	喜欢数	喜欢数	いいね
dislikes_count	不喜欢数	不喜欢数	よくない
opinion_cnt	意见数	意见数	意見数
created_at	登记时间	上架时间	登録日時

price_history 是由 { date: "YYYY-MM-DD", price } 行组成的列表，日期从旧到新排列，最多 10 条。有历史记录时，三条摘要行会紧随列表之后。如果缺失或不是有效 JSON，历史记录行会显示暂无记录，并省略摘要行。

KR（KRW，韩语标签）：

- 상품 ID: 25023
- 제목: ...
- 배송가능국가: KR
- 플랫폼: ali
- 카테고리: ...
- 이미지: https://ae-pic-a1.aliexpress-media.com/...jpg
- 세일프라자: https://saleplaza.com/25023
- 구매 링크: https://...
- 원래 가격: KRW 3,261
- 지금 혜택가: KRW 3,250
- 할인: 1%
- 목표가: KRW 2,500
- 가격 히스토리:
  - 2026-10-04: KRW 35,900
- 기간 내 최저가: KRW 35,900
- 기간 내 최고가: KRW 35,900
- 첫 기록 대비 현재가: KRW 0
- 딜 상태: ...
- 딜 확인 시각: ...
- SP Score: 74
- 딜슐랭: 2성
- 고객 등급: ...
- 바이킹 曰: ...
- 추천 이유: ...
- 클릭 수: 0
- 좋아요: 0
- 싫어요: 0
- 의견 수: 0
- 등록 시각: 2026-10-01T15:00:01.000Z

US（USD，英语标签）：

- Product ID: 25023
- Title: ...
- Ships to: US
- Platform: amazon
- Category: ...
- Image: https://m.media-amazon.com/...jpg
- Saleplaza: https://saleplaza.com/en/25023
- Buy link: https://...
- Original: USD 29.9
- Deal Price: USD 19.9
- Discount: 33%
- Target price: none
- Price history:
  - 2026-09-01: USD 25
  - 2026-09-20: USD 19.9
- Lowest in range: USD 19.9
- Highest in range: USD 25
- Current vs first record: USD -5.1
- Deal status: ...
- Deal checked at: ...
- SP Score: 88
- Dealchelin: 3-star
- Customer grade: ...
- BuyKing says: ...
- Recommend reason: ...
- Clicks: 0
- Likes: 0
- Dislikes: 0
- Opinions: 0
- Listed at: 2026-10-01T15:00:01.000Z

JP（JPY，日语标签）：

- 商品ID: 25023
- タイトル: ...
- 配送可能国: JP
- プラットフォーム: jp-amazon
- カテゴリ: ...
- 画像: https://m.media-amazon.com/...jpg
- セールプラザ: https://saleplaza.com/ja/25023
- 購入リンク: https://...
- 元の価格: JPY 1,980
- 特価: JPY 1,480
- 割引: 25%
- 目標価格: なし
- 価格履歴:
  - 2026-10-04: JPY 1,980
- 期間内最安値: JPY 1,480
- 期間内最高値: JPY 1,980
- 最初の記録と比べた現在価格: JPY -500
- ディール状態: ...
- ディール確認時刻: ...
- SP Score: 74
- ディールシュラン: 2つ星
- 顧客グレード: ...
- バイキング曰く: ...
- おすすめ理由: ...
- クリック数: 0
- いいね: 0
- よくない: 0
- 意見数: 0
- 登録日時: 2026-10-01T15:00:01.000Z

✨ [v1.2.1 新增] 增强型多语言全球搜索

跨越语言障碍，更智能地寻找全球购物优惠！

• 内置海量多语言词典：通过包含 1,000 多个核心购物关键词（英语、日语 ↔ 韩语）的哈希表，准确、即时地匹配全球商品，避免 AI 误译（例如将“mouse”翻译成动物）。
• 根据输入语言智能优先排序：在 0.1 秒内自动检测用户的输入语言（英语、日语、韩语），并优先将使用该国家／地区货币（USD、JPY、KRW）的优惠排在前面。（例如，用英语搜索 apple 会优先显示 🇺🇸US 商品！）

提供的工具 — 6 个

🌍 全球搜索

• search_buyking_semantic：无地域限制地语义搜索全球优惠。每件商品都会标注发货国家／地区代码（🇰🇷KR/🇺🇸US/🇯🇵JP）。

🇰🇷 韩国专属

• search_buyking_semantic_KR：仅搜索可在韩国境内直接配送的优惠。以 KRW(₩) 计价，返回韩语结果。

🇺🇸 美国专属

• search_buyking_semantic_US：仅搜索可配送至美国的优惠。以 USD($) 计价，返回英语结果。

🇯🇵 日本专属

• search_buyking_semantic_JP：仅搜索可配送至日本境内的优惠。以 JPY(¥) 计价，返回日语结果。

🔎 商品详情

• result_detail_GLOBAL：根据搜索结果中的商品 ID 获取一件商品及其价格历史。可配送国家／地区为来自 currency 的地区代码，与 PRODUCT_SHIPPING_REGIONS 相对应（KRW → KR、USD → US、JPY → JP）。参数 id（必填）。

ℹ️ 服务信息

• get_server_info：返回 BuyKing MCP 服务的版本信息和功能列表。

通用参数

所有搜索工具都支持相同的参数：

参数	类型	必填	描述	示例
keyword	string	✅	要搜索的商品关键词	"wireless mouse", "earbuds"
category	string	❌	类别筛选条件	"💻 IT/Electronics/Digital"
platform	string	❌	平台筛选条件	"amazon", "aliexpress"
sort	string	❌	排序条件	"newest", "price_asc", "price_desc"

服务端点

• HTTP JSON-RPC：https://buyking.saleplaza.com/message
• MCP 发现：https://buyking.saleplaza.com/.well-known/mcp.json
• LLMs.txt：https://buyking.saleplaza.com/llms.txt

📦 安装

npm install buyking-mcp

🔧 配置

在 Claude Desktop 中使用

将以下内容添加到 Claude Desktop 配置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "buyking-mcp": {
      "command": "npx",
      "args": ["-y", "buyking-mcp@latest"]
    }
  }
}

💡 提示：使用 @latest 标签可确保始终安装最新版本，避免缓存问题。

🔌 直接调用 API

https://buyking.saleplaza.com/message 会按调用方 IP 计数。

• 每次 POST /message 都会计入每分钟 30 次请求的限制。
• 搜索工具和 result_detail_GLOBAL 还会计入每天 500 次商品查询的限制。每天在韩国标准时间 00:00 重置。
• tools/list 和 get_server_info 仅计入每分钟请求限制。

超出限制后，服务会返回 HTTP 429，且不会查询商品 API。stdio 包 npx buyking-mcp 不经过此 Worker，因此该限制仅适用于 HTTP 端点。

HTTP JSON-RPC 示例

# Global Search
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": "wireless mouse"
      }
    }
  }'

🏗️ 开发

依赖项

• Node.js
• TypeScript
• @modelcontextprotocol/sdk

构建

npm run build

本地测试

npm run dev

部署到 Cloudflare Workers

npm run deploy

📝 许可证

ISC

---

吼！从我的宝藏堆里拿走最棒的战利品吧！