プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

PoloPan Fashion MCP Server

作者:rofoso-comバージョン 1.8.0i★ 1iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.rofoso-com/polopan-fashion-mcp

インストール方法

できること

Fashion & apparel MCP: visual outfit search, stock verification, and 1-click checkout.

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー キー不要
  • カテゴリ ネットショップ・決済

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア24/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

PoloPan Fashion MCP Server をインストールして。https://mcp.popnx.com/i/rofoso-com-polopan-fashion-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp-server.polopan.com)を通ります · ✓ コマンド確認済み 2026年11月20日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前PoloPan Fashion MCP Server
    Remote MCP server URL · アドレスhttps://mcp-server.polopan.com/mcp/

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsPoloPan Fashion MCP Server

  4. 試してみる

    PoloPan Fashion MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が PoloPan Fashion MCP Server を使っていると言うか、回答に PoloPan Fashion MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前PoloPan Fashion MCP Server
    Connection · アドレスhttps://mcp-server.polopan.com/mcp/
  3. チャットで PoloPan Fashion MCP Server を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から PoloPan Fashion MCP Server を選びます

  4. 試してみる

    PoloPan Fashion MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が PoloPan Fashion MCP Server を使っていると言うか、回答に PoloPan Fashion MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user polopan-fashion https://mcp-server.polopan.com/mcp/
  3. Claude Code で /mcp と入力

    PoloPan Fashion MCP Server が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    PoloPan Fashion MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が PoloPan Fashion MCP Server を使っていると言うか、回答に PoloPan Fashion MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    PoloPan Fashion MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が PoloPan Fashion MCP Server を使っていると言うか、回答に PoloPan Fashion MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    PoloPan Fashion MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が PoloPan Fashion MCP Server を使っていると言うか、回答に PoloPan Fashion MCP Server のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp-server.polopan.com/mcp/

JSON 設定は下の「開発者向け」にあります

つまずいたら?PoloPan Fashion MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user polopan-fashion https://mcp-server.polopan.com/mcp/

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "polopan-fashion": {
      "url": "https://mcp-server.polopan.com/mcp/"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "polopan-fashion": {
      "type": "http",
      "url": "https://mcp-server.polopan.com/mcp/"
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user polopan-fashion -- npx -y polopan-products-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "polopan-fashion": {
      "command": "npx",
      "args": [
        "-y",
        "polopan-products-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "polopan-fashion": {
      "command": "npx",
      "args": [
        "-y",
        "polopan-products-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "polopan-fashion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "polopan-products-mcp"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
135/週
接続方法
パソコンでもクラウドでも
最新バージョンi
1.8.0
レジストリ公開日i
2026年11月20日
コードの最終更新i
2026年11月19日
最終確認
2026年11月18日
作者
rofoso-com
パッケージ
npm: polopan-products-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月18日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • region.get_current

    Get the currently active shopping destination country, currency code, symbol, phone code, and catalog scope mode from persistent local configuration (~/.polopan/region.json).

  • region.set_current

    Set the active shopping country/region using any natural country name, city (e.g. 'Dubai', 'London', 'California', 'Paris'), 2-letter ISO code ('US', 'GB', 'IN', 'AE', 'CA'), or currency ('USD', 'AED', 'GBP', 'EUR'). Saves to persistent local JSON (~/.polopan/region.json) so the

  • region.list_supported

    Search the 240+ supported destination countries with localized currency codes, symbols, flags, phone codes, and price groups from live platform settings.

  • address.get_current

    Get the default delivery/shipping address saved for the currently active region from local configuration (~/.polopan/region.json). WHEN TO USE (CRITICAL ANTI-SHORTCIRCUIT RULE): - ALWAYS call this BEFORE generating 1-click checkout links to check if the user already has a saved d

  • address.save

    Save a customer delivery shipping address mapped to the active region in ~/.polopan/region.json. Matches Flutter app (newapp) address schema: firstName, lastName, address1, address2, city, province, zip, country, phone, email, type.

  • address.list_saved

    List all saved customer delivery addresses stored in ~/.polopan/region.json, optionally filtered by country.

  • address.set_default

    Set an existing address as the default shipping address for its country in ~/.polopan/region.json.

  • address.delete

    Delete a saved delivery address by ID from ~/.polopan/region.json.

  • products.search.text

    Search PoloPan catalog products using a text keyword query with optional multi-attribute filters. Returns matching fashion items with available in-stock sizes, product specifications, shipping/return policies, discounted pricing, and verified purchase URLs (https://s.polopan.com/

  • products.search.image_url

    Search PoloPan catalog products using visual image similarity from a publicly accessible image URL with optional multi-attribute filters. Returns visually similar products with available sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically

  • products.search.image_upload

    Upload a local image file (or base64 string) and search PoloPan catalog products using visual image similarity. Returns matching products with available in-stock sizes, pricing, and verified purchase URLs (https://s.polopan.com/p/{handle}). Automatically localized to active count

  • vision.outfit.detect_pieces

    Deconstruct an outfit image or influencer photo into individual fashion pieces (e.g. Upper-body garment, Lower-body garment, Dress, Footwear, Bag, Headwear) with normalized bounding box coordinates and detection confidence scores. PURPOSE & DISAMBIGUATION: - Computer-vision objec

  • looks.curation.by_occasion

    Discover complete curated fashion looks styled for specific occasions (e.g., 'Wedding & Reception', 'Party', 'Casual', 'Cocktail', 'Date Night', 'Club Night', 'Brunch', 'Vacation', 'Formal'). All returned looks are verified 100% in-stock (any look with an out-of-stock item is aut

  • products.items.get_by_handle

    Fetch the raw product document and metadata for a single item by unique product handle identifier. Returns catalog metadata, variant details, available in-stock sizes, price details, and verified purchase link (https://s.polopan.com/p/{handle}). PURPOSE & DISAMBIGUATION: - Retrie

  • products.items.check_stock

    Verify real-time live stock availability, discounted pricing, product specifications table (Fabric, Pattern, Collar, Sleeves, Fit, Care Instructions), shipping/return policies, and available size variants for a specific fashion product handle. PURPOSE & DISAMBIGUATION: - Real-tim

  • products.items.get_size_guide

    Retrieve the complete size guide chart, body measurement matrix (Chest/Bust, Waist, Hip, Length, Shoulders), unit switcher (inches/cm), how-to-measure guidelines, and automatic best-fit size recommendations for a specific product handle. PURPOSE & DISAMBIGUATION: - Dedicated size

  • checkout.links.get_direct_url

    Generate the direct 1-click checkout purchase URL for a specific product handle and size variant index (https://s.polopan.com/p/{handle}/{size_index}). PURPOSE & DISAMBIGUATION: - Produces the final, verified 1-click buy link configured with the user's selected size index, unit q

  • products.search.alternatives

    Find visual substitute products within a designated price bracket for a given fashion item handle using visual image similarity. Automatically localized to active country / 240+ destination regions. PURPOSE & DISAMBIGUATION: - Retrieves catalog items visually similar to an existi

  • looks.curation.recommend

    Get complete recommended outfits. Pass a product 'handle' to find complementary items styled with it, OR pass an 'occasion' (e.g. 'Wedding & Reception', 'Party', 'Cocktail', 'Date Night', 'Formal') and 'gender' to discover full occasion looks. All returned looks are verified 100%

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント rofoso-com で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    720ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    19件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/rofoso-com-polopan-fashion-mcp.svg)](https://mcp.popnx.com/en/servers/rofoso-com-polopan-fashion-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ネットショップ・決済のほかのサーバーとの比較i

  • このカテゴリのほかの2969件のうち89%よりスターが多い
  • このカテゴリのほかの2969件のうち99%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2969件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

PoloPan Fashion MCP Serverは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.8.0)がレジストリに届いたのは今日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者:stripe広く使われている★ 207513 か月前更新

クラウドで動く✓ 提供元 · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

作者:flightclaw成長中★ 872 か月前更新

クラウドで動く✓ 提供元 · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

作者:trade-it-inc初期★ 6235 日前更新

クラウドで動く✓ 提供元 · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

作者:idealo初期★ 286 か月前更新

クラウドで動く✓ 提供元 · mcp.idealo.com
似たものと比べる
これ
PoloPan Fashion MCP Server
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいいいえいいえいいえいいえ
基本チェック5/54/44/45/54/44/4
ライセンスMITMITMITCC0-1.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

PoloPan Fashion MCP Server — The #1 Model Context Protocol for Fashion & AI Styling

PoloPan is the premier Fashion & Apparel Model Context Protocol (MCP) server for autonomous AI agents, stylists, and conversational commerce engines (Cursor, Claude, Instinct, Muse, ChatGPT).

Now available across 240+ destination countries and territories with localized pricing, real-time variant stock, persistent regional settings (~/.polopan/region.json), computer-vision outfit deconstruction, and 1-click checkout permalinks.


⚡ What Makes PoloPan the #1 Fashion MCP?

┌────────────────────────────────────────────────────────────────────────┐

│ POLOPAN FASHION MCP SUITE │ ├──────────────────────────┬─────────────────────────────────────────────┤ │ 1. 240+ Global Regions │ region.get_current, region.set_current │ │ & Localized Currencies│ (Persistent JSON, natural country lookup) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 2. Computer Vision │ vision.outfit.detect_pieces (Bboxes for │ │ Deconstruction │ Tops, Bottoms, Shoes, Bags, Accessories) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 3. Occasion Outfitting │ looks.curation.by_occasion (Curated │ │ (100% In-Stock) │ complete looks with zero out-of-stock items)│ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 4. Multimodal Search │ products.search.image_url & _upload │ │ │ (Reverse image visual similarity) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 5. Stock & Garment Specs │ products.items.check_stock (Live variants,│ │ │ size matrix, fabric, fit, care & SLA) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 6. Size Guide & Fits │ products.items.get_size_guide (Chest, │ │ │ waist, hip matrix, in/cm, best-fit match) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 7. Direct 1-Click Buy │ checkout.links.get_direct_url │ │ │ (https://s.polopan.com/p/{handle}/{size}) │ ├──────────────────────────┼─────────────────────────────────────────────┤ │ 8. Budget Alternatives │ products.search.alternatives │ │ │ (Visual match in distinct price brackets) │ └──────────────────────────┴─────────────────────────────────────────────┘


🛠️ Quick Setup & Installation

Option 1: 1-Click Cursor Installation (Deeplink)

Option 2: Hosted Streamable HTTP (Recommended — No Node.js required)

Add to your ~/.cursor/mcp.json or Claude Desktop configuration:

{

"mcpServers": { "polopan-products": { "type": "http", "url": "https://mcp-server.polopan.com/mcp", "headers": {} } } }


Option 3: Local Stdio via NPX / Smithery
Via Smithery CLI:
npx -y @smithery/cli install polopan-products-mcp --client cursor
Via Standard NPX:
{

"mcpServers": { "polopan-products": { "command": "npx", "args": ["-y", "polopan-products-mcp"] } } }

*Requires Node.js 18+.*


🧰 Available MCP Tools

ToolPurposeKey Arguments
region.get_currentInspect active shopping destination, localized currency, and config path*(none)*
region.set_currentSet active region from natural names ("Dubai", "London", "USA", "France"), currency, or ISO-2. Saved to ~/.polopan/region.json.country, mode (global/local)
region.list_supportedSearch 240+ supported destination countries & price groupsquery, limit
address.get_currentInspect default delivery address saved for active destination country in ~/.polopan/region.jsoncountry (optional)
address.saveSave or update customer shipping address matching Flutter app schema (firstName, address1, city, zip, etc.)firstName, address1, city, zip, country, phone, email
address.list_savedList all saved delivery addresses, optionally filtered by countrycountry (optional)
address.deleteDelete a saved delivery address by IDaddress_id
products.search.textSearch products via natural language with size, price, and gender filtersquery, gender, price_min, size, country, mode
products.search.image_urlReverse visual search for identical or similar apparelimage_url, gender, price_min, country, mode
products.search.image_uploadVisual search from local image file or base64file_path, country, mode
vision.outfit.detect_piecesDeconstruct outfit photos into individual pieces (Tops, Bottoms, Shoes, Bags)image_url, threshold
looks.curation.by_occasionDiscover 100% in-stock complete looks (Wedding, Party, Date Night, Casual, etc.)occasion, gender, age, country, mode, page
products.items.get_by_handleRetrieve complete product metadata and all variant detailshandle
products.items.get_size_guideFull garment dimensions table (chest/waist/hip), unit conversion (in/cm), and fit matcherhandle, unit, desired_size, user_chest, user_waist
products.items.check_stockVerify real-time size stock, fabric/fit specifications, and return/shipping SLAshandle, desired_size, size_index
checkout.links.get_direct_urlGenerate verified 1-click checkout permalinks with confirmed size index, coupon, and prefilled shipping parameters (checkoutshipping_address)handle, size, size_index, coupon, address_id, address
products.search.alternativesFind visually similar alternatives in a target price brackethandle, budget_range (0-1500, etc.), country, mode
looks.curation.recommendGet complementary cross-catalog matching outfitshandle OR occasion, gender, country, mode

🌍 Persistent Multi-Country Shopping Flow

PoloPan delivers to 240+ countries and territories. To deliver a smooth, natural user experience:

  1. Never repeatedly ask the user for their country: The server stores settings in ~/.polopan/region.json.
  2. Natural location input: Users can provide country names, cities, currencies, or aliases (e.g. "Dubai", "London", "USA", "AED", "USD").
  3. Change anytime: Users can say *"Switch my country to Canada"* or *"Show prices in GBP"* at any point.

🏠 Saved Delivery Addresses & 1-Click Prefilled Checkout

Just like the PoloPan mobile app (newapp), user delivery addresses are saved and mapped to destination countries in ~/.polopan/region.json:

  • Schema: firstName, lastName, address1, address2, city, province, zip, country, phone, email, type.
  • Prefilled Buy Now: When generating checkout links, Shopify parameters (checkoutshipping_address, checkoutshipping_address, checkout[email], checkout[phone], discount) are prefilled so the buyer can complete their purchase in 1 tap without typing their address again.
  • Anti-Shortcircuit Protocol: AI assistants are instructed to check address.get_current before providing checkout links. If no address exists, the assistant prompts the buyer for their delivery details first, saves it with address.save, and then emits the prefilled 1-click purchase link.

🧪 Testing & Verification

Run the automated end-to-end integration test suite:

npm test

📄 License

MIT © PoloPan