# CB-Ads-MCP

Cross-Border E-Commerce Ads MCP Server — 跨境电商卖家的 AI 广告副驾

## 定位

统一管理 Amazon Ads + Google Shopping + Meta + TikTok + Shopify 数据，深度绑定跨境电商工作流（选品/库存/利润/Feed 优化）。

## 核心差异化

- 不做纯广告操作（官方 MCP + Adspirer 已在做）
- 做**跨境电商工作流整合**：广告+销售+库存+Feed+利润统一决策
- 封装各平台官方 MCP，加跨境电商场景层
- 自用驱动：自己跨境电商能用，节省成本

## 技术栈

- TypeScript + `@modelcontextprotocol/sdk`
- Streamable HTTP 传输
- Cloudflare Workers 部署
- PostgreSQL (Supabase) + Redis (Upstash)

## 项目结构

```
cb-ads-mcp/
├── src/
│   ├── server.ts                 # MCP Server 入口
│   ├── platforms/                # 各平台封装
│   │   ├── amazon/               # Amazon Ads + SP-API
│   │   ├── google/               # Google Ads (Shopping/PMax)
│   │   ├── meta/                 # Meta Ads (DPA/Advantage+)
│   │   ├── tiktok/               # TikTok Ads (Shop/Spark)
│   │   └── shopify/              # Shopify Storefront/Admin API
│   ├── safety/                   # 安全护栏（暂停默认/预算门控/审计）
│   ├── utils/                    # 限流/缓存/工具函数
│   └── types/                    # 共享类型定义
├── docs/                         # 文档
└── tests/                        # 测试
```

## 实施阶段

- **Phase 1**: Amazon Ads + Shopify MVP（利润计算器）
- **Phase 2**: Google Shopping + Meta（跨平台 ROAS）
- **Phase 3**: TikTok + 跨境工作流（翻译/库存预警/A/B 测试）
- **Phase 4**: Scale 功能（多账号/异常检测/API access）

## 定价

| 档位 | 月费 | 调用 | 平台 |
|---|---|---|---|
| Free | $0 | 25次/月 | 1平台+Shopify 只读 |
| Starter | $29 | 500次/月 | 2平台+Shopify 读写 |
| Growth | $79 | 2000次/月 | 4平台全量 |
| Scale | $199 | 无限 | 全量+多账号+API |

## 文档

- [竞品调研报告](../docs/ads-mcp-竞品调研报告.md)
- [方案规划](../docs/跨境电商广告MCP方案规划.md)