Sellbase

Sellbase を選ぶ理由

• すべてを自分で管理できます。 データはお使いの Postgres に保存され、売上金はお使いの Stripe アカウントに振り込まれ、コードはリポジトリに残ります。プラットフォーム手数料も、ロックインも、間に入る Sellbase のサーバーもありません。MIT ライセンスです。
• AI を第一に考えた設計です。 sellbase init は CLAUDE.md／AGENTS.md、スキル、MCP サーバーを作成します。エージェントに「ストアをセットアップして」と伝えるだけで、商品を作成し、決済を接続して、テスト購入を実行します。金銭に関わる操作や破壊的な操作には、必ず事前にオーナーの確認を求め、すべての操作を記録します。
• あらゆるサイトで動作します。
  • Next.js と Vite + React： React コンポーネント。
  • プレーンな HTML、WordPress、Webflow、Vue、Svelte、Astro、Angular： <sellbase-*> ウェブコンポーネント（gzip 圧縮時 13 KB）と静的な管理画面。
• 使うのが楽しい管理画面です。 写真やバリエーションをドラッグ＆ドロップで管理できる商品管理、在庫管理、納品書や返金に対応した注文管理、カート放棄への対策、顧客管理、割引、あらゆる接続の設定を利用できます。さらに：
  • 検索や操作を行えるコマンドパレット（⌘K）；
  • ホーム画面の AI コパイロット；
  • 開発者ではなく、ストアオーナー向けの設計。
• デフォルトで安全です。
  • 金額は整数として保存します。
  • すべてのテーブルに RLS を適用し、テストも用意しています。
  • 注文は、検証済みの決済ウェブフックからのみ作成されます。
  • 書き込みは冪等です。
  • サードパーティのシークレットは Supabase Vault に保存します。
  • 送信ウェブフックには署名を付与し、プライベートネットワークには到達しません。

Sellbaseを使うか、自分で構築するか？

Next.js + Supabase アプリにストアを追加する一般的な方法は、手作業で構築することです。products テーブル、カート、Stripe Checkout 用の Server Action、Webhook ルートを用意します。最初の販売には対応できます。Sellbase は同じスタック（お使いの Supabase と Stripe）を使い、残りはすでに構築・テスト済みです。

	手作業（Supabase + Stripe）	Sellbase
セットアップ	正しく保つために 5～6 個のファイルを書く必要があります	npx sellbase init
既存のアプリと Supabase で動作	はい	はい：独自の sellbase スキーマを使用し、追加のサーバーは不要です
オーナー向けの管理画面	Supabase ダッシュボード、または自分で構築	/admin：商品、写真、バリエーション、注文、返金、割引
在庫、バリエーション、配送料、税金、割引	それぞれ構築	含まれています
検証済み Webhook のみが注文を作成し、冪等性を確保	自分で対応	組み込み済みで、テストも用意されています
メール、カート放棄への対応、返金	それぞれ構築	含まれています
AI エージェントがストアを操作できる（商品作成、注文確認など）	いいえ	31 個のツールを備えた MCP サーバー。決済や破壊的な操作にはオーナーの確認が必要です

Medusa、Vendure、Saleor などのエンジンとは異なり、Sellbase には別のバックエンドサーバーが不要です。アプリの隣で Supabase Edge Functions 上で動作し、ストアフロントのコンポーネントは編集できるようにリポジトリへコピーされます。

クイックスタート

必要なもの：Node 20 以降と Supabase プロジェクト（または Docker を使ったローカルスタック）。

npx supabase start          # local stack (or pass --supabase-url … for a hosted project)
npx sellbase init --yes     # schema, Edge Functions, store, owner, admin, components, agent files

次に、以下を行います。

• 管理画面： /admin を開いてサインインします。ローカル環境では、オーナーのメールアドレスとパスワードは .env.sellbase に記載されています。
• セットアップ： Home のセットアップガイドに従います。
• または、エージェントに任せます： プロジェクトでエージェントを開き、「Configura mi tienda con Sellbase」 / 「Set up my store with Sellbase」 と伝えます。テスト購入が成功するまで、sellbase MCP ツールを使用します。

npx sellbase doctor         # checklist with the next step for anything missing
npx sellbase upgrade        # new versions: dry run, backup, migrations, functions, components

テンプレートから始める

npx sellbase create my-store --template nextjs   # Next.js store with the admin at /admin
npx sellbase create my-landing --template html   # plain HTML landing page, no build step

どちらも examples/ にあり、Vercel と Netlify のデプロイボタンが用意されています。

Claude Code を使う場合

/plugin marketplace add jlgavel011/sellbase
/plugin install sellbase@sellbase
/sellbase:setup I sell handmade candles, $250 MXN each, shipping $120

プラグインを使うと、すべてのプロジェクトで Sellbase のスキルと MCP サーバーを利用できます。/sellbase:setup は Sellbase をインストールし、商品を作成して、テストモードで Stripe に接続し、テスト購入を実行します。ほかの MCP クライアントからは npx sellbase mcp を使用できます（MCP レジストリでは io.github.jlgavel011/sellbase として登録されています）。

任意のエージェントを使う場合（Cursor、Codex、Copilot、Gemini CLI、Windsurf など）

npx skills add jlgavel011/sellbase    # the Sellbase skills, including add-ecommerce

次に、エージェントに「このプロジェクトにストアを追加して」と依頼します。add-ecommerce スキルが Sellbase をインストールしてセットアップします。

shadcn を使う場合

ストアフロントのコンポーネントは、shadcn 対応のレジストリとしても利用できます。

npx shadcn add https://jlgavel011.github.io/sellbase/r/store.json          # everything
npx shadcn add https://jlgavel011.github.io/sellbase/r/product-grid.json   # or one component

バックエンドも必要です：npx sellbase init --yes。インデックスは /r/registry.json にあります。

本番環境への移行：デプロイガイド と Stripe での本番決済。

特徴

カタログ：

• 物理商品、デジタルダウンロード、予約制サービスに対応しています。
• 商品ごとに最大3つのオプション（サイズ、色など）を設定でき、バリアントマトリックス、比較価格、SEO に対応しています。
• コレクション、タグ、バリアントごとの在庫に対応しています。
• CSV インポート（Shopify のエクスポートを含む）とエクスポートに対応しています。
• プレビュー付きの一括価格変更に対応しています。

チェックアウト：

• Stripe Checkout（カード、Apple Pay、Google Pay。テストモードとライブモード）に対応しています。
• 配送料、送料無料の適用条件、店頭受け取りに対応しています。
• 税込みまたは税抜きの価格に対応しています。
• 割引コードと自動割引に対応しています。
• サービスの予約金に対応しています。
• 必須の同意チェックボックス（例：アルコールの購入に必要な18歳以上の確認）をサーバー側で強制し、注文とともに保存します。

注文：

• 決済状況とフルフィルメント状況を管理できます。
• 配送業者と追跡情報を指定して発送できます。
• 全額または一部の返金に対応しています。
• 再入庫を伴うキャンセルに対応しています。
• コメント付きのタイムラインを利用できます。
• 印刷可能な梱包明細書を利用できます。
• 手動注文（現金、振込、WhatsApp）と決済リンクに対応しています。

成長：

• ワンクリックまたは自動送信によるカート復元メールで、放棄されたチェックアウトを回復できます。
• 購入履歴を持つ顧客を管理できます。
• 売上指標とベストセラーを確認できます。

サービス：

• 週ごとの営業時間と例外を設定したリソースを管理できます。
• 空き状況を確認できます。
• リマインダー（24時間前と2時間前）とカレンダーへの招待を含む予約に対応しています。

メール（Resend）： ダウンロードリンク付きの注文確認、配送状況の更新、返金、キャンセル、予約のお知らせ、カートの復元メールに対応しています。すべてのメールにロゴとブランドカラーが反映されます。

チームと AI：

• スタッフの役割と招待を管理できます。
• エージェント用のスコープ付き API トークンに対応しています（金銭関連およびデータエクスポートのスコープはオプトインです）。
• アクティビティログを利用できます。
• ERP、スプレッドシート、Zapier 向けの、再試行機能付き署名済みアウトバウンド Webhook に対応しています。

ストアフロント：

• リポジトリにコピーして自由に編集できる React コンポーネントを提供します。
• ヘッドレスフックを提供します。
• あらゆるサイトで使える Web コンポーネントを提供します。
• SEO ヘルパー（JSON-LD、サイトマップ）を提供します。
• 注文照会ページとダウンロードページを提供します。
• アクセシビリティに配慮したマークアップを提供します（axe でチェック済み）。

仕組み

your site ──(@sellbase/react or <sellbase-*> web components)──┐
/admin (@sellbase/admin) ─────────────────────────────────────┤
your AI agent ──(sellbase MCP server)─────────────────────────┤
                                                              ▼
                    Supabase: Edge Functions (sellbase-api, -webhooks, -jobs)
                              Postgres schema `sellbase` (RLS) · Vault · Storage · pg_cron
                                                              │
                                   Stripe · Resend · your webhooks

• 単一の API コントラクト。 すべてのルートは @sellbase/core の Zod で一度だけ定義されています。Hono サーバーはそれを使って検証し、OpenAPI 仕様と型付き SDK もそこから生成され、MCP ツールも再利用します。
• スナップショット。 注文には価格、タイトル、住所のコピーが保存されるため、後からカタログを変更しても過去の注文には影響しません。
• アウトボックス。 ビジネスイベントは変更と同じトランザクション内に書き込まれ、そこからジョブがメールと Webhook を配信します。

パッケージ	内容
sellbase	CLI：init、doctor、upgrade、add、seed、token、mcp
@sellbase/admin	管理画面（React）。静的ページとしても配布されます
@sellbase/react	ストアフロント向けのプロバイダーとフック
@sellbase/web	あらゆるサイト向けの Web コンポーネント
@sellbase/sdk	型付き API クライアントと SEO ヘルパー
@sellbase/mcp	AI エージェント向け MCP サーバー
@sellbase/core	スキーマ、API コントラクト、価格設定、ステートマシン

ドキュメント

• はじめに（スペイン語）
• Supabase を使って Next.js アプリに EC ストアを追加する (スペイン語)
• 本番環境にデプロイする
• 管理画面をカスタマイズする
• Stripe で実際の決済を行う（スペイン語）
• API リファレンス、およびエージェント向けの llms.txt と llms-full.txt
• 仕様とアーキテクチャ上の決定事項
• 変更履歴

開発

pnpm i
pnpm exec supabase start && node scripts/seed-demo.mjs
pnpm dev                    # playground on http://localhost:3100 (admin at /admin)
pnpm lint && pnpm typecheck && pnpm test
pnpm test:db                # pgTAP
pnpm test:integration       # API against the local database
pnpm test:e2e               # Playwright
node scripts/acceptance.mjs # clean project → init → agent over MCP → test purchase

CONTRIBUTING.mdを参照してください。セキュリティ上の問題については、SECURITY.mdをご覧ください。

ステータス

Sellbase は 0.3 です。まだ新しいプロジェクトですが、必要な機能はそろっています。すべてのコミットで、次の一連のフローを CI で検証しています。

• pgTAP；
• API 統合テスト；
• Playwright によるエンドツーエンドテスト；
• MCP 経由で実際のエージェントを使ったクリーンインストールの受け入れテスト。

今後のロードマップ：

• ホスティングプロバイダーごとのインストールガイド；
• 決済プロバイダーの追加（Mercado Pago、Stripe 経由の OXXO）；
• 配送ラベルとの連携；
• 請求書発行（CFDI）。

スペイン語

Sellbase は、あなたのプロジェクト内（あなたのリポジトリと Supabase）にインストールし、AI エージェントで設定・運用できるオープンソースのコマースキットです。

含まれる機能：

• 写真とバリエーションを備えたカタログ；
• Stripe によるチェックアウト；
• 注文、在庫、放棄されたカート；
• 割引、予約、メール；
• /admin の完全な管理画面；
• API と MCP サーバー。

Next.js、Vite + React、または Web コンポーネントを使ったあらゆるサイト（純粋な HTML、WordPress、Webflow…）で動作します。

npx supabase start
npx sellbase init --yes

その後、/admin にアクセスするか（ローカル環境では、ユーザー名とパスワードが .env.sellbase に保存されます）、エージェントに 「Sellbase でストアを設定して」 と伝えてください。

ガイド：はじめに、Stripe で実際の決済を行う、デプロイ。

ライセンス

MIT