公开社交账号分析

公开社交账号分析

仓库脚本擅长 B站和抖音的可复现采集，但不是唯一可用路径。先解决用户的问题；证据深度和交付形式只需足以支持答案。

Security model

这个 Skill 故意处理三类高敏感资产，默认全在内存、opt-in 才落盘、永不进入任务产物 / 报告 / 日志。发布前请把这一段当作给 ClawHub 审核员与终端用户的人工复核依据。

不采集的资产：私信 / 后台管理 / 粉丝画像 / 曝光 / 触达 / 完播 / 转化 / 私信等后台私有数据。Cookie 失败、OAuth 失败、签名失败都按已有证据保留并按真实覆盖结束，不会绕过平台登录墙、验证码、频控或访问限制。

打包产物（.skill 归档）仅含 SKILL.md、VERSION、agents/、scripts/、references/、assets/ 五项；evals/、tests/、docs/、tools/、workspace/ 一律不进 .skill。grep -rn 'evals/\|tests/\|docs/\|tools/\|workspace/' <解压后的 .skill> 应为空。scripts/analysis/ 是运行时分析引擎,跟入口脚本同级进入归档。

公开社交账号分析

仓库脚本擅长 B站和抖音的可复现采集，但不是唯一可用路径。先解决用户的问题；证据深度和交付形式只需足以支持答案。

核心决策流

1. 绑定账号 — 以 "平台 + 已核验账号 ID" 为研究边界；仅有昵称时先用第一方/公开搜索绑定，唯一强匹配可继续，有歧义列最少候选供用户确认；不拼造 UID/sec_uid/主页 URL。
   先在目标平台搜索昵称，命中唯一且主页作品与用户描述一致才视为绑定成功；多候选时输出候选列表让用户二次确认。
   Read when: 需要绑定账号但只有昵称/模糊线索时 → references/platforms/ 对应平台文件的「身份绑定」章节

2. 界定样本 — 用户已提供数据时先核验账号归属/时间范围/字段缺口；最近 N 条与日期窗口精确遵守；完整/全量需求时继续至可信末页（翻页到无新增或平台明确末页标记），未观察到明确末页时标 PARTIAL 并记录最后观察位置。
   采集前先用 collect.py --dry-run 估算规模；PARTIAL workspace 仍可分析但需在报告「证据范围」中说明覆盖边界。
   Read when: 采集范围含糊或用户要求「全量/最近 N 条」时 → references/artifact-contract.md §采集任务契约；references/workflow.md §2 样本界定与 PARTIAL 语义

3. 受限保留证据 — 依次尝试：另一公开入口（如移动端/分享页/搜索索引）、单条主页/分享链接兜底、缩小时间窗口、用户交接授权会话；遇 RATE_LIMITED/ACCESS_RESTRICTED/LOGIN_REQUIRED/VERIFICATION_REQUIRED 时，已采集资料标 PARTIAL 并记录：平台/停止原因/已验证范围/受影响结论；用户明确选择授权会话后才读 references/cookie-guide.md。
   降级优先级固定：公开入口切换 > 单条链接 > 窗口收窄 > 授权会话；每步都产出可审计的 PARTIAL 制品而非静默失败。
   Read when: 采集被拦截或需要降级策略时 → references/exceptions.md §1 停止原因映射；references/douyin-index-evidence.md 抖音公开索引降级

4. 给出可用结论 — 内容策略看主题/系列/形式/受众承诺；播放量表示触达，不与互动效率混排；互动效率 = (likes+comments+favorites+shares)/views（views>0 已知时），分母未知不计算、不补 0；节奏按规范化日期（UTC+8 对齐自然日），评论洞察聚类后必须绑定父作品 URL；数值来自规范化数据，未知保留 null 并在报告给出字段级覆盖率；先给用户能直接使用的判断，再交代最关键的证据范围和不确定性；实际顺序和篇幅由用户目标决定（仅看节奏可只输出节奏段）。
   Read when: 生成分析/报告时 → references/metrics-and-sampling.md 指标口径；references/model-insights.md 分类/高低表现；references/comment-insights.md 评论合同；references/collection-schema.md 规范化字段与 null 语义

平台路由表

版本与回退提示：各平台文件记录当前适配的接口版本与已知变更点；采集器遇保护响应会按平台文件定义的回退链自动尝试，最终仍受限则按决策流第 3 步产出 PARTIAL。

正式制品入口

选择原则：采集优先用 collect.py；B站/抖音追求完整分页用 *_complete.py；有授权 Token 用 collect_douyin_authorized.py；被拦截且有公开索引用 import_index_snapshot.py；分析只用 run_pipeline.py 这一条入口。

何时读取详细参考

下表按「当前要解决的问题」路由到对应参考文件；仅加载需要的模块，避免一次性读完所有 references。

Gotchas（Top 5 从 stdlib 实现常见坑）

• 签名/请求头不匹配导致静默拒绝 — 平台校验 web_location/User-Agent/压缩头等字段，缺失或错误直接返回拒绝码而非 4xx。
  Read when: 采集器收到非预期拒绝/空响应 → 对应 references/platforms/ 文件的「访问限制识别」或「第 3 层：平台保护停止策略」章节

• 空值处理不当污染指标 — 页面未展示/解析失败必须写 null 并记录字段级错误；禁止用 0/空字符串填充，否则互动效率/覆盖率失真。
  Read when: 规范化字段含 null 或需计算覆盖率 → references/collection-schema.md §字段空值契约；references/metrics-and-sampling.md §指标分母未知处理

• views 字段平台差异大 — 小红书服务端不返回、微博非官方端点无 views、抖音公开页可能缺失；互动效率分母未知时不计算、不补 0。
  Read when: 计算互动效率或对比跨平台指标 → references/metrics-and-sampling.md §公开互动效率合同；各平台文件的「字段可用性」表

• 身份绑定无开源解析器 — 无通用昵称→UID/sec_uid/red_id 解析器；必须要求用户给主页链接或已知 ID，不拼造、不猜测。
  Read when: 只有昵称/模糊标识启动分析时 → references/platforms/ 对应平台的「身份绑定」章节

• 不可变目录只写不改 — collection 与 analysis workspace 皆为 create-only；失败不覆盖不删除，续采需同平台同规范 URL 且 .complete + manifest.json 校验通过。
  Read when: 运行/续采/导入任务时 → references/workflow.md §1 不可变目录契约、§3 续采合同；references/artifact-contract.md §制品状态机

报告模板

按 PRD 定义的六大板块输出；字段定义见 PRD：内容策略=主题/系列/形式/受众承诺；节奏=频次/间隔/时间分布；互动效率=(likes+comments+favorites+shares)/views（views 未知不计算）；高低表现=Top/Bottom N 附作品 URL；评论洞察=聚类主题绑定父作品。

# [账号] 内容策略分析

## Executive summary
[核心判断一段话，先结论后证据范围]

## 内容定位与选题栏目
## 发布节奏
## 公开互动效率
## 高低表现分位
## 评论需求洞察
## 证据范围与不确定性