BayDeep — E-commerce MCP Gateway

BayDeep — AI エージェント向け EC ゲートウェイ（海外）

AI エージェント向けの EC プラグインです。商品検索、価格比較、購入リンク、注文履行——淘宝／京東／拼多多 → あらゆる AI エージェント。 設計ドキュメント：agentmall リポジトリの DESIGN-海外Agent电商网关调研-20261014.md と DESIGN-Agent电商网关-20261014.md（docs/ にも複製があります）

🌐 リモート MCP サーバー（稼働中）

エンドポイント：https://mcp.baydeep.com/mcp（ストリーミング HTTP） · REST：https://api.baydeep.com/v1

11 個のツール：catalog_overview（取り扱い商品の確認） · shelf_search · shelf_item · flight_search · search_products · hot_products · product_detail · convert_link · affiliate_orders · categories · mint_free_key（登録不要の API キー）。5,000 件以上の販売中商品（AliExpress アフィリエイト）と航空運賃（Travelpayouts／Aviasales、40 路線）を提供しています。購入者は leapbest.com で買い物ができます。

{
  "mcpServers": {
    "baydeep": {
      "url": "https://mcp.baydeep.com/mcp"
    }
  }
}

ドメインとブランド

• メインドメイン：baydeep.com（Deep ファミリー：FlowDeep 対話／WorkDeep オフィス／BayDeep ショッピングゲートウェイ）
• 維持：leapbest.com（将来的に消費者向けのお得な商品を紹介するサイト）
• エンドポイント計画：mcp.baydeep.com（MCP）／api.baydeep.com（REST）

ディレクトリ構成（2026-11-09 以降）

• docs/ — 設計ドキュメントとプラットフォーム調査
• src/adapters/ — L1 プラットフォームアダプター（agentmall tbk/jd/pdd.js のパターンを踏襲：call 署名 + normGoods による統一商品プロトコル + searchGoods/goodsDetail/convertLink/orderDetails）
• src/config.js — env 駆動の設定（.env 読み込みに依存関係なし）
• src/util.js — エラーコード／キー生成（agentmall util.js ERR と同じ構造）
• src/store.js — 依存関係なしの JSON ファイルストレージ（keys/shelf、アトミック書き込み＋デバウンス保存。規模拡大後に pg に置き換え）
• src/services/ — keys / trial / shelf（商品棚）/ metrics（呼び出し計測、agentmall mcp_calls を反映）
• src/middleware.js — 階層型レート制限（t0_free 30rpm / t1_std 60rpm トークンバケット + keyless IP 30/min）
• src/server.js — 依存関係なしの HTTP 基盤（CORS／ルーティング／エラープロトコル、express の代替）
• src/routes/v1.js — REST（補助面） · src/routes/mcp.js — MCP JSON-RPC（主要面）
• src/index.js — ゲートウェイのエントリーポイント · src/jobs.js — 商品棚同期タスク（独立プロセス）
• scripts/seed-shelf.js — MOCK モードの商品棚シード
• test/smoke.js — L1 スモークテスト · test/smoke-l2.js — L2 エンドツーエンドスモークテスト（18 件のアサーション）
• website/ — 公式サイトの静的ページ（シリコンバレーのサーバー上の nginx にデプロイ）

サイトのデプロイ（2026-10-23 公開、シリコンバレー 49.51.201.95）

サイト	内容	状態
https://baydeep.com	開発者向け英語ランディングページ（価値提案／機能／ワークフロー／Deep ファミリー）+ /llms.txt（GEO）	✅ HTTPS 200（Let's Encrypt）
https://leapbest.com	消費者向けお得商品サイトの公開準備中ページ	✅ HTTPS 200

デプロイ方式は flowdeep.ai を踏襲しています：/var/www/<域名> の静的ルート + sites-enabled/<域名>.conf + certbot（certonly --nginx）。ページを変更する際は website/ を更新してから scp します。

開発の進捗状況

項目	状態
adapters/aliexpress.js（検索／人気商品／詳細／リンク変換／カテゴリ／注文）	✅ コード完成 + 実際の接続テストに合格（2026-11-09 夜）
L2 ゲートウェイ（統一商品カタログ／階層型オープンアクセス／MCP+REST）	✅ 実データによるエンドツーエンドテストに合格：商品棚に実在商品 593 件、trial key→search/shelf/item/MCP の全フローが正常
実 API 接続テスト	✅ AppKey 558366（BayDeep Agent Gateway、Default パッケージ Active）、認証情報は .env 内（gitignored）
Portals tracking id（リンク変換のアトリビューション）	✅ 完了（2026-11-09）：メインアカウント default + プールアカウント baydeep_dev1/baydeep_dev2（.env に追加済み）。リンク変換の実測テストに合格（短縮リンク s.click を一括生成）
Advanced API（hotproduct 人気ランキング）	⏳ 申請待ち：App Overview → API Permission Group → Advanced API Apply（Portals 登録メールアドレスの入力が必要）
注文 API のパラメーター	⚠️ メソッド名が order.get であることを実測済みですが、パラメーター形式で 406 が発生。公式ドキュメントとの照合待ち（注文トラフィックが発生してから再確認）
ゲートウェイのデプロイ（シリコンバレーサーバー node/pm2 → mcp/api.baydeep.com）	✅ 公開済み（2026-11-09、pm2:8821 + nginx + Let's Encrypt；shelf 5022）

実接続テスト記録（2026-11-09、AppKey 558366）

• ✅ categories：564 カテゴリ
• ✅ searchGoods：実在商品（価格／コミッション率を正常に返却、コミッション 7% > 分配率の基準 3%）
• ✅ goodsDetail：メソッド名は aliexpress.affiliate.productdetail.get であることを実測（旧ドキュメントの名前 product.detail.get は InvalidApiPath を返します）
• ⏳ convertLink：パラメーターは source_values（urls は廃止）であることを実測 + tracking_id は公式に必須——アダプターは新しいパラメーターで実装済みで、tracking id がない場合はローカルで処理を拒否します
• ❌ hotProducts：InsufficientPermission——Advanced パッケージの機能のため、申請が必要です（申請時に Portals 登録メールアドレスを入力）
• ⚠️ orderDetails：メソッド名は aliexpress.affiliate.order.get であることを実測。406 のパラメーターは確認待ち
• 商品棚：jobs.syncOnce を 1 回実行し、実在商品 593 件を登録。2026-11-09 の scripts/expand-shelf.js（93 語 ×2 ページ）により 5022 件に拡充。サーバーで毎日 03:30 に cron が自動で追加拡充
• アダプターに node<18 向けの fetch/AbortSignal ポリフィルを同梱——ローカルの node16 でゲートウェイの実行と接続テストが可能（サーバーのアップグレードは不要）

L2 ゲートウェイ（2026-11-09 リリース、agentmall アーキテクチャの海外向けミラー、依存関係ゼロで node>=16 ですぐ実行可能）

オープンな階層構造（国内の源頭淘と同じ構成＋エージェントネイティブな強化）：

層	条件	機能
公開読み取り専用	なし（IP あたり 30/min）	MCP initialize/tools/list + shelf_search/shelf_item（ローカル商品棚。プラットフォームの割り当てを消費しません）
無料キー	登録不要：MCP 内で mint_free_key ツールを直接呼び出してセルフサービスで取得（エージェントはプロトコルチャネルから離れる必要がありません）。HTTP 互換の POST /v1/trial にも対応。無期限で有効	9 つの全ツール + AliExpress リアルタイム分散取得 + tracking_id によるアトリビューション
出金用アカウント連携	コンソール（決済マイルストーン実装済み）	分配金の出金（取引額の 3%。コミッション率が 3% 超の商品だけが対象 — settlement.js で統一）

MCP ツール（9 個）：mint_free_key（キーなしでセルフサービス取得。エージェントが登録を完結する入口）· shelf_search / shelf_item（キー不要）· search_products / hot_products / product_detail / convert_link / affiliate_orders / categories（キーが必要）

アトリビューション：AliExpress アフィリエイトでは tracking_id による第 1 階層のアトリビューションのみ利用可能です（jd subUnionId/pdd customParameters のようなサブ識別子はありません）→ 各 agent_key の作成時に ALIEXPRESS_TRACKING_IDS プールから番号を 1 つ割り当てます。リンク変換・検索・注文のすべてにその番号を付与し、番号に基づいて注文をキーに再関連付けします。プールが空の場合は共有のメイン番号を使用します（/v1/me がアトリビューションモードの説明を返します）。

ストレージ：data/ 配下の JSON ファイル（keys.json / shelf.json と、計測イベントストリームの mcp_calls.ndjson）を使用します。アトミック書き込み＋デバウンスによるディスクへの保存に対応し、プロセス終了時に flush します。商品棚は 10 万件規模の商品をメモリーインデックスで十分に処理できます。利用が増えたら pg に切り替えます（agentmall と同じ方式）。

ローカルでの実行：

node test/smoke-l2.js    # 端到端冒烟（固定 MOCK，node>=16，23 断言；.env 为真实模式也不受影响）
node scripts/seed-shelf.js && node src/index.js   # 起网关（默认 127.0.0.1:8787）
node test/live-call.js   # 真实 API 快速联调（搜索+类目）
node test/live-probe.js  # L1 六方法能力探测（真实凭据下哪些可用/被挡）
node src/jobs.js         # 货架定时同步（真实模式：每小时 hot 榜+关键词池）

エンドポイント：POST /mcp（JSON-RPC）· POST /mcp/trial · GET /v1/search|hot|item/:id|orders|categories|shelf|me · POST /v1/trial|convert · GET /healthz

実環境での連携テスト手順（AppKey 設定済み、.env で MOCK_MODE=false）

node test/live-probe.js   # 一眼看全六个方法可用性
node src/jobs.js          # 货架真实数据同步（tracking id 不影响搜索/详情/货架）
# 转链需先建 tracking id：portals.aliexpress.com → Tracking ID → 填入 .env ALIEXPRESS_TRACKING_ID

アフィリエイトアカウントの進捗状況（2026-10-23 登録リストをユーザーに引き継いで実施）

プラットフォーム	登録先	状態
AliExpress Portals（アフィリエイト）	https://portals.aliexpress.com	🔄 ユーザーが登録中（10-23 の実地確認：[email protected] はすでにアカウントの仮登録済み。「Use confirmation code instead」を選択してメールの確認コードでログイン。パスワードは不要）
AliExpress オープンプラットフォーム（AppKey）	https://openservice.aliexpress.com	🔄 ユーザーが登録中：開発者タイプ=Dropshipping/Affiliates → Affiliates (individual)、Country=China、データ処理場所=United States、コンプライアンスに関する 4 つの質問はすべて No。アプリ作成後、「aliexpress.affiliate」製品パッケージの権限を申請
Payoneer（eBay などの受け取り）	https://www.payoneer.com	⏳ 登録待ち
WorldFirst 万里汇（アリババ系の受け取り）	https://www.worldfirst.com	⏳ 登録待ち
eBay ePN	https://partnernetwork.ebay.com	⏳ 登録待ち（Payoneer 経由であることを確認済み）
Temu affiliate	https://affiliate.temu.com	⏳ 登録待ち
TikTok Shop アフィリエイト	https://partner.tiktokshop.com	⏳ 評価待ち（seller-gated）

開発者向け価値提案

AI エージェントを収益化 — 購入ごとに 3% を獲得できます（コミッション対象商品、コミッション率 >3%）。1 つの MCP/REST 接続で、数百万点の商品プールを利用できます。