抖音主页主帖采集:从博主主页拉视频列表并导出 CSV

前言

要做达人筛选或竞品账号监测时,常见做法是人工打开博主主页、逐条翻视频、手抄点赞数和发布时间,再整理进表格。这条路的问题在于:视频量一多就翻不完,字段抄错几个没人发现,而且「最新一条」和「上一页最后一条」之间的时间断档很难察觉。

下面介绍 SkillHub 上的 @aidata/dy-profile(抖音主页主帖采集)。它把这件事变成一次调用:给一个抖音博主主页链接,返回该博主发布的视频作品列表,并导出为 Excel 可直接打开的 CSV。

这是什么

一个面向抖音主页视频列表的采集 Skill,由「海港信息」发布维护,坐标 @aidata/dy-profile,当前版本 1.0.1,来源标记为 enterprise,分类 data-analysis。

解决的问题很具体:拿到博主主页链接后,批量获取其视频的结构化字段,而不是只拿到主页上露出来的前几条。

核心功能

采集字段按官方简介列出如下:

  • 视频文案
  • 点赞数、评论数、收藏数、分享数、播放数
  • 作者昵称
  • 发布时间
  • 封面图
  • 视频链接

输出形式是 CSV,官方说明为「Excel 直开」,即不需要额外转换步骤。

链接格式支持两种:

  • douyin.com/user/<sec_uid> 形式的用户主页直链
  • v.douyin.com 形式的短链

后者意味着从 App 分享面板复制出来的链接可以直接投喂,不需要先解析重定向拿到真实地址。

点数与结算

这部分来自官方简介中的计费说明,属于使用前必须了解的成本规则:

1、一页约 20 条视频,计 5 点数。采集量按页累计,不是按条。
2、预扣按页数执行,结算按实际采到的量退差。
3、零结果或调用失败时全额返还。
4、新注册账号赠送 10 点,按上述单价相当于一次采集的额度,可用于先验证链路是否通。

因为存在退差机制,「预扣」不等于「实际扣费」,评估单次任务成本时以实采量为准。

安装与启用

这部分需要如实说明:截至撰写时,SkillHub 的 Skill 详情页(https://www.skillhub.cn/skills/aidata/dy-profile)与官方地址 https://api.skillhub.cn/aidata/dy-profile 均无法抓取到正文内容,已抓取资料中没有收录安装命令、Skill 存放目录或配置文件字段。

因此本文不给出安装命令。标签: requires_api_key=true 表明该 Skill 需要配置 API Key,具体在哪个配置项填、Key 从哪里获取,请在启用前到上述官方地址或 SkillHub 页面核对。 Cursor、Codex CLI、Claude Code 三种环境的启用方式差异,资料中没有对应说明,此处不写。

典型用法

官方资料同样没有提供可复现的调用示例,下面只整理输入侧的约定,实际调用参数以 Skill 内说明为准。

输入是博主主页链接,两种形式均可:

https://www.douyin.com/user/MS4wLjABAAAAv7iSuuXDJGDvJkmHrMbVTdPG2Tsb1NsSf2iQFW3bRyA
https://v.douyin.com/iRxxxxx/

返回是该博主发布的视频作品列表,字段见上一节。采集量按页推进,一页约 20 条,超过一页需要继续翻页。

导出结果写入 CSV 后可直接用 Excel 打开,无需改编码或另存。

适用场景与注意

适合这几类需求:

  • 达人筛选:先看候选达人主页更新频率和爆款分布,再决定是否合作。
  • 博主内容盘点:整理某账号一段时间内发布过的全部内容。
  • 竞品账号监测:定期拉取竞品主页,对比发布节奏和互动量变化。
  • KOL 背调:核实账号是否持续活跃、数据是否稳定。

限制和坑需要提前知道:

1、页面显示评分 100000、下载 28039 次、安装 0。安装数为 0 是异常信号,如果对生态验证度有要求,建议先用注册赠送的 10 点跑一次最小验证再批量使用。
2、采集的是公开主页上的视频列表。主页设置为私密、或视频已删除的情况,结果会少于实际发布量,这属于数据源本身的限制,不是采集遗漏。
3、主页内容会持续更新,同一份链接在不同时间调用会拿到不同结果,做跨账号对比时要保证各账号的采集时间窗接近。
4、CSV 是通用格式,多字节字符在不同工具链中可能有编码差异,若下游要自动入库,建议先确认编码处理。

小结

@aidata/dy-profile 的价值在于把「翻博主主页抄数据」变成一次结构化调用:支持直链和短链、字段覆盖互动数据与时间、导出 CSV 可直接用 Excel 处理,计费上预扣按页、结算按实采量退差,零结果全额返还,试错成本低。安装命令和调用示例在当前抓取的资料中缺失,启用前需到官方地址补齐核对。

官方地址:https://api.skillhub.cn/aidata/dy-profile
SkillHub 页面:https://www.skillhub.cn/skills/aidata/dy-profile

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye