Mcp-tiktokshop
A. 模型上下文协议 （MCP）服务器 我们试试吧。。让像克劳德这样的人工智能助手直接从您的对话中管理订单、回复客户消息和处理产品评论。
工具
订单
| 工具 | 说明 | 参数 |
|---|---|---|
list_orders | 使用筛选器搜索订单 | page_size, page_token, order_status, sort_field, sort_order |
get_order_detail | 按ID获取订单的完整详细信息 | order_ids （数组） |
客户对话
| 工具 | 说明 | 参数 |
|---|---|---|
list_conversations | 列出客户服务对话 | page_size, page_token |
read_conversation | 读取消息历史记录 | conversation_id, page_size, page_token |
reply_to_conversation | 向客户发送回复 | conversation_id, content |
产品评论
| 工具 | 说明 | 参数 |
|---|---|---|
list_reviews | 列出带有过滤器的产品评论 | page_size, page_token, product_id, min_rating, max_rating |
reply_to_review | 发布卖家对评论的回复 | review_id, content |
注： 客户对话和评论需要特定的API范围，可能需要TikTok的批准。订单开箱即用。
先决条件
- Node.js>=18
- TikTok商店卖家账户
- 应用程序打开 抖音小店合作伙伴中心
安装
npm install -g mcp-tiktokshop或来源：
git clone https://github.com/LeChabrax/mcp-tiktokshop.git
cd mcp-tiktokshop
npm install
npm run build设置
1.创建TikTok商店应用程序
- 首选 抖音小店合作伙伴中心
- 创建应用程序（自定义或公共）
- 设置您的重定向URL（您控制的任何HTTPS URL）
- 启用您需要的API作用域：
| 范围 | 必需 |
|---|---|
seller.order.info | 订单 |
seller.authorization.info | 店铺信息 |
seller.customer_service | 对话（可能需要批准） |
| 产品评论范围 | 评论（可能不适用于所有地区） |
2.获取您的证书
运行交互式安装程序：
npm run auth这将：
- 询问您的应用密钥和应用密码
- 打开TikTok授权页面
- 将代码交换为访问令牌
- 取回你的商店密码
- 将所有内容保存到
.env
3.配置您的AI助手
克劳德桌面版 --编辑 claude_desktop_config.json:
{
"mcpServers": {
"tiktokshop": {
"command": "npx",
"args": ["-y", "mcp-tiktokshop"],
"env": {
"TIKTOK_SHOP_APP_KEY": "your_app_key",
"TIKTOK_SHOP_APP_SECRET": "your_app_secret",
"TIKTOK_SHOP_ACCESS_TOKEN": "your_access_token",
"TIKTOK_SHOP_SHOP_CIPHER": "your_shop_cipher"
}
}
}
}克劳德代码 --创建 .mcp.json 在项目根目录中：
{
"mcpServers": {
"tiktokshop": {
"command": "npx",
"args": ["-y", "mcp-tiktokshop"],
"env": {
"TIKTOK_SHOP_APP_KEY": "your_app_key",
"TIKTOK_SHOP_APP_SECRET": "your_app_secret",
"TIKTOK_SHOP_ACCESS_TOKEN": "your_access_token",
"TIKTOK_SHOP_SHOP_CIPHER": "your_shop_cipher"
}
}
}
}环境变量
| 变量 | 描述 | 必填 |
|---|---|---|
TIKTOK_SHOP_APP_KEY | 合作伙伴中心的应用程序密钥 | 是 |
TIKTOK_SHOP_APP_SECRET | 合作伙伴中心的应用程序密钥 | 是 |
TIKTOK_SHOP_ACCESS_TOKEN | OAuth2访问令牌 | 是 |
TIKTOK_SHOP_SHOP_CIPHER | 店铺标识符 | 否（某些端点在没有它的情况下工作） |
运作原理
- 认证：TikTok Shop API使用HMAC-SHA256请求签名。这是由客户端自动处理的。
- 运输：使用stdio与Claude Desktop/Code进行本地通信。
- 速率限制：TikTok商店允许每个商店每秒50个请求。
- 令牌刷新：访问令牌过期。重新运行
npm run auth买一个新的。
发展
git clone https://github.com/LeChabrax/mcp-tiktokshop.git
cd mcp-tiktokshop
npm install
npm run dev # Run with hot reload
npm run build # Compile TypeScript贡献
欢迎投稿！看 贡献.md 作为指导方针。
需要帮助的领域：
- 在不同的TikTok商店地区（美国、英国、东南亚）进行测试
- 增加对更多API端点（产品、物流、履行）的支持
- 令牌自动刷新机制
- Webhook支持实时更新
许可证
麻省理工学院-见 许可证