BayDeep — E-commerce MCP Gateway

io.github.MeshTok由 GitHub 帳號 MeshTok 發布v1.0.1更新於 Nov 11, 2026

E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

遠端電商閘道，讓助理搜尋 AliExpress 商品與機票票價、產生帶聯盟歸因的購買連結，並查看自己名下的歸因訂單。

可以做什麼
  • 搜尋與瀏覽商品：AliExpress 即時關鍵字搜尋、熱銷榜、最多 10 個商品 ID 的詳細資料、分類樹
  • 不需金鑰即可搜尋本機貨架（商品與機票），並依 ID 取得單一貨架項目
  • 把 AliExpress 商品、商店或搜尋網址轉換成帶聯盟歸因的連結
  • 依時間範圍檢視歸因訂單，含每筆分潤金額與彙總
  • 檢視目錄說明，並依出發／抵達 IATA 代碼與日期搜尋機票
  • 在工作階段內自助領取免費 API 金鑰以使用需金鑰的工具
適用情境
適合讓助理進行商品探索、比價、優惠資訊或機票查詢，並提供使用者帶歸因的購買連結；也適合代理營運者追蹤其促成購買所對應的佣金。
執行需求
遠端 Streamable HTTP 端點，無需本機安裝。貨架工具與目錄說明不需金鑰（每 IP 每分鐘 30 次）。需金鑰的工具須先透過 mint_free_key 領取免費金鑰，並以 X-API-Key 或 Authorization: Bearer 傳送。需要能連線至服務方端點。
安裝前請注意
金鑰為自助簽發並由助理保存，應視為憑證。即時搜尋、熱銷與商品詳細資料會消耗平台配額，請勿輪詢。convert_link 會改寫連結以進行歸因，affiliate_orders 會揭露與該金鑰 tracking id 綁定的佣金資料。實際購買發生在外部電商平台，不經過此伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 BayDeep — E-commerce MCP Gateway，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.MeshTok%2Fbaydeep/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "baydeep-e-commerce-gateway": {
      "type": "http",
      "url": "https://mcp.baydeep.com/mcp"
    }
  }
}

README

BayDeep — Agent 电商网关（海外）

[Listed on mcpservers.org] [npm: dsh-plugin-baydeep]

The e-commerce plugin for AI agents. 商品搜索、比价、购买链接、订单履约——淘宝/京东/拼多多 → 任何 AI Agent。 设计文档：agentmall 仓 DESIGN-海外Agent电商网关调研-20261014.md 与 DESIGN-Agent电商网关-20261014.md（副本在 docs/）

🌐 Remote MCP Server (live)

Endpoint: https://mcp.baydeep.com/mcp (Streamable HTTP) · REST: https://api.baydeep.com/v1

11 tools: catalog_overview (what we sell) · shelf_search · shelf_item · flight_search · search_products · hot_products · product_detail · convert_link · affiliate_orders · categories · mint_free_key (zero-signup API key). 5,000+ live products (AliExpress affiliate) + flight fares (Travelpayouts/Aviasales, 40 routes). Consumers shop at leapbest.com.

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

域名与品牌

  • 主域：baydeep.com（Deep 家族：FlowDeep 对话 / WorkDeep 办公 / BayDeep 购物网关）
  • 保留：leapbest.com（未来消费者端 deals 站）
  • 端点规划：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 — 错误码/key 生成（与 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消费者 deals 站 coming-soon 占位✅ 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 全链路 OK
真实 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 注册邮箱）
订单接口参数⚠️ 方法名已实测为 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 一轮 593 件真实商品入库；2026-11-09 scripts/expand-shelf.js（93 词 ×2 页）扩充至 5022 件，服务器每日 03:30 cron 自动续扩
  • 适配器自带 node<18 fetch/AbortSignal polyfill——本机 node16 即可跑网关与联调（服务器无需升级）

L2 网关（2026-11-09 落地，agentmall 架构海外镜像，零依赖 node>=16 直跑）

开放分层（与国内源头淘同构 + agent 原生增强）：

层门槛能力
公开只读无（IP 30/min）MCP initialize/tools/list + shelf_search/shelf_item（本地货架，不烧平台配额）
免费 key零注册：MCP 内直接调 mint_free_key 工具自助领取（agent 无需离开协议通道）；HTTP 兼容 POST /v1/trial。永久有效全 9 工具 + AliExpress 实时扇出 + tracking_id 归因
绑定提现控制台（结算里程碑落地）分成提现（成交额 3%，仅佣金率 >3% 的商品参与——settlement.js 统一口径）

MCP 工具（9 个）：mint_free_key（无 key 自助领 key，agent 无注册闭环的入口）· shelf_search / shelf_item（无 key）· search_products / hot_products / product_detail / convert_link / affiliate_orders / categories（key）

归因：AliExpress 联盟只有 tracking_id 一级归因（无 jd subUnionId/pdd customParameters 子位）→ 每个 agent_key 创建时从 ALIEXPRESS_TRACKING_IDS 池领一个号，转链/搜索/订单全带它，订单按号回滤到 key；池留空则共享主号（/v1/me 返回 attribution 模式说明）。

存储：data/ 下 JSON 文件（keys.json / shelf.json + mcp_calls.ndjson 测量流），原子写+防抖落盘，进程退出 flush；货架 10 万级商品内存索引足够，上量换 pg（agentmall 同款）。

本地运行：

bash
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）

bash
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，合规四题全 No；创建应用后申请「aliexpress.affiliate」产品包权限
Payoneer（收 eBay 等）https://www.payoneer.com⏳ 待注册
WorldFirst 万里汇（收阿里系）https://www.worldfirst.com⏳ 待注册
eBay ePNhttps://partnernetwork.ebay.com⏳ 待注册（Payoneer 通道已核实）
Temu affiliatehttps://affiliate.temu.com⏳ 待注册
TikTok Shop 联盟https://partner.tiktokshop.com⏳ 待评估（seller-gated）

开发者价值主张

Monetize your AI agent — earn 3% on every purchase (commission-eligible items, commission rate >3%). 一个 MCP/REST 接入百万级商品池。

來源：README.md，提交 fcd21a2

工具

11

mint_free_key

SELF-SERVE a free API key — NO signup, NEVER expires, unlocks ALL tools (live AliExpress search, hot products, attributed convert links, your orders). Call this FIRST if any other tool says a key is required. Store the returned key and send it as X-API-Key header (or Authorization: Bearer) on subsequent calls. Rate limit: 30 req/min. Attribution is bound to this key. Optional client_ref ([A-Za-z0-9-], <=40) = your own end-user id, echoed back on your orders.

輸入參數client_ref

search_products

LIVE AliExpress affiliate product search (100M+ item pool, ships to 200+ countries; prices in the target currency). Consumes platform quota — do not poll; prefer shelf_search for repeated lookups. Returns items with price, coupon, sales, rating, commission_rate and detail_url. Read-only. Requires a free API key.

輸入參數q必填pagesortship_tocurrencylanguagepage_sizecategory_id

hot_products

LIVE AliExpress hot-selling products (no keyword; optional category). Good for "what's trending" / deal feeds. Consumes platform quota. Read-only. Requires a free API key.

輸入參數pageship_tocurrencylanguagepage_sizecategory_id

product_detail

Full detail for up to 10 AliExpress product ids (comma separated or array). Read-only. Requires a free API key.

輸入參數product_ids必填

affiliate_orders

YOUR attributed affiliate orders in a time range (source for your commission settlement & refund tracking). Orders are filtered to your key's tracking_id; each order carries share_eligible + share_amount and the page ends with share_summary — each order carries share_eligible and share_amount fields. Requires a free API key.

輸入參數pagestatusend_time必填page_sizestart_time必填

categories

AliExpress affiliate category tree (for building category filters or browse UX). Requires a free API key.

無需輸入參數。

catalog_overview

WHAT BAYDEEP SELLS: product types currently in the catalog (physical goods from AliExpress, flight fares via Travelpayouts/Aviasales), item counts, top categories, and HOW to search/book each type. Call this FIRST when unsure what the catalog contains. Works WITHOUT any API key. Read-only.

無需輸入參數。

shelf_item

Get one LOCAL shelf item by goods_id (full normalized fields; works for goods and flight fares). Works WITHOUT any API key. Read-only.

輸入參數goods_id必填

版本歷史

1
  1. v1.0.1最新Nov 11, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。