BrandBAI TikTok 下载

把 TikTok 单条视频、图集、达人主页和关键词搜索结果整理为可去重、可回溯、可续跑的普通版交付。单作品可保存媒体、发布文案、基础数据和页面可返回的一级评论；主页和搜索批量先冻结选择范围，再逐项下载用户请求的素材。

先确认授权范围

只在 PolyForm Noncommercial License 1.0.0 允许的非商业范围内运行。企业内部使用、客户交付、收费服务、插件、SaaS、数据服务或其他预期商业用途，必须先通过 brandlaobai@163.com 取得 BrandBAI 书面商业授权。安装源码不等于取得 TikTok 数据授权或第三方作品版权。

路由任务

• work：明确单条视频或图集的发布文案、基础数据和所选素材，不采评论。
• comments：明确单作品的页面可见一级评论；回复只有在用户明确要求时实验采集。
• all：明确单作品或一组作品的素材、数据、一级评论、Excel 与可选 ZIP。
• batch：达人主页、关键词搜索或 BrandBAI 插件导出的 作品清单.xlsx／selection/v1 JSON；主页选择全部当前可见置顶加最近 N 条非置顶，搜索冻结指定标签页前 N 个可见结果，选择文件按稳定作品 ID 续跑。

支持的页面路由见 浏览器路线。正式运行前阅读 采集完成标准，交付前阅读 导出格式 与 平台字段。用户要求跨国家内容理解、中英双语文案或评论时，另读 翻译策略。

先选品牌业务预设

用户描述的是市场、达人、竞品、官宣或带货问题时，先读 品牌业务场景路由，再冻结具体下载范围。不要把业务问题直接变成分析结论。

Creative Center、TikTok One、Ads Manager 和 Seller／Affiliate Center 的指标属于官方发现或品牌授权经营数据。用户提供这些导出时保留来源并按作品、达人、商品和时间窗口交接；不得从公开播放、点赞或评论数推算受众、投放或成交结果。

免费能力与付费占位

首版免费能力包括：

• 视频 MP4、图集全部图片、封面、页面可用原声；
• 平台发布文案和话题，不把音频识别结果冒充发布文案；
• 播放、点赞、评论、收藏、分享等采集时点快照；
• 单作品一级评论、达人主页批量、搜索普通／视频／照片页批量；
• 断点续跑、去重、Excel、ZIP 和完整性状态。
• 读取 BrandBAI TikTok 插件导出的 作品清单，进入作品详情补齐所选素材并保留原始选择快照。

文本翻译不应一概归入付费能力：BrandBAI 下载助手 v0.9.0 在支持的 Chrome 桌面版中，可由用户主动生成发布文案、已采集一级评论和当前可见作品文案的中英双语 Excel。它使用浏览器内置语言识别与本机翻译，默认保留原文并补充中文和英文，不消耗云端字符额度；不支持或失败时不得静默回退到云端计费。

AI 语音转文案、画面 OCR、云端翻译回退和大批量加速仍需要推理服务与计量体系。未接入 BrandBAI 服务端前只显示“即将上线”，不得把第三方密钥写入公开插件，也不得静默调用付费接口。

遵守采集边界

• 只通过用户可见、正常登录的 Chrome 页面访问公开内容。
• 登录、验证码、访问确认或风险提示由用户手动完成。
• 不读取或导出 Cookie、请求头、浏览器资料夹、验证码、签名参数或访问令牌。
• 不绕过访问控制、签名、频率限制、地区限制或折叠规则。
• 资源链接只作为当次下载线索；带时效签名的 URL 不作为长期证据保存。
• 搜索“前 N 条”只对应指定关键词、标签页、筛选和采集时点的页面可见顺序。
• “全部评论”只表示页面继续返回并收到终止证据的全部可检索一级评论，不代表平台内部绝对全量。

准备环境

需要 Python 3.10+、Google Chrome、可交互桌面和网络连接：

python -m pip install -r requirements-browser.txt
python -m playwright install chromium

Chrome 私有资料夹必须放在仓库、同步盘和交付目录之外。任何正式采集先运行 --dry-run 核对范围。

常用任务

单视频或图集完整资料包

python scripts/run_foundation.py all `
  --work "<TikTok 视频或图集完整链接>" `
  --profile-dir "<私有Chrome资料夹>" `
  --out "<交付目录>" `
  --assets "media,cover,audio" `
  --comment-limit 0 `
  --zip `
  --dry-run

达人主页批量

python scripts/run_foundation.py batch `
  --profile "https://www.tiktok.com/@handle" `
  --recent 20 `
  --profile-dir "<私有Chrome资料夹>" `
  --out "<交付目录>" `
  --assets "media,cover" `
  --zip `
  --dry-run

置顶作品为额外项，不占最近 N 条非置顶名额。发现不足 N 条时保留 partial_selection_shortfall，不把短缺补成 0。

关键词搜索批量

python scripts/run_foundation.py batch `
  --search "skincare" `
  --search-tab photo `
  --search-limit 20 `
  --profile-dir "<私有Chrome资料夹>" `
  --out "<交付目录>" `
  --assets "media,cover" `
  --zip `
  --dry-run

search-tab 支持 general、video、photo。照片搜索也可批量，这是本 Skill 相比调研样本工具补足的场景。

从 BrandBAI 插件作品清单继续下载

python scripts/run_foundation.py batch `
  --selection-file "<BrandBAI_TikTok作品清单_YYYYMMDD.xlsx>" `
  --profile-dir "<私有Chrome资料夹>" `
  --out "<交付目录>" `
  --assets "media,cover,audio" `
  --zip `
  --dry-run

选择文件只保存作品 ID、规范链接、页面可见字段和选择范围，不包含 Cookie、请求头或临时签名资源地址。独立原声未提供时保留 not_provided，并说明对应 MP4 已保存时仍可播放视频内嵌声音；不得把 19/20 改写成 19/19。

品牌市场扫描时同时冻结业务上下文：

python scripts/run_foundation.py batch `
  --search "sensitive skin moisturizer" `
  --search-tab video `
  --search-limit 20 `
  --business-preset market-scan `
  --market-scope US `
  --source-locale en-US `
  --search-language en `
  --observation-timezone America/New_York `
  --downstream-use content-diagnosis `
  --profile-dir "<私有Chrome资料夹>" `
  --out "<交付目录>" `
  --dry-run

市场来自用户业务任务，不根据作者语言、IP 或外观自动猜测。多语言关键词分别运行并分别保存原始位次，不能合并后冒充平台排序。

普通版交付

按实际请求生成：

• 01_作品清单.xlsx
• 02_评论明细.xlsx：仅请求评论时生成
• 03_搜索快照.xlsx：仅搜索批量时生成
• 04_作品素材/
• 05_采集说明.md
• data/：原始规范记录、插件／文件选择快照、主页／搜索选择快照、完成状态和交付 manifest

增加 --zip 后生成 ZIP64 压缩包。ZIP 不得包含 Chrome 资料夹、Cookie、任务缓存、带时效签名的原始请求或 QA 文件。

完成状态与续跑

• 单作品内容与所选主要素材已保存或明确公开不可用：complete_visible_work。
• 主页所选作品已冻结并写入：complete_visible_pinned_plus_recent_n。
• 搜索前 N 个可见位次已冻结：complete_first_n_visible_results。
• 插件 Excel／selection JSON 的作品 ID 与顺序已冻结：complete_explicit_selection。
• 用户请求的素材中至少一项公开页面未提供：partial_asset_unavailable；与下载失败分开记录。
• 一级评论收到平台分页终止或可信页面末端证据：complete_source_visible。
• 达到正数上限、回复未完全展开、登录验证阻断、选择数量不足或页面定位变化，只能标记部分完成。
• 退出码 3 表示数据可保留和续跑，但不得对外写“完整下载”。

同一目标、同一范围和同一隐私模式可在原输出目录增加 --resume；目标、关键词、搜索标签页或范围改变时新建输出目录。

与后续分析分工

本 Skill 只采集和整理来源事实。达人深度分析、用户语义、商品匹配、传播机制与商业判断必须由后续 Skill 读取稳定作品 ID、搜索快照、原文和完整性状态后完成。

验证修改

在 scripts/ 目录运行：

python -m unittest test_collector_core.py test_selection_contract.py test_browser_collect_tiktok.py test_build_delivery.py test_run_foundation.py

测试只使用合成数据，不打开 TikTok、不启动 Chrome，也不产生付费请求。