BuyKing MCP Server

BuyKing MCP サーバー

他の言語で読む：English、日本語、한국어

「セールプラザの買い物の覇者、BuyKing」のペルソナを提供するMCP（Model Context Protocol）サーバーです。

ガオー！私はセールプラザの買い物の覇者、BuyKingです！あなたが望む最高のお買い得品を見つけてみせます！

🏆 Glama.ai 公式 MCP レジストリ認定 License、Quality、Maintenanceの3つのカテゴリーすべてで**最高評価（AAA）**を獲得した、認定済みのMCPサーバーです！

🚀 機能

✨ [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	Product ID	商品ID
title	제목	Title	タイトル
shipping region code	배송가능국가	Ships to	配送可能国
platform	플랫폼	Platform	プラットフォーム
category	카테고리	Category	カテゴリ
origin_img_url	이미지	Image	画像
Saleplaza URL	세일프라자	Saleplaza	セールプラザ
link	구매 링크	Buy link	購入リンク
original_price	원래 가격	Original	元の価格
price	지금 혜택가	Deal Price	特価
discount	할인	Discount	割引
target_price	목표가	Target price	目標価格
price_history	가격 히스토리	Price history	価格履歴
lowest in history	기간 내 최저가	Lowest in range	期間内最安値
highest in history	기간 내 최고가	Highest in range	期間内最高値
current vs first history row	첫 기록 대비 현재가	Current vs first record	最初の記録と比べた現在価格
deal_status	딜 상태	Deal status	ディール状態
deal_checked_at	딜 확인 시각	Deal checked at	ディール確認時刻
sp_score	SP Score	SP Score	SP Score
computed stars	딜슐랭	Dealchelin	ディールシュラン
customer_grade	고객 등급	Customer grade	顧客グレード
buyking_comment	바이킹 曰	BuyKing says	バイキング曰く
recommend_reason	추천 이유	Recommend reason	おすすめ理由
click_count	클릭 수	Clicks	クリック数
likes_count	좋아요	Likes	いいね
dislikes_count	싫어요	Dislikes	よくない
opinion_cnt	의견 수	Opinions	意見数
created_at	등록 시각	Listed at	登録日時

price_history は { date: "YYYY-MM-DD", price } の行のリストで、日付は古い順に並び、最大10件です。履歴がある場合、3つの概要行はリストの後に続きます。履歴がない場合、または有効な 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 New] 強化された多言語グローバル検索

言語の壁を越えて、世界中のお得な商品をよりスマートに見つけましょう！

• 大規模な多言語辞書を内蔵: 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 Discovery: 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 は、1 分あたり 30 リクエストの制限にカウントされます。
• 検索ツールと result_detail_GLOBAL は、1 日あたり 500 件の商品検索の制限にもカウントされます。日付は韓国標準時の 00:00 に切り替わります。
• tools/list と get_server_info は、1 分あたりの制限にのみカウントされます。

制限を超えると、サーバーは 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

---

ガオー！宝物庫から最高のお宝を手に入れよう！