{"name":"io.github.Buer2333/tiktok-shop-mcp","slug":"buer2333-tiktok-shop-mcp","title":"TikTok Shop","description":"Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.","url":"https://mcp.market/server/buer2333-tiktok-shop-mcp","rating":null,"grade":"A","score":92,"certified":false,"status":"active","category":"ecommerce","tags":["ecommerce","finance"],"presence":{"score":34,"stars":7,"forks":2,"downloads_week":108,"last_push_at":"2026-10-19T03:16:07.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"pypi","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Buer2333/tiktok-shop-mcp","website":null,"version":"0.3.0","remotes":[],"packages":[{"registryType":"pypi","registryBaseUrl":"https://pypi.org","identifier":"tiktok-shop-mcp","version":"0.3.0","runtimeHint":"uvx","transport":{"type":"stdio"},"environmentVariables":[{"description":"Path to shops.json (default ~/.config/tiktok-mcp/shops.json)","format":"filepath","name":"TIKTOK_SHOP_CONFIG"},{"description":"Shop used by the bestselling tools when seller_name is omitted","format":"string","name":"TIKTOK_SHOP_BESTSELLERS_SHOP"}]}],"tools":[{"name":"get_account_video_gmv_tool","description":"Auto-paginate all shop videos and aggregate GMV by account username. Pass usernames as comma-separated string (e.g. 'dr.elise,dr.camila') to filter specific accounts. Returns per-account totals: gmv, orders, items_sold, video count.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_creators_bestselling_tool","description":"Platform-wide TOP 100 bestselling creators (requires Bestsellers scope).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_customer_service_performance_tool","description":"Get shop customer-service performance (after-sales handling time, IM dissatisfaction rate, etc.) over a custom date window.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_order_detail_tool","description":"Get detailed information for specific TikTok Shop orders (max 50 IDs). Use seller_name to specify which shop.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_product_detail_tool","description":"Get detailed product info including SKU prices. Use seller_name to specify which shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_product_performance_tool","description":"Get single product performance with VIDEO/LIVE/PRODUCT_CARD breakdown. Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_products_bestselling_tool","description":"Platform-wide TOP 100 bestselling products (requires Bestsellers scope).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_orders_tool","description":"Search TikTok Shop orders. Use seller_name to specify which shop (partial match OK, e.g. 'US' matches 'My Brand US').","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_performance_hourly_tool","description":"Get shop performance by hour for a specific date (YYYY-MM-DD). Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_performance_tool","description":"Get shop-level sales performance (GMV, orders, customers) with VIDEO/LIVE/PRODUCT_CARD breakdown. Dates are YYYY-MM-DD. granularity: 'ALL' (aggregate) or '1D' (daily). Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_products_performance_tool","description":"Get performance ranking for all products (GMV, orders, items_sold). Sort by gmv/items_sold/orders. Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_products_tool","description":"Get TikTok Shop product listings. Use seller_name to specify which shop (partial match OK).","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_statements_tool","description":"Get TikTok Shop financial statements (daily settlement records). Use seller_name to specify which shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_transactions_tool","description":"Get transaction details for a specific order or statement. Provide exactly one of order_id or statement_id. Use seller_name to specify which shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_shop_videos_performance_tool","description":"Get performance ranking for all videos driving shop sales (GMV, views, click-through). account_type: ALL/SELF/AFFILIATE. Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sku_performance_tool","description":"Get single SKU performance. Use seller_name to specify shop.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_videos_bestselling_tool","description":"Platform-wide TOP 100 bestselling videos (requires Bestsellers scope).","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_shops_tool","description":"List all configured TikTok Shop accounts with their names and token expiry dates.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refresh_all_tokens_tool","description":"Refresh access tokens for ALL configured shops. Useful for batch renewal before expiry.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refresh_token_tool","description":"Refresh the TikTok Shop access token for a specific shop. Call when you get a 401/token expired error. New tokens are auto-saved to shops.json.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_cancellations_tool","description":"Search cancelled orders with refund amounts and cancel reasons. Use start_date/end_date (YYYY-MM-DD) or raw timestamps.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_returns_tool","description":"Search return/refund orders with refund amounts. Use start_date/end_date (YYYY-MM-DD) or raw timestamps.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":92,"grade":"A","scanned_at":"2026-10-27T18:18:03.243Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-27T18:18:03.178Z","components":{"code":{"score":25,"max":25,"notes":["16 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":15,"max":15,"notes":["last push 9 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"pypi","identifier":"tiktok-shop-mcp","version":"0.3.0","found":true,"weeklyDownloads":108,"license":"MIT","dependencyCount":8,"publishedAt":"2026-10-19T03:16:51.587401Z","repositoryUrl":"https://github.com/Buer2333/tiktok-shop-mcp"}],"repo":{"found":true,"owner":"Buer2333","repo":"tiktok-shop-mcp","archived":false,"pushedAt":"2026-10-19T03:16:07Z","stars":7,"forks":2,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/13869438?v=4","ownerCreatedAt":"2015-08-19T12:33:09Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/13869438?v=4&s=128","source":"github"},"presence":{"stars":7,"forks":2,"downloadsWeek":108,"license":"MIT","lastPushAt":"2026-10-19T03:16:07.000Z","score":34}}}},"grade_history":[],"reviews":[]}