这是一项 TikTok 视频数据搜索与分析工具，面向跨境电商卖家和营销人员，用于发现表现优异的视频、对标内容策略，并评估视频层面的互动与销售归因。
用途：按地区检索 TikTok 视频列表，并结合多种条件筛选，输出互动指标、销量归因估算和视频元数据，帮助分析 TikTok 市场上的内容表现。
主要能力：
- 筛选条件：地区（必填）、创作者 userId、商品 productId、商品类目 productCategoryId、播放量范围、时长范围（秒）、发布时间范围（Unix 秒时间戳）、带货标记 salesFlag（0/1）、广告标记 isAd（0/1）、AI 视频标记 createdByAi（字符串 "true"/"false"）。
- 排序：videoSortField 取 1 表示按点赞，取 2 表示按发布时间，取 3 表示按播放量（默认）；sortType 取 0 表示升序，取 1 表示降序。
- 分页：pageNum 从 1 开始；pageSize 必须为 10 的倍数，最大 100；后端按每批 10 条抓取后合并结果。
- 返回字段：videoId、videoDesc、officialUrl、coverUrl、duration、宽高与分辨率、文件大小、createDate，创作者 ID 与头像，播放/点赞（含 1d/7d/30d 分项）、评论、分享、收藏，视频销量与 GMV，带货/广告/AI 标记，商品类目与关联商品，地区及来源信息。
- 支持市场：US、ID、TH、PH、MY、VN、GB、MX、SG、SA、BR、ES、JP、DE、IT、FR；用户未指定时可询问或默认 US。
使用方式：
- API 端点：POST /echotik/listVideo。
- Python 脚本：python scripts/tiktok_video_search.py '<JSON 参数>' [--inline]。
- 认证：设置 NEXSCOPE_API_KEY，可在 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 管理积分。
- 输出策略：完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-echotik-list-video-<timestamp>.json（session 取自 SESSION_ID 环境变量）；响应不超过 8 KB 时在写入磁盘后向 stdout 打印完整 JSON，超过 8 KB 时仅输出摘要；加 --inline 可强制完整输出并仍写盘。建议先用摘要判断，再用 jq 或 ConvertFrom-Json 按需提取字段。
- 成本约束：工具消耗积分；同一会话中相同参数组合默认只调用一次，脚本本地缓存 24 小时；失败或空结果时不要自动更换关键词、翻页或筛选条件重试，追加查询前应先告知用户。
适用场景示例：按播放量查看各地区热门视频；筛选带货视频并按播放量或销量排序；查看某创作者视频；结合播放量与时间范围找近期高播放视频；查看近期 AI 视频；筛选广告视频等。展示时建议用表格列出描述、播放、点赞、评论、分享、销量、GMV、发布日期与创作者 ID，附 officialUrl 与封面链接，将时长转为可读格式，并提示销量与 GMV 为估算值。
限制：region 必填且 API 不提供默认值；pageSize 须为 10 的倍数；createdByAi 须为字符串；时间范围为 Unix 秒；productId、productCategoryId、userId 为内部 ID，需从既有结果获取；结果为实时查询，不落库，不支持二次 SQL 处理；查询单个特定商品的视频应改用 product video 技能；不覆盖商品搜索/榜单、达人资料分析、直播数据、视频下载地址解析及非 TikTok 平台数据。