AI导哈

TikTok商店管理工具

一个基于Model Context Protocol (MCP)的服务，允许AI助手管理TikTok商店订单、处理客户消息和产品评论。

  • by LeChabrax
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 LeChabrax/mcp-tiktokshop

使用说明

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的批准。订单开箱即用。

先决条件

安装

npm install -g mcp-tiktokshop

或来源：

git clone https://github.com/LeChabrax/mcp-tiktokshop.git
cd mcp-tiktokshop
npm install
npm run build

设置

1.创建TikTok商店应用程序

  1. 首选 抖音小店合作伙伴中心
  2. 创建应用程序（自定义或公共）
  3. 设置您的重定向URL（您控制的任何HTTPS URL）
  4. 启用您需要的API作用域：
范围 必需
seller.order.info 订单
seller.authorization.info 店铺信息
seller.customer_service 对话（可能需要批准）
产品评论范围 评论（可能不适用于所有地区）

2.获取您的证书

运行交互式安装程序：

npm run auth

这将：

  1. 询问您的应用密钥和应用密码
  2. 打开TikTok授权页面
  3. 将代码交换为访问令牌
  4. 取回你的商店密码
  5. 将所有内容保存到 .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支持实时更新

许可证

麻省理工学院-见 许可证

相关 MCP