buywhere-mcp

buywhere-mcp

BuyWhere 製品カタログ用の MCP サーバーです。Claude Desktop、Cursor、Windsurf などの MCP 互換エージェントで、HTTP コードを記述せずに製品を検索、取得できます。

セットアップ

1. API キーを取得する

buywhere.ai/developers で登録し、API キーをコピーします。

2. クライアントを設定する

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を開き、次を追加します。

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Settings → MCP を開いて新しいサーバーを追加するか、~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "buywhere": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "BUYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. エージェントに製品の検索を依頼する

クライアントを再起動してから、次を試してください。

「BuyWhere でシンガポールの 50 ドル未満のワイヤレスイヤホンを検索して」

「BuyWhere を使って、最も安い iPhone 15 ケースを比較して」

「BuyWhere の製品 ID abc123 のアフィリエイトリンクを取得して」

---

ツール

search_products

キーワードまたは自然言語を使って BuyWhere カタログを検索します。

パラメーター	型	必須	説明
query	string	はい	キーワードまたは自然言語の検索クエリ
country	string	いいえ	国コードのヒント（sg、my、id）
category	string	いいえ	カテゴリースラッグ（例：electronics/smartphones）
limit	integer	いいえ	最大結果数、1～50（デフォルトは 10）

get_product

単一製品の詳細情報を取得します。

パラメーター	型	必須	説明
product_id	string	はい	BuyWhere 製品 ID

get_price

利用可能なすべての販売店で、製品の現在の価格を比較します。送料込みの合計価格順に掲載情報を返し、最安値およびコストパフォーマンスの高い製品をおすすめします。

パラメーター	型	必須	説明
product_id	string	はい	BuyWhere 製品 ID

compare_prices

2～5 個の製品を並べて比較します。構造化された相違点、価格帯、長所と短所、最もコストパフォーマンスの高い製品のおすすめを返します。AI エージェントの意思決定に特化して設計されています。

パラメーター	型	必須	説明
product_ids	string[]	はい	BuyWhere 製品 ID の配列（2～5 個）

get_affiliate_link

製品のクリック追跡機能付き BuyWhere アフィリエイトリンクを取得します。ユーザーにリンクを共有する際は、通常の製品 URL ではなく必ずこちらを使用してください。紹介を記録し、販売店のページにリダイレクトします。

パラメーター	型	必須	説明
product_id	string	はい	BuyWhere 製品 ID

get_catalog

利用可能な製品カテゴリーを一覧表示します。検索や絞り込みの前に、どのカテゴリーがあるかを確認するために使用します。

パラメーター	型	必須	説明
parent_slug	string	いいえ	サブカテゴリーの親スラッグ（トップレベルの場合は省略）

リソース

URI	説明
buywhere://catalog/sg	シンガポールで利用可能なカテゴリー
buywhere://catalog/my	マレーシアで利用可能なカテゴリー
buywhere://catalog/id	インドネシアで利用可能なカテゴリー

環境変数

変数	必須	説明
BUYWHERE_API_KEY	はい	BuyWhere API キー
BUYWHERE_API_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.buywhere.ai）

エージェントとの会話例

User: Find the cheapest mechanical keyboard on BuyWhere and compare the top 2

Claude: I'll search BuyWhere for mechanical keyboards and compare the top results.

[Calls search_products with query="mechanical keyboard", limit=5]

Found 12 products. Top results:
1. Keychron K2 — SGD 89.00 (prod_abc123)
2. Royal Kludge RK61 — SGD 65.00 (prod_def456)

[Calls compare_prices with product_ids=["prod_abc123", "prod_def456"]]

Comparison: Keychron K2 vs Royal Kludge RK61
Price range: SGD 65 – SGD 89
Key differences:
  • Keychron K2: full-size TKL layout, Mac-optimised keycaps
  • RK61: compact 60% layout, budget-friendly
Best value: Royal Kludge RK61 at SGD 65

[Calls get_affiliate_link with product_id="prod_def456"]

Here's your purchase link: https://api.buywhere.ai/r/prod_def456

開発

npm install
npm run build
BUYWHERE_API_KEY=your_key python mcp_server.py