qhkm TikTok Shop Skill
Manage products, orders, and inventory on TikTok Shop using the Open API v2.
Setup
- Register at TikTok Shop Partner Center
- Create an app and get App Key + App Secret
- 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}'
List Orders
PARAMS=$(tiktok_sign "/api/orders/search")
curl -s -X POST "https://open-api.tiktokglobalshop.com/api/orders/search?app_key=$TIKTOK_APP_KEY&access_token=$TIKTOK_ACCESS_TOKEN&$PARAMS" \
-H "Content-Type: application/json" \
-d '{"page_size": 20}' \
| jq '.data.order_list[] | {id: .order_id, status: .order_status, total: .payment_info.total_amount}'
Update Inventory
PARAMS=$(tiktok_sign "/api/products/stocks")
curl -s -X POST "https://open-api.tiktokglobalshop.com/api/products/stocks?app_key=$TIKTOK_APP_KEY&access_token=$TIKTOK_ACCESS_TOKEN&$PARAMS" \
-H "Content-Type: application/json" \
-d '{
"product_id": "PRODUCT_ID",
"skus": [{"id": "SKU_ID", "stock_infos": [{"warehouse_id": "WH_ID", "available_stock": 100}]}]
}' | jq '.code, .message'
Tips
- Signing is required for ALL API calls — use the helper function
- Access tokens expire — implement token refresh in production
- API base URL varies by region (global, US, UK, SEA)
- Rate limit: 10 requests/second per app
- Order statuses:
UNPAID,ON_HOLD,AWAITING_SHIPMENT,SHIPPED,COMPLETED,CANCELLED - Custom MCP server planned for
qhkm/zeptoclaw-searepo