用途:管理 Shopee 店铺视频并分析其效果,覆盖 Shopee Open API Video 模块的 15 个接口。依赖 linkfox-shopee-store-auth 完成选店与授权,本技能不实现授权或令牌逻辑。
主要能力:视频 CRUD(get_cover_list、post_video、get_video_list、get_video_detail、edit_video_info、delete_video);整体效果(get_overview_performance、get_metric_trend、get_user_demographics、get_video_performance_list、get_prodcut_performance_list);单视频效果(get_video_detail_performance、get_video_detail_metric_trend、get_video_detail_audience_distribution、get_video_detail_product_performance)。另有通用入口 video_api.py。
使用方式:先运行 python scripts/check_auth_dependency.py,exit code 42 表示需先安装并授权 linkfox-shopee-store-auth。API 端点为 POST /shopee/developerProxy,通过请求体区分操作,传入 shopId 或 merchantId,由服务端解析 token 转发,path 须为 api/v2/video/...。脚本调用格式:python scripts/<脚本名>.py '<JSON 参数>' [--inline]。
输出策略:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json,禁止写入 /tmp;响应体 ≤ 8 KB 时打印完整 JSON,> 8 KB 时仅输出摘要,加 --inline 强制全量打印。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需抽取字段。
限制:会消耗算力,失败或空结果不得自动换关键词、翻页或连续试探,需继续检索应先向用户说明额外消耗。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。店铺授权、商品 listing、直播、视频文件上传分别属于其他技能。官方拼写为 get_prodcut_performance_list。本技能不消耗算力。