/api/creator/searchCreator Search
Search TikTok creators by fans, engagement, sales volume, categories and more.
creator_searchFind US beauty creators with 100k+ followers and sales volume over 100.
Expose TikTok creator, video, product and shop data to AI assistants through MCP tool calls — powered by KSS Open API.
Get an independent MCP Key with monthly or yearly billing. API Key and MCP Key are billed separately.
https://mcp.kolsprite.com/ssesecret-key: <your_mcp_key>https://open.kolsprite.comEach MCP tool maps to a KSS Open API endpoint. Use natural language in your AI client to search TikTok commerce data.
/api/creator/searchSearch TikTok creators by fans, engagement, sales volume, categories and more.
creator_searchFind US beauty creators with 100k+ followers and sales volume over 100.
/api/video/searchSearch shoppable TikTok videos by views, 30-day sales, publish date, linked shop or product.
video_searchSearch US skincare shoppable videos with 30-day sales above 500.
/api/product/searchSearch TikTok Shop products by price, sales, rating, category, fulfillment and logistics type.
product_searchFind US serums priced $10–50 with 30-day sales over 1000 and rating above 4.0.
/api/shop/searchSearch TikTok Shop stores by rating, sales, influencer count, product count and service metrics.
shop_searchFind US beauty shops rated 4.5+ with 30-day sales over 5000.
/api/creator/searchSearch TikTok creators by fans, engagement, sales volume, categories and more.
creator_searchFind US beauty creators with 100k+ followers and sales volume over 100.
After connecting, the kol service registers these tools for AI auto-invocation.
| Tool | Description | API Endpoint |
|---|---|---|
creator_search | Multi-dimensional TikTok creator search | /api/creator/search |
video_search | Video search and filtering | /api/video/search |
product_search | Product search and sales analysis | /api/product/search |
shop_search | Shop search and rating query | /api/shop/search |
MCP and API share the same data source but have independent rate limits. Default: 20 calls/minute per MCP Key, monthly quota by plan. Exceeding limits returns ERROR_API_MINUTE_MAX / ERROR_API_MONTH_MAX.
Standard mcpServers snippet for Cherry Studio, Claude Desktop, Cursor, Windsurf and other SSE-compatible clients.
{
"mcpServers": {
"kol": {
"url": "https://mcp.kolsprite.com/sse",
"type": "sse",
"headers": {
"secret-key": "<your_mcp_key>"
}
}
}
}Follow these steps to connect KOLSprite MCP in your AI client.
Contact your administrator to enable MCP access and obtain your secret-key. MCP and API billing/limits are independent.
Recommended: Cherry Studio, Claude Desktop, Cursor, Windsurf. Ensure the client supports SSE remote MCP servers.
Config location varies by client — e.g. ~/.cursor/mcp.json for Cursor, claude_desktop_config.json for Claude Desktop.
Merge the JSON above into your client config and replace secret-key with your MCP Key.
Save and restart, or click Refresh in MCP settings. When kol shows Connected, setup is complete.
Ask in natural language, e.g. "Find US beauty creators with 100k+ followers" — the model will call the matching tool automatically.