market について
Vistoya MCPは、複数のインデックス済みストアからファッション商品やブランドを意味検索するサーバーです。MCP対応エージェントに、順位付き検索、類似アイテム検索、商品詳細、利用可能なフィルターを提供します。
主な機能
- 01ストア横断の商品意味検索
- 02商品属性による絞り込み
- 03類似商品の検索
- 04ブランドの検索と比較
- 05商品詳細とフィルターの取得
活用シーン
- 01スタイル、色、価格で服を探す
- 02テイストや産地からブランドを探す
- 03特定商品に似た商品を見つける
- 04選択した商品の詳細を取得する
MCP 対応
Streamable HTTPのMCPエンドポイントを通じて、ファッション商品とブランドの検索ツールを提供します。MCPクライアントは商品検索や絞り込み、類似商品・ブランドの検索、商品詳細の取得を行えます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.vistoya.com/mcpclaude mcp add --transport http vistoya-market https://api.vistoya.com/mcp{"mcpServers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}Cursor で開く{"servers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}VS Code で開く{"mcpServers":{"vistoya-market":{"type":"http","url":"https://api.vistoya.com/mcp"}}}{"mcpServers":{"vistoya-market":{"serverUrl":"https://api.vistoya.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
6| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号。レスポンスに次のページがあることが示されたら増やしてください。まず Vistoya の結果が返され、自社の結果を使い切った後のページでは、任意の外部カタログが続く場合があります。プロバイダーに障害が発生しても、通常の商品検索は失敗しません。 |
| brand | string | いいえ | ブランド名で絞り込む |
| limit | integer | いいえ | ページあたりの件数(1~20、デフォルトは 12) |
| query | string | いいえ | 自然言語による検索クエリ。詳しく記述すると、より良い結果が得られます。通貨記号付きの価格(例:「white coat under 200 zł」)も含められ、自動的に解析されます。省略可能です。省略した場合は、以下の構造化フィールドで結果を絞り込み、新着順に並べます。query、構造化フィルター、またはその両方を指定してください。 |
| colors | array | いいえ | 小文字の色名で絞り込みます。例:["black", "navy", "sage green"] |
| gender | enum | いいえ | 性別フィルター。women | men | unisex | boys | girls |
| season | enum | いいえ | シーズンフィルター。補助的な属性です。ユーザーがシーズンを明示した場合にのみ設定してください。`query` フィールドでシーズンは意味的に捉えられるため、指定しすぎると検索結果がゼロになることが最も多くあります。spring | summer | fall | winter | all-season |
| styles | array | いいえ | スタイルフィルター(OR 条件。商品の `styles` の値がこのリストに 1 つでも含まれていれば一致します)。1 つのスタイルで絞り込むには単一の値("styles": ["minimalist"])を渡します。関連するスタイルの組み合わせで絞り込むには複数の値("Casual" カテゴリの場合は "styles": ["basics", "minimalist", "preppy", "sportswear"])を渡します。補助的な属性です。ユーザーが 1 つ以上のスタイルを明示した場合にのみ設定してください。`query` フィールドでスタイルは意味的に捉えられるため、指定しすぎると検索結果がゼロになることが最も多くあります。 |
| country | string | いいえ | 買い物客の所在地(任意)。ISO-3166-1 alpha-2 の国コードを指定します(例:「US」、「GB」、「DE」)。分析用に記録され、今後のオファーの地域マッチング向上に使用されます。不明な場合は省略してください。省略すると現在の動作が維持されます。 |
| pattern | enum | いいえ | 柄フィルター(例:solid、stripe、checked、floral)。補助的な属性です。ユーザーが柄を明示した場合にのみ設定してください。未指定時のデフォルト("solid")がクエリに漏れて候補がゼロになるため、不確かな場合は省略してください。solid | stripe | checked | floral | polka dot | camouflage | logo |
| sleeves | enum | いいえ | 袖のスタイルフィルター。補助的な属性です。ユーザーが袖のスタイルを明示した場合にのみ設定してください。カテゴリやクエリから推測しないでください。sleeveless | short-sleeve | long-sleeve | three-quarter | cap-sleeve | puff | balloon | bishop | bell | dolman |
| category | string | いいえ | カテゴリースラッグ。例:"clothing"、"clothing/jackets"、"clothing/jackets/bomber-jackets"。末尾のセグメントで一意に特定できる場合は、ショートカットも使用できます。たとえば、"loafers-and-slip-ons" は "shoes/loafers-and-slip-ons" と同じものとして、"bomber-jackets" は "clothing/jackets/bomber-jackets" と同じものとして解決されます。 |
| currency | string | いいえ | min_price/max_price に使用する ISO 4217 通貨コード(例:「PLN」、「EUR」、「GBP」)。フィルタリングでは価格が USD に変換されます。USD の場合は省略してください。 |
| neckline | enum | いいえ | ネックラインのフィルター。補助的な説明項目です。ユーザーがネックラインを明示した場合にのみ設定してください。カテゴリーやクエリから推測しないでください。v-neck | crewneck | scoop | square | halter | off-shoulder | one-shoulder | sweetheart | turtleneck | mock-neck | boat-neck | cowl | asymmetric | plunge | high-neck | collared | strapless |
| occasion | enum | いいえ | 用途のフィルター。補助的な説明項目です。ユーザーが用途を明示した場合にのみ設定してください。`query` フィールドでは用途がすでに意味的に捉えられているため、指定しすぎると検索結果がゼロになることがよくあります。casual | formal | business | party | outdoor | beach |
| materials | array | いいえ | 小文字の素材名で絞り込みます。例:["cotton", "silk", "leather"] |
| max_price | number | いいえ | 最高価格("currency" パラメーターで指定した通貨。省略時は USD) |
| min_price | number | いいえ | 最低価格("currency" パラメーターで指定した通貨。省略時は USD) |
| silhouette | enum | いいえ | シルエット/フィットのフィルター(例:fitted、slim、regular、relaxed、oversized)。補助的な説明項目です。ユーザーがフィットを明示した場合にのみ設定してください。`query` フィールドではシルエットがすでに意味的に捉えられているため、指定しすぎると検索結果がゼロになることがよくあります。fitted | slim | regular | relaxed | oversized | tailored | boxy |
| color_match | enum | いいえ | 色の一致モード。"any"(デフォルト):商品に検索した色が少なくとも1色含まれます。"exact":商品の画像のうち少なくとも1枚で、色が検索した色のみです。"all black" のような単色検索に使用します。any | exact |
| store_domain | string | いいえ | ストアドメインで絞り込みます(例:"thereformation.com")。プロトコル、www、地域サブドメイン、パスを含む形式も受け付け、登録済みストアに一致するよう正規化されます。 |
| exclude_colors | array | いいえ | 次の色を含む商品を除外します。例:["white", "beige"] |
| is_sustainable | boolean | いいえ | ユーザーがサステナビリティに関する表示のある商品を明示的に希望した場合は true にします。 |
| available_sizes | array | いいえ | 選択可能なサイズラベルで絞り込みます。例:["s", "m", "38"]。 |
| exclude_materials | array | いいえ | 次の素材を含む商品を除外します。例:["polyester", "nylon"] |
詳細
Vistoya MCP
ファッションストアを横断したセマンティック検索とレコメンデーションを、Model Context Protocol サーバーとして提供します。MCP に対応した AI エージェント(Claude、Cursor、VS Code、ChatGPT など)を接続すると、Vistoya マーケットプレイスの商品を見つけたり、見た目が似ているアイテムを探したり、ストアを閲覧したりできます。
- レジストリ名:
io.github.vistoya/market - エンドポイント:
https://api.vistoya.com/mcp - トランスポート: Streamable HTTP
- ウェブサイト: https://vistoya.com
クイックセットアップ
npx @vistoya/mcp
Claude Desktop、Claude Code、Cursor、Windsurf、VS Code を自動的に検出して設定します。実行後、AI クライアントを再起動してください。
機能
Vistoya は、多数のストアからファッション商品をインデックス化し、視覚言語モデルを使って埋め込みます。MCP サーバーを使うと、エージェントは自然言語でそのインデックスを検索し、結果を推論できます。
ツール
| ツール | 説明 |
|---|---|
discover_products | インデックス化されたすべてのストアを対象にしたセマンティック検索です。自然言語のクエリと、任意のフィルター(カテゴリー、色、性別、価格など)を受け取り、順位付けされた商品を返します。 |
find_similar_products | 商品 ID を指定すると、見た目と意味が似ている商品を返します。 |
discover_brands | ブランドプロフィールを対象にしたセマンティック検索です。スタイル、産地、または美的特徴(例:「イタリアのストリートウェアブランド」、「ミニマルなスカンジナビアブランド」)からブランドを探せます。 |
find_similar_brands | ブランド名またはキーを指定すると、ブランドプロフィールベクトルを使って類似ブランドを返します。 |
get_product | 商品 ID を指定して、1 件の商品詳細を取得します。 |
get_filters | エージェントが利用可能なフィルターを把握できるよう、使用可能なフィルター値(カテゴリー、色、素材、ブランドなど)を一覧表示します。 |
手動インストール
Claude Desktop / Claude Code
claude_desktop_config.json(または Claude Code の MCP 設定)に追加します。
{
"mcpServers": {
"vistoya": {
"url": "https://api.vistoya.com/mcp"
}
}
}
Cursor
~/.cursor/mcp.json に追加します。
{
"mcpServers": {
"vistoya": {
"url": "https://api.vistoya.com/mcp"
}
}
}
VS Code(MCP 拡張機能)
mcp.json に追加します。
{
"servers": {
"vistoya": {
"type": "http",
"url": "https://api.vistoya.com/mcp"
}
}
}
汎用 stdio フォールバック(リモートにまだ対応していないクライアント向け)
ブリッジとして mcp-remote を使います。
{
"mcpServers": {
"vistoya": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.vistoya.com/mcp"]
}
}
}
プロンプトの例
接続したら、次のように試してみてください。
- 「300 ドル以下の黒いレザージャケットを探して」
- 「この商品に似たものを見せて」
- 「秋向けの暖かいセーターはある?」
- 「100 ドル以下のランニングショーツを探して」
探し方
このサーバーは公式 MCP Registry に公開されています。以下から見つけることができます。
https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.vistoya/market
ステータス
パブリックプレビューです。エンドポイントには誰でもアクセスでき、現在は認証を必要としません。
ライセンス
MIT — LICENSE を参照してください。
お問い合わせ
不具合や機能リクエストについては、このリポジトリで Issue を作成してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。