Sellfox MCP — 赛狐 MCP 用 AI 助手管理亚马逊店铺

为什么你需要这个工具？

做亚马逊的你，每天是不是这样：

• 打开赛狐后台 → 切换到广告报表 → 选店铺、选时间、等加载 → 导出 CSV → 打开 Excel → 做数据透视 → 发现问题 → 再回到后台调广告

• 想看某个 ASIN 的利润？又要切到财务模块 → 选店铺 → 搜 ASIN → 等加载 → 复制数据

• 想知道哪个产品退货率高？切换到 FBA 退货报告 → 筛选 → 排序 → 一个一个查

• 十几个店铺，每个都要重复一遍

这些操作的本质，都是在"翻译"——把你的业务问题翻译成鼠标点击和菜单选择。

那如果，有一个助手能直接听懂你的问题呢？

"帮我对比上周所有店铺的 SP 广告 ACOS，找出花费超过 $50 但转化率低于 5% 的广告组。"

"把最近三个月退货率最高的 10 个 ASIN 列出来，附带他们的利润数据。"

"我今天所有店铺的销量汇总，跟昨天对比一下。"

这就是 Sellfox MCP 要做的事。

AI 时代：跨境卖家的机遇与挑战

你正在面对的

• 数据分散 — 订单、广告、库存、利润、评价……每个数据住在不同页面，想交叉分析？导出 Excel 慢慢 VLOOKUP

• 重复劳动 — 每天早上一杯咖啡，打开 8 个页面，点 40 次鼠标，拉 6 份报表——这是运营的"晨间仪式"

• 决策靠经验 — 数据在系统里，但提取太慢。最后变成"我感觉这个品该加预算了"

• 人效瓶颈 — 一个熟练运营管 3-5 个店铺基本饱和，扩店就得加人

AI 带来的改变

2024 年开始，大语言模型（LLM）真正进入了实用阶段。Claude、GPT 这些模型不只是"聊天机器人"，它们能调用工具、分析数据、生成报告。

MCP（Model Context Protocol）是一种开放协议，让 AI 助手能够安全地连接你的业务系统——就像给 AI 装上了"手和眼睛"。

这意味着什么？

• 从"人找数据"变成"数据找人" — 你不用去各个页面翻数据，AI 自动帮你汇总分析

• 从"经验驱动"变成"数据驱动" — 每个决策都能快速用数据验证，不用再拍脑袋

• 从"一个人管 5 个店"变成"一个人管 20 个店" — 重复操作交给 AI，你专注策略

• 24 小时在线 — 睡前问一句"今天广告花了多少，有没有异常的"，秒回

但工具不是魔法

坦诚地说，AI 不会替你选品、不会替你定价、不会替你理解你的品类。它能做的，是把你从数据搬运工解放出来，让你回归卖家的核心价值——产品和策略。

Sellfox MCP 是什么？

一句话：把你的赛狐（Sellfox）亚马逊后台数据，接入 AI 助手。

它基于 MCP 协议，封装了赛狐 OpenAPI 的 70+ 个数据接口，覆盖：

使用方式

Sellfox MCP 提供两种使用方式：部署 HTTP 服务后接入 Claude 桌面端（推荐个人使用），或通过 API Key 分享给团队成员。

架构概览

整体部署架构非常简单，只需要一台机器运行 MCP 服务，其他客户端通过 MCP 协议连接：

┌─────────────────────┐
│  Claude 桌面端       │  ← 你的电脑（日常使用）
│  (MCP streamableHttp)│
└────────┬────────────┘
         │ HTTP
         ▼
┌─────────────────────┐
│  Sellfox MCP 服务    │  ← 部署在服务器 / 本机
│  (Node.js HTTP 网关) │
└────────┬────────────┘
         │ HMAC-SHA256
         ▼
┌─────────────────────┐
│  赛狐 OpenAPI        │
└─────────────────────┘

Step 1：部署 MCP 服务

环境要求

• Node.js 22+（需要 node:sqlite 实验性支持）

• 赛狐 OpenAPI 账号（联系赛狐商务开通，获取 client_id 和 client_secret）

下载与启动

# 1. 克隆项目
git clone <your-repo-url> sellfox-mcp-node
cd sellfox-mcp-node

# 2. 安装依赖
npm install
npm run build

# 3. 创建环境变量配置
cp .env.example .env

编辑 .env 文件，填入你的赛狐认证信息：

# 赛狐 OpenAPI 认证信息（必填）
SELLFOX_CLIENT_ID=你的client_id
SELLFOX_CLIENT_SECRET=你的client_secret

# 管理员 Token（首次启动时设置，用于创建 API Key）
SELLFOX_BOOTSTRAP_TOKEN=你的管理员token

# 以下为可选配置
# SELLFOX_CREDENTIAL_DB=./runtime/credentials.db   # 多账号凭据池

启动 HTTP 服务：

# 开发模式（推荐）
npm run dev:http

# 生产模式
npm run build && npm run start:http

服务默认运行在 http://localhost:3100。启动后访问 http://localhost:3100/console 打开管理后台。

创建 API Key

在管理后台中创建 API Key，用于 Claude 桌面端连接：

1. 打开 http://localhost:3100/console

2. 进入「API Key 管理」

3. 点击「创建 Key」，设置名称和店铺权限

4. 复制生成的 Key（格式：sk-xxx）

Step 2：配置 Claude 桌面端

Claude 桌面端（Claude Desktop）是 Anthropic 官方推出的桌面应用，支持通过 MCP 协议接入外部工具。

找到配置文件

根据你的操作系统，Claude 桌面端的配置文件位于：

• Windows：%APPDATA%\Claude\claude_desktop_config.json

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

用文本编辑器打开这个文件（如果不存在则新建），添加 MCP 服务配置：

{
  "mcpServers": {
    "Sellfox MCP": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:3100/mcp?key=你的API_KEY",
      "name": "Sellfox MCP",
      "description": "Sellfox 跨境电商平台数据服务。连接赛狐 OpenAPI，支持查询亚马逊店铺销量、订单、广告、利润、库存和评价数据。"
    }
  }
}

如果你把 MCP 服务部署到了服务器上，把 127.0.0.1:3100 换成服务器的 IP 和端口即可。

保存配置文件后，完全退出并重启 Claude 桌面端。

Step 3：开始使用

重启后，Claude 桌面端会自动连接 Sellfox MCP。你可以直接在对话中提问：

帮我看看有哪些店铺

查一下最近7天所有店铺的销量汇总

对比上周和这周的广告花费，按店铺列出

哪个 ASIN 退货率最高？帮我看下它的评价内容

分析一下我 SP 广告中 ACOS 超过 30% 的关键词，给出优化建议

上个月哪个店铺的净利润最高？列出 Top 10 产品的利润率

进阶：团队共享

同一个 MCP 服务可以创建多个 API Key，分给团队不同成员使用。在管理后台为每个成员创建独立的 Key，并可以限制每个 Key 只能访问指定店铺，实现权限隔离。

详细功能说明

1. 销售与订单

典型用法：

"查询最近 30 天所有店铺销量 Top 20 的 ASIN"

"列出所有待发货的 FBM 订单"

"上周退货的 FBA 产品有哪些，按退货数量排序"

2. 广告分析

广告基础数据（19 个接口）

覆盖 SP / SB / SD 三种广告类型的活动、广告组、产品、关键词、投放目标、否定关键词等基础数据。

小时维度报告（13 个接口）

SP/SB/SD 广告的小时级数据报告，包括活动、广告组、产品、投放、广告位等维度。

自定义广告报告

典型用法：

"所有 SP 广告中，哪些关键词的 ACOS 超过 50%？"

"对比 SB 和 SD 广告的转化率，分店铺展示"

"昨天的广告小时报告，看看哪个时段转化最好"

"拉取最近 7 天的搜索词报告，找出高点击低转化的词"

3. 财务与利润

典型用法：

"上个月每个店铺的净利润是多少？"

"帮我算一下 Top 10 销量 ASIN 的真实利润率（扣除广告和 FBA 费用）"

"哪些产品的利润率低于 10%？列出并排序"

4. 库存与 FBA

典型用法：

"FBA 库存少于 30 天的 ASIN 有哪些？帮我生成补货建议"

"在途的发货批次有哪些，预计什么时候到仓？"

"最近出库成本异常高的产品有哪些？"

5. 评价与客服

典型用法：

"最近一周有哪些差评？把对应的订单和产品信息列出来"

"对比所有店铺的评分变化趋势"

"找出有差评但还没处理的产品"

6. 系统工具

多店铺管理

如果你有多个赛狐账号（比如多套主体），可以通过凭据池管理：

# 初始化凭据数据库
npx tsx --experimental-sqlite src/server.ts --init-pool

# 添加凭据
npx tsx --experimental-sqlite src/server.ts --add-credential \
  --name "主体A" --client-id "xxx" --client-secret "yyy"

然后在 .env 中配置数据库路径：

SELLFOX_CREDENTIAL_DB=./runtime/credentials.db

系统会自动轮换凭据，避免单个账号的 API 频率限制。

安全说明

• 数据不出境 — 所有数据请求直接在你的机器和赛福 OpenAPI 之间传输，不经过任何第三方

• Token 本地存储 — OAuth2 Token 缓存在本地文件或 SQLite 中，不上传

• 店铺级权限 — HTTP 模式下可配置每个 API Key 只能访问指定店铺

• 代码开源可审计 — 所有代码在本地运行，可自行审查

常见问题

Q: 需要什么技术背景？

A: 日常使用不需要任何编程背景。部署服务需要几步命令行操作（跟着教程复制粘贴就行），配置 Claude 桌面端只需编辑一个 JSON 文件。一旦配置完成，以后每天使用只需打开 Claude 桌面端用自然语言对话即可。

Q: 赛狐 OpenAPI 怎么开通？

A: 联系你的赛狐客户经理，申请开通 OpenAPI 权限，获取 client_id 和 client_secret。

Q: 数据安全吗？

A: 代码完全开源，在你的电脑或服务器上本地运行。数据直接从你的机器到赛狐服务器，不经过任何中间环节。

Q: 支持哪些亚马逊站点？

A: 赛狐 OpenAPI 覆盖北美（US/CA/MX）、欧洲（UK/DE/FR/IT/ES 等）、日本、澳洲、中东等全球主要站点。

Q: 可以同时管理多个赛狐账号吗？

A: 支持。通过凭据池功能，可以配置多套 client_id/client_secret，系统会自动轮换。

Q: 免费吗？

A: 本项目开源免费。但使用赛狐 OpenAPI 需要赛狐账号授权（具体费用政策请咨询赛狐官方）。

开发相关

npm run dev          # Stdio 开发模式
npm run dev:http     # HTTP 开发模式
npm run build        # 编译 TypeScript
npm start            # 运行编译后的 Stdio 服务
npm start:http       # 运行编译后的 HTTP 服务

技术栈：TypeScript + Node.js 22 + MCP SDK + Zod v4 + SQLite + 零外部网络依赖

项目结构

src/
├── server.ts          # Stdio MCP 入口
├── http-server.ts     # HTTP 网关入口
├── mcp-server.ts      # MCP 工具注册（70+ 工具）
├── services.ts        # 业务逻辑层
├── client.ts          # 赛狐 OpenAPI 客户端（HMAC 签名/Token/OAuth2）
├── endpoint-specs.ts  # 70+ 接口规格定义
├── credential-pool.ts # 多账号凭据池（SQLite）
├── api-key-manager.ts # API Key 管理
├── auth.ts            # Bearer Token 管理
├── shop-permission.ts # 店铺权限控制
└── admin-page.ts      # 管理后台页面

协议

MIT License