tiktok-shop-operator

TikTok Shop Operator

Use KSS MCP to turn natural-language TikTok Shop research requests into verified results and actionable operating plans.

Load References

1. Read references/mcp-tools.md before choosing tools, parameters, joins, or return fields.
2. Read references/workflows.md for operational or multi-step tasks.
3. Read references/output-templates.md before presenting results.
4. Read references/examples.md only when intent, pagination, missing-data, or error behavior is unclear.

Do not duplicate detailed tool schemas in this file.

Interpret the Request

1. Extract region, keyword/category, price, rating, sales, revenue, growth rate, date window, requested count, and sorting.
2. Preserve every explicit user condition.
3. Ask one concise question only when a missing condition blocks a valid query.
4. Use an MCP default only when valid, and disclose it in the query scope.
5. Identify whether the task needs one tool or a cross-tool workflow.

Choose Tools

• Use product_search for products, prices, ratings, sales, growth, shops, and product-level trend filters.
• Use shop_search for shops, service metrics, shop ratings, product counts, and shop-level sales.
• Use video_search for commerce videos, video sales, engagement, products, shops, and embedded creator data.
• Use creator_search for creator discovery and creator metrics.
• Use caption_extract for captions from a specific TikTok video URL.

Use IDs for joins. For video-to-creator enrichment, query by returned Handle/name with searchType=N, then confirm the returned creator ID against the video creator ID when available.

Execute Safely

1. Query the smallest useful scope first.
2. When the user requests “all,” paginate until there is no next page, the tool limit is reached, or quota/rate limiting stops collection.
3. Never call the first page “all results.”
4. Deduplicate paginated objects by their stable ID.
5. Apply the user's sort. If none is provided, sort the relevant returned sales amount descending.
6. Do not invent an orderField value absent from the reference. Sort locally within the disclosed collected scope when necessary.
7. Keep regions, currencies, and time windows separate.
8. Check the live tool schema or official examples before encoding a percentage growth filter; never guess whether 50% means 50 or 0.5.
9. Never invent fields, results, links, quota status, or successful tool calls.
10. Write missing fields as “未提供.”
11. Stop on 401, unavailable tools, ERROR_API_MINUTE_MAX, or ERROR_API_MONTH_MAX, and report completed versus remaining work.
12. Do not silently broaden filters after an empty result. Suggest one relaxation and wait for approval.