MisePort — 日本のEC商品カタログをAIエージェントにつなぐオープンソースMCP

日本の小さなお店を、AIエージェントへ。

日本語 · English · 公開デモ · MCP接続ガイド · 商店向けガイド（Alpha） · 実画面の日本語操作手順 · GitHub Issues

MisePort（ミセポート） は、日本のネットショップの商品情報を、AIエージェントが検索・参照しやすいカタログに整えるオープンソースツールです。

商品データ（CSV / JSON）を検証・正規化し、Model Context Protocol（MCP）、CLI、REST API、Schema.org JSON-LDを通じて利用できます。ショップ自身がデータを管理しながら、AIによる商品発見（Agentic Discovery / GEO）に対応するための仕組みを提供します。

まず試す

Related MCP server: inventory-mcp

設計の考え方

商品名の表記、税込・税抜価格、在庫状態、送料の扱いはショップによってさまざまです。MisePortは、AIエージェントが商品を比較・紹介するための情報を、出典・記録日時・未確認項目とともに整理します。

• 出典と日時を残す： 商品ページのsource_urlとupdated_atを保持し、情報の参照元を辿れるようにします。

• 不明な項目を推測で埋めない： 送料・税区分・在庫数が未確認なら、nullやunknownのまま扱います。

• 日本語の商品を探しやすくする： 全角・半角、カタカナ・ひらがなを正規化して検索できます。

• 読み取り専用（Read-Only by Design）： 商品検索・詳細確認・参考見積もりに特化。購入手続きは元のショップの商品ページで行います。

• ショップ主体のデータ管理： 各ショップが自分の環境で商品情報を管理・公開する、ローカルファーストの設計です。

カタログデータの例

サンプルカタログに含まれる架空の商品の例です。送料が不明な場合はnull、在庫を確認できない場合はunknownとして表します。

[
  {
    "sku": "tea-002",
    "name": "宇治 抹茶 30g",
    "price_jpy": 2200,
    "stock": "unknown",
    "tax_included": null,
    "shipping_jpy": null,
    "source_url": "https://example.com/products/tea-002",
    "updated_at": "2026-10-28T12:00:00+09:00",
    "is_demo": true
  }
]

ショップの商品CSV / JSON ──┐
BASE API・公式CSV（Alpha） ─┤
                           ▼
                 検証・正規化
                出典・日時の保持
                           ▼
                        MisePort
                 ├─ CLI（検索・監査・変換）
                 ├─ MCP（7つの読み取り専用ツール）
                 ├─ REST API / OpenAPI
                 └─ Schema.org JSON-LD
                           ▼
                AIエージェント／アプリ

データ形式の詳細はカタログ仕様をご覧ください。

ローカルで動かす

Python 3.10以上の環境で利用できます。リポジトリをクローンし、ルートディレクトリで実行してください。

git clone https://github.com/Siyuan-chat/miseport.git
cd miseport
python -m venv .venv
# macOS / Linux: source .venv/bin/activate
# Windows PowerShell: .venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

# 商品データの検証・検索・詳細表示
miseport validate examples/products.json
miseport search 抹茶 --catalog examples/products.json
miseport detail tea-002 --catalog examples/products.json
miseport inventory tea-002 --catalog examples/products.json

# CSV取込・参考見積もり・監査・JSON-LD出力
miseport import examples/products.csv --output catalog.json
miseport quote tea-002 --quantity 2 --catalog examples/products.json
miseport audit --catalog examples/products.json
miseport export-jsonld tea-002 --catalog examples/products.json

検索は表記揺れを正規化した部分一致方式です。カタログは最大10 MiB・10,000商品まで扱えます。詳しくはCLI / API仕様を参照してください。

AIエージェント／MCPクライアントに接続する

ローカルのmiseport-mcpはstdio通信に対応しています。MCPクライアントの設定ファイルで、カタログの絶対パスを指定します。

{
  "mcpServers": {
    "miseport": {
      "command": "miseport-mcp",
      "env": {
        "MISEPORT_CATALOG": "/absolute/path/to/examples/products.json"
      }
    }
  }
}

リモート接続には公開デモのStreamable HTTP MCPも利用できます。

Claude DesktopなどのMCP対応クライアントから利用できます。Meta MuseでもCustom Connector経由の接続例があります。詳しくはMuse接続ガイド · Agent評価（20件・実測範囲）とAgent GEOの考え方をご覧ください。

商店向けツール（Experimental / Alpha）

コマンドラインに慣れていないショップオーナー向けに、商品データの取り込みから確認、公開用パッケージの生成までを日本語で操作できるツールを開発しています。

• 日本語ローカルGUI（miseport-gui）： 商品の取り込み、更新差分のレビュー、公開前のチェック

• ECプラットフォーム連携（Alpha）： BASE v2 β APIからの商品読み込み、BASE / Shopifyの商品CSV取込、公開商品URLの確認補助

• 配信パッケージ生成（miseport-publish）： ショップ自身のCloudflare Pagesなどに公開できる、読み取り専用MCP / REST配信用ZIPの出力

現在は実店舗でのパイロット導入に向けて検証を進めています。操作方法や今後の開発については、商店向けAlphaガイド、対応プラットフォーム、ロードマップをご覧ください。

よくある質問（FAQ）

Q. 無料で使えますか？
はい。MisePortはApache-2.0ライセンスのオープンソースです。外部ホスティングサービスの費用は利用環境によって異なります。

Q. BASEやShopifyの商品データを使えますか？
標準のCSV / JSONに加え、Alpha機能としてBASE（API / CSV）とShopify（CSV）の読み込みに対応しています。

Q. AIエージェントから直接注文・決済できますか？
MisePortは商品情報の参照に特化したツールです。購入はショップの商品ページから行います。

ドキュメント・開発参加

公開ステータス · テスト/受入範囲 · 商品データ整合性の確認 · AI商品発見の準備診断 · API仕様 · データ形式 · Muse接続ガイド · Agent GEO · Cloudflareデモ · 製品方針 · セキュリティ · 貢献ガイド · ブランドガイド

バグ報告や機能提案はGitHub Issuesへお寄せください。

記載の会社名・サービス名は各社の商標または登録商標です。MisePortは独立したオープンソースプロジェクトであり、各プラットフォームの公式製品・提携サービスではありません。