Kurage Vibe-Cart（PHPだけで動くEC・商品ページのURLを変えずに乗り換え・MCP同梱）

PHPだけで動くECサイトです。常駐プロセスもポートも使いません。レンタルサーバーにFTPで置けば動きます。

■ いちばんの特徴は「URLを変えずに乗り換えられる」こと

ECを乗り換えるとき、いちばん失うのが商品ページのURLです。お客様がブックマークしているURL、検索結果に出ているURL、他のサイトから張られているリンク。これが全部切れます。

このシステムは、商品IDを移行元のものをそのまま主キーにします。

/product/11366

この数字を振り直さないので、旧サイトのURLがそのまま生きます。

さらに、移行しない商品のURLも404にしません。「取り扱いを終了しました」を出して、同じメーカー → 同じカテゴリ → 親カテゴリ → 現在の取扱商品、の順に代わりの商品を案内します。せっかく来てくださったお客様を、空白のページで帰さないためです。

■ 実際の移行で作った例

おちゃのこネットで運用していた自社ECを、このシステムへ移しています。商品46,658件のうち、取り扱いを続ける14メーカー5,736件を移行し、残る40,922件のURLは「取り扱い終了」で受けています。

デモ: https://exbridge.jp/exdirect/

■ 受注管理

おちゃのこネットの作りに合わせています。単一のステータスにせず、「受注・入金・発送・その他」をそれぞれ独立してチェックします。

入金だけ済んで発送がまだ、発送したが入金がまだ（掛け売り）といった実務が、そのまま表せます。チェックとメール送信が連動し、まとめて処理もできます。

・受注一覧（期間・処理状況・購入者・管理メモで絞り込み、リピーター表示）

・受注明細（確認・変更・キャンセル、送料の調整、管理メモ、送り状番号）

・代理入力（電話で受けた注文を管理側から登録）

・受注CSVダウンロード（Shift_JIS）

・メールテンプレートの編集（差し込み: 受注番号・お名前・合計・明細・振込先・送り状番号）

■ お支払い

銀行振込が最初から使えます。Stripeは、設定ファイルに鍵を入れたときだけ決済ボタンが出ます。鍵が無いのにボタンだけ置いて「押せない」状態を作らないためです。

■ MCP同梱 — AIに運用させる

Claude Code / Codex / Claude Desktop から使えるMCPサーバーを1ファイルで同梱しています。チャットから商品を登録したり、受注を確認して発送処理をしたりできます。

ツールは8つです。

・商品の検索・取得・登録更新

・メーカー一覧

・受注の一覧・取得・処理状況の変更

・統計（取扱点数・未入金・未発送）

instructionsには「商品IDは /product/<id> というURLそのもの。既存商品のIDを変えてはいけない」と書いてあります。金額・在庫はAIが推測で埋めず、指示された値だけを書きます。

■ 動くのに要るもの

・PHP 8系（レンタルサーバーで可）

・SQLite（PHPの標準機能。別途データベースサーバーは不要）

・書き込み可能なディレクトリ1つ

MySQLもPostgreSQLも要りません。常駐プロセスが立てられない共有レンタルサーバーでも動きます。

■ 同梱するもの

・ソースコード一式（MIT）

・MCPサーバー（1ファイル）

・移行手順書（ドメイン切替の手順と、実際に踏んだ落とし穴の記録）

・おちゃのこネットAPIからの取り込みスクリプト（Python）

・商品画像の取り込みスクリプト（旧サイトから落として自前で持つ）

■ 移行を考えている方へ

商品ページのURL構造が分かれば、他のECからでも同じ方法で移せます。URLの形（/product/123 なのか /items/123 なのか）と、商品データの取り出し方（API・CSV）が分かれば、ルーティングと取り込みを合わせるだけです。

■ ご注意

このシステムは「作って終わり」ではなく、運用しながらAIに手を入れてもらうことを前提にしています。ソースを同梱しているのはそのためです。