skills/marketing-growth/tiktok-shop-integration/SKILL.md
Sync your product catalog to TikTok Shop, manage orders and inventory, and enable shoppable content with live shopping and affiliate creator programs
npx skillsauth add finsilabs/awesome-ecommerce-skills tiktok-shop-integrationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
TikTok Shop transforms TikTok from a discovery channel into a direct commerce platform where users purchase without leaving the app — via shoppable video posts, LIVE shopping events, product showcase tabs, and creator affiliate programs. For Shopify and WooCommerce, official TikTok integrations handle catalog sync, order management, and inventory updates automatically. The strategic work is applying to TikTok Seller Center, structuring your affiliate program, and running LIVE shopping events.
Before any integration:
seller.tiktokshop.com and create a seller accountNote: TikTok Shop is currently available in the US, UK, Southeast Asia, and select other markets. Availability changes — check TikTok's current supported markets before starting.
Use the TikTok Shop API directly for custom catalog management and order handling:
const TIKTOK_SHOP_BASE = 'https://open-api.tiktokglobalshop.com';
async function syncProductToTikTokShop(product: Product) {
// TikTok Shop API requires HMAC-SHA256 request signing
const timestamp = Math.floor(Date.now() / 1000).toString();
const body = {
title: product.name.substring(0, 255),
description: product.description.replace(/<[^>]*>/g, '').substring(0, 5000),
category_id: product.tikTokCategoryId, // find IDs in TikTok Seller Center → Products → Categories
images: product.images.map(img => ({ url: img.url })),
skus: product.variants.map(v => ({
sales_attributes: v.options.map(opt => ({ attribute_name: opt.name, value_name: opt.value })),
stock_infos: [{ available_stock: v.stockQuantity, warehouse_id: process.env.TIKTOK_WAREHOUSE_ID }],
seller_sku: v.sku,
original_price: v.price.toFixed(2),
})),
};
return tiktokShopRequest('/api/products', body);
}
// Handle TikTok Shop order webhooks
// POST /webhooks/tiktok-shop
export async function handleTikTokShopWebhook(req: Request, res: Response) {
const { type, data } = req.body;
if (type === 'ORDER_STATUS_CHANGE') {
// Sync TikTok order to your OMS
await syncTikTokOrder(data.order_id, data.order_status);
}
res.json({ code: 0 }); // TikTok requires this exact response format
}
After catalog sync, optimize each product for TikTok Shop:
Product images:
Product titles:
Shipping:
TikTok Shop's Open Collaboration model lets any creator discover your products and tag them in content for a commission — no prior relationship needed.
For targeted partnerships:
LIVE Shopping events drive high-urgency sales with real-time product featuring:
Before going live:
During the LIVE:
Best times for LIVE Shopping events: Tuesday, Wednesday, or Thursday evenings (7–9pm EST for US audience). Consistent scheduling builds a returning audience.
TikTok requires fulfillment within 2 business days of order confirmation. Late shipments damage your seller rating.
Fulfillment process:
Returns:
| Problem | Solution | |---------|----------| | Products stuck "Under Review" | Ensure product images are on white/clean backgrounds with no text overlays; prohibited categories (alcohol, certain supplements) require special approval | | TikTok orders not appearing in Shopify | Disconnect and reconnect the TikTok for Shopify channel; check that Seller Center is linked to the correct TikTok Business account | | Affiliate creators posting incorrect prices | Any price changes require creator content to be re-tagged; notify active affiliates before changing prices | | LIVE Shopping products not showing on stream | Products must be "Active" status before going LIVE; review takes 24–48 hours, so activate products in advance | | High return rate | TikTok buyers expect products to match the video exactly; avoid over-editing product images and ensure LIVE demos are accurate |
tools
Let shoppers save products to a wishlist, share it with friends, and get notified when saved items come back in stock or drop in price
development
Build a themeable storefront with design tokens and CSS custom properties that supports white-labeling, multi-brand variants, and dark mode
development
Speed up product discovery with instant search suggestions, fuzzy typo matching, and category-aware results powered by Algolia or Elasticsearch
development
Build a mobile-first storefront with thumb-friendly navigation, sticky add-to-cart buttons, and touch-optimized components for high mobile conversion