tiktok-shop

name	tiktok-shop
version	1.0.0
description	Manage TikTok Shop products, orders, and inventory via the Open API v2.
author	ZeptoClaw
license	MIT
tags	["tiktok","ecommerce","sea","marketplace"]
env_needed	[{"name":"TIKTOK_APP_KEY","description":"App Key from TikTok Shop Partner Center","required":true},{"name":"TIKTOK_APP_SECRET","description":"App Secret from TikTok Shop Partner Center","required":true},{"name":"TIKTOK_ACCESS_TOKEN","description":"Shop access token (from OAuth flow)","required":true}]
metadata	{"zeptoclaw":{"emoji":"🎵","requires":{"anyBins":["curl","jq","openssl"]}}}

TikTok Shop Skill

Manage products, orders, and inventory on TikTok Shop using the Open API v2.

Setup

1. Register at TikTok Shop Partner Center
2. Create an app and get App Key + App Secret
3. Complete OAuth flow to get an access token for the target shop

export TIKTOK_APP_KEY="your_app_key"
export TIKTOK_APP_SECRET="your_app_secret"
export TIKTOK_ACCESS_TOKEN="your_access_token"

Signing Requests

TikTok Shop uses HMAC-SHA256 request signing. Helper function:

tiktok_sign() {
  local path="$1" timestamp=$(date +%s)
  local sign_str="${TIKTOK_APP_SECRET}${path}${timestamp}${TIKTOK_APP_SECRET}"
  local sign=$(echo -n "$sign_str" | openssl dgst -sha256 -hmac "$TIKTOK_APP_SECRET" | awk '{print $2}')
  echo "timestamp=$timestamp&sign=$sign"
}

List Products

PARAMS=$(tiktok_sign "/api/products/search")
curl -s -X POST "https://open-api.tiktokglobalshop.com/api/products/search?app_key=$TIKTOK_APP_KEY&access_token=$TIKTOK_ACCESS_TOKEN&$PARAMS" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 20}' \
  | jq '.data.products[] | {id, name: .product_name, status: .product_status}'