Install
openclaw skills install @linkfox-ai/linkfox-tiktok-video-productsTikTok 视频号可带货商品查询技能,经 /tiktokVideo/developerProxy 调用达人店铺商品搜索与橱窗/直播袋商品列表(Get Shop Products、Get Showcase Products)。依赖 linkfox-tiktok-video-auth 取得 ttsAccessToken。当用户提到 TikTok 达人店铺商品、搜索店铺商品、Get Shop Products、达人橱窗商品、showcase 商品、Get Showcase Products、可带货商品、视频挂车选品、可购物视频选品、查询达人可推广商品、TikTok 视频号商品列表 时触发。返回的 product_id 供 linkfox-tiktok-video 预检/发布可购物视频使用。**不含授权**(授权用 linkfox-tiktok-video-auth);**不含视频上传/发布**(用 linkfox-tiktok-video)。
openclaw skills install @linkfox-ai/linkfox-tiktok-video-products本 skill 负责 TikTok 视频上传模块下的商品选品能力:搜索达人绑定店铺商品、查询达人橱窗/直播袋商品,取得 product_id 供后续可购物视频挂车使用。
📌 前置依赖:
linkfox-tiktok-video-auth— 达人授权与accessToken(作为ttsAccessToken)。
📌 下游用途:返回商品中的
product_id用于linkfox-tiktok-video的precheck_shoppable_video(预检)与post_shoppable_video(发布)接口中的product_link_info.product_id。
python scripts/check_auth_dependency.py;exit code 42 → 先安装 linkfox-tiktok-video-auth 并完成达人授权。accountTokens(或用户传入 ttsAccessToken)→ developerProxy → 紫鸟 tiktok-proxy/creator → TikTok Open APIget_shop_products):搜索达人绑定店铺中的商品,支持关键词与排序get_showcase_products):列出达人橱窗或直播间带货袋中的商品product_id 用途:预检/发布可购物视频时作为 product_link_info.product_id,由 linkfox-tiktok-video skill 消费详见 references/api.md(含 developerProxy 入参/出参、查询参数枚举、分页与错误码)。
| 脚本 | 作用 |
|---|---|
check_auth_dependency.py | 检测是否已安装 linkfox-tiktok-video-auth |
products_api.py | 具名 API 入口:JSON 含 api 字段 |
get_shop_products.py | 搜索达人绑定店铺商品(affiliate_creator/202509/shop_products) |
get_showcase_products.py | 达人橱窗/直播袋商品(affiliate_creator/202405/showcases/products) |
共享模块:_tiktok_video_products_common.py、_products_endpoints.py、_products_api_runner.py。
linkfox-tiktok-video-auth:authorized_accounts.py 列出已授权视频号 → 用户选定 openIdopenId(runner 自动调 /tiktokVideo/accountTokens)get_shop_products.py 或 get_showcase_products.pyproduct_id,供 linkfox-tiktok-video 预检/发布使用按标题关键词搜索达人店铺中的可带货商品:
python scripts/get_shop_products.py '{"openId": "...", "title_keyword": "apple", "page_size": 20}'
或:
python scripts/products_api.py '{"api": "get_shop_products", "openId": "...", "page_size": 20}'
从返回商品列表中取 product_id,用于 linkfox-tiktok-video 的预检/发布。
# 橱窗商品(默认 origin=SHOWCASE)
python scripts/get_showcase_products.py '{"openId": "...", "page_size": 20}'
# 直播间带货袋
python scripts/get_showcase_products.py '{"openId": "...", "page_size": 20, "origin": "LIVE"}'
首次请求不传 page_token;若响应含 data.next_page_token,将其作为下一次请求的 page_token 继续拉取。详见 references/api.md。
ttsAccessToken。product_id。linkfox-tiktok-video-auth。/tiktokVideo/developerProxy;不可用于 /tiktokShop/*。linkfox-tiktok-video。response_io.py 落盘提取字段,避免上下文溢出。| 场景 | 应使用的 skill |
|---|---|
| 达人/视频号 授权、刷新令牌 | linkfox-tiktok-video-auth |
| 视频 上传 / 预检 / 发布 / 查状态 | linkfox-tiktok-video |
| TikTok Shop 小店 ERP 商品 | linkfox-tiktok-auth + 对应业务 skill |
| TikTok 选品 / 数据分析(非达人自有商品) | EchoTik 等 |
Feedback:
当出现以下任一情况时,自动通过 Feedback API 上报反馈:
按 references/api.md 中的规范调用 Feedback API,不要打断用户的主流程。
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.