KOL 达人画像快照

要解决的问题

手动统计 KOL 主页数据时，常见的问题有三类：一是要逐个点开创作者主页抄写粉丝数、关注数、获赞数，多人对比时容易抄错或漏项；二是平台展示的值往往是缩写形式，例如 1.2万，需要自己换算，换算过程中还可能引入误差；三是不同平台的字段命名不一致，post_count 与 note_count 指向的内容类型可能并不相同，跨平台比较时容易得出错误结论。此外，账号数据是随时间变化的，昨天抓的快照和今天看到的数字可能已经不一致。

工作原理

该技能把「抓一次公开主页、存一份结构化快照」这件事封装成一个可重复调用的命令行流程。

核心能力包括：

• 每次调用只接收一个公开的主页 URL，通过 scripts/generate.js 抓取一次快照，URL 必须指向 profile 页而不是单条帖子或搜索结果页
• 原始值不做任何加工：缩写的计数不换算、指标不取整、字段不合并，缺失的值也不会被写成 0
• data 字段保留平台原始响应，本地化字段仅用于展示，两者的 key 互不覆盖
• 结果写入任务目录的 kol-profile.json，附带 sourceUrl、platform、timestamp、missingCoreFields 与 warnings，便于追溯
• --lang 控制展示标签语言（auto/zh/en/ja），--timeout 与 --retries 控制请求的超时与重试行为

调用流程大致是：确认目标 URL 指向的是公开 profile 页，传入 --json 与显式的 --output-dir 执行抓取，检查返回中的 missingCoreFields 和 warnings 判断快照是否完整，最后把结果呈现给用户时附上检测到的平台、来源链接以及缺失字段的提示。

适用边界

这份快照只是某个时间点的截面，它不能证明账号归属、身份真实性、受众质量或某位达人是否适合某次投放。需要得出这类结论时，应结合内容分析与互动数据另行评估。

使用时需要注意：

• 仅支持公开账号，不能用于访问私密账号、绕过认证、识别匿名个人或推断敏感特征
• 粉丝数、关注数、获赞数在抓取后可能继续变化，引用时应标注快照时间
• 同名指标在不同平台的含义可能不同，跨平台对比前需要先说明各自的平台上下文
• 账号被封禁、平台拦截访问或 profile 不存在时，应如实报告限制，而不是用近似数据替代
• 失败时仅在 error.retryable 为真时重试，且不超过 CLI 的重试上限