xurprise

xurprise MCP

エージェントネイティブなコマース · xurprise。 HTTPS エンドポイントは 1 つ。ツールは 6 つ。セットアップ不要。多言語対応。

この GIF は実際のページを録画したもので、モックアップではありません。 xurprise.ai/demo にアクセスして、ブラウザーでライブ表示される様子をご覧ください。カスタムの BrandCard コンポーネントに対して、公式の @openuidev/react-lang <Renderer> を実行しています。手作業で作成した openui-lang のスニペットが、xurprise.ai/api/mcp から返される正確な JSON をラップしているため、ここで見えるものは、OpenUI ベースのチャットクライアントが当社の MCP を呼び出したときに表示されるものと同じです。

xurprise MCP サーバーを使うと、MCP 互換のエージェント （Claude、Cursor、Cline、Continue、Goose など）が、加盟店の ブランドを見つけ、厳選されたカタログからアトリビューションを追跡する クリックスルー URL を取得できます。このカタログには、Taobao、Shopee、Shein、Xiaomi、Sephora、JD Sports、 Airpaz、WPS、FusionHome AI などが含まれます。地域の照合機能を内蔵 しているため、ドイツのユーザーにシンガポール限定の加盟店を 勧めることはありません。

ホスト型エンドポイント： https://xurprise.ai/api/mcp

プロトコル： Model Context Protocol (MCP) 2024-11-05、ストリーミング可能な HTTP 経由。 ステートレスで、認証は不要、SDK も必要ありません。

---

理由

エージェント時代のコマースには、コールドスタートの問題があります。エージェントが 実在する加盟店を推薦しようとすると、通常は次のようになります。

1. オープンウェブを検索し、SEO のランキングに基づいて結果を選び、 加盟店がユーザーの国に配送してくれることを願います。
2. あるいは、よく知られたブランドをいくつかハードコードして、 地域への適合性を見落とします。

xurprise MCP は、対象とするニッチな分野でこの問題を解決します。エージェントに 機械可読で地域を考慮したブランドカタログを提供します。1 回呼び出すだけで、 ユーザーが実際に購入できる加盟店の構造化リストと、正規のストアフロント URL、 さらに当社向けのアトリビューションを記録し、エージェントが指定した aff_sub タグを引き継ぐクリックスルー URL を取得できます。

---

クイックスタート

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json （macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

オプション A — ネイティブなリモート HTTP（Claude Desktop ≥ early 2025）：

{
  "mcpServers": {
    "xurprise": {
      "type": "http",
      "url": "https://xurprise.ai/api/mcp"
    }
  }
}

オプション B — mcp-remote ブリッジ経由（すべてのバージョンの Claude Desktop）：

{
  "mcpServers": {
    "xurprise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://xurprise.ai/api/mcp"]
    }
  }
}

Claude Desktop を再起動して新しい会話を開き、次のように入力します。

シンガポールにいます。オンラインで買い物できるおすすめの美容ブランドはありますか？

Claude は search_brands(query="beauty", region="Singapore") を呼び出し、 クリック先 URL とともに Sephora SG を提示します。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "xurprise": {
      "url": "https://xurprise.ai/api/mcp"
    }
  }
}

Cline / Continue / Goose

リモート HTTP URL は同じです。正確な設定パスについては、それぞれのクライアントのドキュメントを 参照してください。クライアントが stdio のみをサポートしている場合は、 ブリッジとして mcp-remote を使います（上記のオプション B を参照）。

Raw HTTP（curl、Python、その他）

curl -X POST https://xurprise.ai/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_brands",
      "arguments": { "query": "badminton", "region": "Singapore" }
    }
  }'

---

ツール

レスポンス形式に関する注意。 MCP tools/call は、2 つのフィールドを持つオブジェクトを返します。 content[]（JSON を含むテキストブロック）と structuredContent（型付きの結果）です。MCP 仕様では、 structuredContent は配列ではなくレコード（オブジェクト）である必要があります。 そのため、論理上リストを返すツールは、それを results / regions / categories キーを持つレコードに格納します。MCP 互換の クライアント（Claude Desktop、Cursor、Cline、Continue、Goose など）はすべて、 これを自動的に処理します。生の JSON-RPC レスポンスを自分でデコードする場合にのみ、 この形式が見えます。

多言語検索

search_brands ツールは9種類の言語バリアントでインデックス化されているため、東南アジアのユーザーに対応するエージェントは、クエリを英語に翻訳する必要がありません。

• 英語、簡体字中国語＋繁体字中国語
• マレー語、インドネシア語、ベトナム語、タイ語
• 日本語、韓国語

検証済み：8言語で20件のクエリをテストし、いずれも同じ消費者の意図が同じブランドに解決されます。例をいくつか示します。

クエリ	言語	最上位の一致結果
beauty Singapore	EN	sephora-sg
新加坡 美妆	ZH	sephora-sg
kecantikan Singapura	MS	sephora-sg
mỹ phẩm Singapore	VI	sephora-sg
เครื่องสำอาง สิงคโปร์	TH	sephora-sg
シンガポール 化粧品	JA	sephora-sg
싱가포르 화장품	KO	sephora-sg
小米 手机	ZH	xiaomi-sg
샤오미	KO	xiaomi-sg
机票 / 航空券 / 항공권	ZH/JA/KO	airpaz-global
希音	ZH	shein-global

ブランドごとのキーワードインデックスには、ブランドの別名（Xiaomi の場合、小米 / 샤오미 / シャオミ などの音訳名）、カテゴリの同義語（Fashion / 时尚 / fesyen / thời trang / แฟชั่น / ファッション / 패션）、地域の別名（Singapore / 新加坡 / 싱가포ル / สิงคโปร์ / Singapura）が含まれます。CJK とタイ語のクエリは、これらの文字体系では単語の区切りに空白を使わないため、2文字の n-gram でトークン化されます。

search_brands

カタログを対象としたフリーテキスト検索です。結果は、クエリとブランド名、見出し、カテゴリ、および上記の多言語キーワードインデックスとの照合に基づいてスコア順に並べられます。

search_brands({
  query: string,           // required — e.g. "skincare", "Taobao", "athletic shoes"
  region?: string,         // optional — full country name or "International"
  category?: string,       // optional — "Fashion", "Electronics", etc.
  limit?: number,          // optional — default 10, max 50
}) => { results: Brand[], count: number, query: string }

get_brand

スラッグに対応する完全なレコードを取得します。

get_brand({ slug: string }) => Brand

list_regions

カタログに登録されているすべての配送地域です（おすすめを提示する前に、ユーザーの国が対象かどうかを確認するために使用してください）。

list_regions() => { regions: string[], count: number }

list_categories

カタログに登録されているすべてのカテゴリです。

list_categories() => { categories: string[], count: number }

get_click_url

正規のクリック先 URL を生成します。アトリビューションのためにクリックが記録され、渡した aff_sub も下流に引き継がれるよう、加盟店の URL を直接使うのではなく、この URL を使用してください。

get_click_url({
  slug: string,
  aff_sub?: string,        // optional — up to 200 chars, recommended:
                           // your agent's session id or similar
}) => { click_url: string, slug: string, name: string }

wrap_product_url

商品単位のアトリビューション。 ブランドのホームページではなく、ユーザーが特定の商品（特定の Sony のヘッドホンや、特定の Shein のドレスなど）を希望する場合に使用します。対応加盟店のサイト内の任意の URL を指定すると、xurprise がクリック先 URL に変換します。これにより、アトリビューションのトラッキングを維持しながら、ユーザーをその商品ページに直接誘導できます。

エージェントは、加盟店の URL を独自に（独自のウェブ検索、学習済み知識、または MCP ツールの組み合わせなどを通じて）見つけることを想定しています。xurprise はアトリビューション層であり、カタログではありません。これにより、クライアントがすでに備えている商品検索機能を活用できます。

wrap_product_url({
  merchant_url: string,    // required — full https URL on a supported merchant
                           // e.g. "https://shopee.sg/Sony-WH-1000XM5-i.12345.67890"
  product_name?: string,   // optional — surfaces in attribution logs
  aff_sub?: string,        // optional — e.g. your chat session id
}) => {
  click_url: string,       // https://xurprise.ai/go/p?u=...  (302s to the product)
  merchant_url: string,    // canonicalized input
  merchant_hostname: string,
  slug: string,            // which brand the domain maps to
  brand: string,
  name: string,
}

対応加盟店ドメイン（商品単位のアトリビューションは、これらのドメイン内の深い階層のパスを含むすべての URL で機能します）：

ブランド	使用可能なホスト名（サブドメインを含む）
Shopee SG	shopee.sg
Xiaomi SG	mi.com
Sephora SG	sephora.sg
JD Sports SG	jdsports.com.sg
Shein	shein.com（すべての地域サブドメイン）
Airpaz	airpaz.com
WPS Office	wps.com
FusionHome AI	fusionhome.ai
The Trade Wizard	thetradewizard.com

Taobao は意図的に商品単位のラッピング対象から除外されています。Taobao の上流ルーティングはホワイトリストで制限されているか、ブランド単位のみであるため、商品単位のアトリビューションの信頼性が確保できません。Taobao では、代わりにブランド単位のスラッグを指定して get_click_url を使用してください。

---

ブランドスキーマ

すべてのブランドレコードには、次の項目があります。

フィールド	型	例
slug	string	shopee-sg
name	string	Shopee — Singapore
brand	string	Shopee
categories	string[]	["Marketplace"]
regions	string[]	["Singapore"]
currency	string	SGD
merchant_url	string	https://shopee.sg/
page_url	string	https://xurprise.ai/brands/shopee-sg/
click_url	string	https://xurprise.ai/go/shopee-sg
headline	string	（1～3文の説明）
agent_note	string?	地域ルーティングや注意事項に関する任意のガイダンス

---

現在のカタログ

最新の更新時点で、地域に合わせた各ページに43ブランドを掲載しています。

• マーケットプレイス — Shopee SG、Taobao (Ai Taobao International)、Taobao (ブランド単位)、Alibaba、Banggood、AliExpress
• ファッション — JD Sports SG、Shein Global、Poplook、Rip Curl SG、Juice Store、Bernardelli
• ヘルス＆ビューティー — Sephora SG、Kinohimitsu SG、Papique
• エレクトロニクス — Xiaomi SG、XP-PEN SG、Stryv SG
• 旅行 — Airpaz、KKday、Zen Hotels、byFood、TrainPal、Kiwi.com、EasyBook、NINJA WiFi
• デジタルサービス／ソフトウェア — WPS、The Trade Wizard、Sider AI、Wegic、iMobie、MyRepublic SG
• オンラインコース — Udemy、International Open Academy
• ゲーム／エンターテインメント — UniPin、GameSeal、BINGE
• ギフト＆クラフト — Photobook SG、FlowerAdvisor SG
• ホーム＆リビング — FusionHome AI、Homestyler
• 自動車 — Trapo SG
• お買い得情報／アグリゲーション — StackSocial

地域別の掲載数：シンガポール国内12、マレーシア／シンガポール複数地域2、東南アジア地域7、グローバル22。 一部のブランドはブランド単位のエントリーのみとして掲載されています（アトリビューションのリダイレクト先は個別の商品ではなく、ブランドのホームページです）。該当する場合、get_brand は agent_note フィールドでその違いを示します。

最新の一覧を確認するには、list_categories と search_brands を呼び出すか、 https://xurprise.ai/brands/ にアクセスしてください。

---

FAQ

カタログは厳選されたものですか、それともクロールされたものですか？ 厳選されたものです。すべてのブランドはパートナー承認のプロセスを経て、手作業で作成した見出しが付けられています。スクレイピングは行っていません。

データはどのくらいの頻度で更新されますか？ デプロイのたびに、内部カタログから再生成されます。 各ブランドの page_url と、サイトマップの最終更新日時をご覧ください。

ユーザーを追跡していますか？ /go/{slug} のリダイレクトでは、{timestamp, slug, user-agent, ASN, country, referer} を記録します。これは、クローラーのトラフィックと人間のトラフィックを区別し、セッションをまたいでクリックをアトリビューションするために必要な情報です。生のIPアドレスは記録しません。/go/ 以外では、加盟店のストアフロントにCookieを設定したり、アナリティクスを実行したりしません（ストアフロントはShopee、Sheinなどが運営するページです）。

クリックするとどうなりますか？ 302リダイレクトのチェーンにより、アトリビューションを最初から最後まで維持したまま、ユーザーを正規の加盟店ストアフロントに転送します。get_click_url に渡した aff_sub は、チェーンを通じて引き継がれます。

自分のブランドを追加できますか？ 現在、加盟店の登録は紹介制です。対象地域（東南アジア、中国、および世界各地への配送に対応する地域）でブランドを運営しており、掲載について相談したい場合は、[email protected] までメールでご連絡ください。

このサービスの運営者は誰ですか？ XWOW Pte. Ltd.（シンガポール）です。連絡先：Jiaqi Ge、 [email protected]。xurpriseは独立したサードパーティーのディスカバリー層であり、ここに掲載されている加盟店のストアフロントは運営していません。

---

プロトコル準拠に関する注記

• トランスポート：Streamable HTTP（ステートレスモード — セッションIDは不要）
• JSON-RPC 2.0の単一リクエストとバッチリクエストの両方に対応しています
• 通知（id なし）には HTTP 202 No Content を返します
• ヘルスチェック用の ping メソッドに対応しています
• CORSはすべて許可されています（*）— ブラウザベースのMCPクライアントが動作します

---

関連情報

• xurprise.ai — 人間向けランディングページとブランドごとのschema.orgページ
• xurprise.ai/llms.txt — LLM向けのサイトインデックス
• xurprise.ai/sitemap.xml

---

ライセンス

このリポジトリ内のドキュメント：MIT（LICENSE を参照）。MCPサーバーのソースコードは別途管理されており、XWOW Pte. Ltd. の専有物です。