Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

BayDeep — E-commerce MCP Gateway

von MeshTokVersion 1.0.1i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.MeshTok/baydeep

So installierst du es

What it does

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

  • Connects Läuft in der Cloud
  • Account or key No key needed
  • Category Onlineshops & Zahlungen

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte BayDeep — E-commerce MCP Gateway. Folge https://mcp.popnx.com/i/meshtok-baydeep.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.baydeep.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameBayDeep — E-commerce MCP Gateway
    Remote MCP server URL · Adressehttps://mcp.baydeep.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsBayDeep — E-commerce MCP Gateway

  4. Ausprobieren

    Nutze BayDeep — E-commerce MCP Gateway und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es BayDeep — E-commerce MCP Gateway nutzt, oder ein Werkzeug von BayDeep — E-commerce MCP Gateway in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameBayDeep — E-commerce MCP Gateway
    Connection · Adressehttps://mcp.baydeep.com/mcp
  3. BayDeep — E-commerce MCP Gateway im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen BayDeep — E-commerce MCP Gateway aus deinen Plugins wählen

  4. Ausprobieren

    Nutze BayDeep — E-commerce MCP Gateway und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es BayDeep — E-commerce MCP Gateway nutzt, oder ein Werkzeug von BayDeep — E-commerce MCP Gateway in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user baydeep https://mcp.baydeep.com/mcp
  3. /mcp in Claude Code eingeben

    BayDeep — E-commerce MCP Gateway sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze BayDeep — E-commerce MCP Gateway und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es BayDeep — E-commerce MCP Gateway nutzt, oder ein Werkzeug von BayDeep — E-commerce MCP Gateway in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze BayDeep — E-commerce MCP Gateway und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es BayDeep — E-commerce MCP Gateway nutzt, oder ein Werkzeug von BayDeep — E-commerce MCP Gateway in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze BayDeep — E-commerce MCP Gateway und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es BayDeep — E-commerce MCP Gateway nutzt, oder ein Werkzeug von BayDeep — E-commerce MCP Gateway in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.baydeep.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die BayDeep — E-commerce MCP Gateway nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user baydeep https://mcp.baydeep.com/mcp

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "baydeep": {
      "type": "http",
      "url": "https://mcp.baydeep.com/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.1
In der Registry veröffentlichti
11. Nov. 2026
Code zuletzt geänderti
11. Nov. 2026
Zuletzt geprüft
15. Nov. 2026
Entwickler
MeshTok
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 15. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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 Authorizatio

  • 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. Re

  • 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.

  • product_detail

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

  • convert_link

    Convert any aliexpress.com product/shop/search URL(s) into YOUR affiliate-attributed link(s) (max 10 per call). ALWAYS run items through this before presenting a buy link — attribution is how agent-driven purchases are tracked. Requires a free API key.

  • 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

  • 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.

  • flight_search

    Search FLIGHT FARES in the catalog (Aviasales/Travelpayouts partners, fares refreshed daily). Filter by origin/destination IATA code (e.g. PEK, JFK, SIN) and optional departure date (YYYY-MM-DD). Items sorted by price; book_url is ALREADY affiliate-attributed — link the user stra

  • shelf_search

    Search the LOCAL shelf — physical goods (AliExpress) AND flight fares (Travelpayouts). No platform quota consumed — works WITHOUT any API key (30 req/min per IP). sort=relevance(default when q given)|price|sales|latest; price_min/price_max filter. Goods items carry detail_url (at

  • 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.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto MeshTok bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 9 Tagen

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 112 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 11 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/meshtok-baydeep.svg)](https://mcp.popnx.com/en/servers/meshtok-baydeep)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Onlineshops & Zahlungeni

  • Mehr Sterne als 0 % der anderen 2960 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 78 % der anderen 2960 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 63 % der anderen 2960 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist BayDeep — E-commerce MCP Gateway sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 9 Tagen geändert, und die neueste Version (1.0.1) kam vor 9 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

von stripeWeit verbreitet★ 2072Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

von flightclawWachsend★ 87Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

von trade-it-incAm Anfang★ 62Aktualisiert vor 35 Tagen

Läuft in der Cloud✓ vom Dienst · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

von idealoAm Anfang★ 28Aktualisiert vor 6 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.idealo.com
Im Vergleich mit ähnlichen
Dieser
BayDeep — E-commerce MCP Gateway
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinNeinNein
Basisprüfungen4/54/44/45/54/44/4
Lizenz–MITMITCC0-1.0MITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

BayDeep — Agent 电商网关(海外)

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.

{

"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 同款)。

本地运行:

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 实测:unly1130@gmail.com 已有账号壳,用「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 接入百万级商品池。