概览
输入一个商品、品牌或品类关键词,获取 TikTok Shop 中匹配的公开商品记录,帮助选品、竞品观察和市场研究快速建立商品清单。
数据说明
每次任务搜索一个关键词,并按你设置的期望数量采集商品。结果包含商品标题、价格、品牌、店铺、销量、评价数量、排名和商品图片等信息,同时保留搜索关键词与采集时间。
结果长什么样
| 商品编号 | 商品标题 | 价格 | 店铺名称 | 销量 | 搜索排名 |
|---|---|---|---|---|---|
| 1729435358486827693 | Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | 41.54 | Micro Ingredients | 23284 | 0 |
应用场景
- 通过品牌词或品类词发现 TikTok Shop 在售商品
- 对比不同店铺的商品价格、销量和评价规模
- 为选品、竞品跟踪和市场研究整理结构化商品底表
适用边界
每次任务支持 1 个搜索关键词,期望采集数量为 1–300 条;结果按每页 30 条、最多 10 页获取,覆盖 TikTok Shop 公开搜索商品。
- 适合用于
- 需要按品牌、产品或品类关键词发现 TikTok Shop 商品时
- 需要比较商品标题、价格、店铺和销量等公开信息时
- 不要用于
- 需要商品详情页的完整规格或订单数据时
- 需要即时单条查询而不是后台采集任务时
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1没有结果时,尝试缩短关键词或改用更宽泛的品类词后重新提交
- 2任务部分成功时保留已返回记录;失败或过期后可重新提交
- 3遇到限流、服务暂不可用或超时可稍后重试;鉴权失败需检查执行环境中的 API Key
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 搜索关键词
keyword必填string要在 TikTok Shop 搜索的品牌、商品或品类词,一次任务只支持一个关键词,长度为 1–512 个字符。示例milk - 期望采集数量
crawl_count必填string本次任务期望采集的商品记录数,范围为 1–300 条;结果按每页 30 条获取,最多拉取 10 页。示例1
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 业务标识
biz_idstring结果记录中的业务标识;无值时为空。示例milk - 品牌名称
brand_namestring商品品牌名称;无值时为空。示例Micro Ingredients - 采集时间戳
collect_timestring记录采集时间的毫秒时间戳字符串;无值时为空。示例1789121807761 - 采集时间
crawl_timestring记录采集时间,接口未声明时区;无值时为空。示例2026-09-11T18:16:47
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"biz_id": "milk",
"brand_name": "Micro Ingredients",
"collect_time": "1789121807761",
"crawl_time": "2026-09-11T18:16:47",
"created_at": "1789121807761",
"image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp",
"keyword": "milk",
"page_num": "1",
"platform_code": "tiktokShop",
"price": "41.54",
"product_id": "1729435358486827693",
"product_title": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA",
"rank_index": 0,
"rating_count": "3185",
"sale_count": "23284",
"shop_id": "7494949083499694765",
"shop_name": "Micro Ingredients",
"status_code": "<status_code>",
"task_meta_item": "milk",
"task_meta_no_data": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 30 条为一个计费单位,不足 30 条按 30 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。