微信视频号下载：按关键词批量下载视频号视频

这是什么组件

这是一个安装到线下白板里的微信视频号下载组件。

你输入账号名称和标题关键词，它会自动去拉取该账号的视频列表，筛出匹配内容，下载 .mp4 文件，并且在同目录写出对应的元数据 .json。执行完成后，结果会直接回到你的本地工作区。

它不是旧的脚本说明页，也不是一次性的命令行工具说明，而是一个真正可以从线上商店安装到线下客户端里的组件。

它解决什么问题

视频号本身没有很顺手的批量保存入口。

如果只是偶尔保存一条视频，手动操作还勉强能接受；但只要进入下面这些场景，手动方式就会明显拖慢：

• 想持续追某个账号的某类题材
• 想按关键词批量归档素材
• 想把视频下载到本地继续做分析、拆解和再创作

这个组件就是为这种“按账号 + 关键词批量拿素材”的工作流准备的。

安装后你会得到什么

安装完成后，线下白板里会出现一个新的组件入口：视频下载。

它默认提供这些输入项：

• 账号名称
• 标题关键词
• 最早发布日期
• 下载数量
• 本地保存目录

你不需要再手动拼命令，只要在卡片里填好内容，直接点开始下载就可以了。

需要什么本地配置

这个组件运行时依赖一个本地密钥：XHS_API_KEY。

如果你的线下宿主已经配置过这个 key，安装后就可以直接使用；如果没配置，组件会提示“待配置”，而不是假装运行成功。

下载完成后会输出什么

每条命中的视频会输出两类文件：

• 一个 .mp4 视频文件
• 一个同名 .json 元数据文件

同时还会额外生成一份本次任务的汇总文件：

• wxvideo_download_summary_<关键词>.json

这份汇总里会记录本次下载的关键词、输出目录、命中结果和文件位置，方便后续继续交给别的组件或 AI 做整理。

典型使用方式

如果你要抓一个账号里所有标题包含某个词的视频，可以这样理解这张卡的使用方式：

1. 填账号名称，比如 大湾区之声
2. 填关键词，比如 李家超
3. 需要限定时间就填“发布日期不早于”
4. 需要控制数量就设置 limit
5. 选择本地保存目录
6. 点击 开始下载

执行结束后，卡片会告诉你：

• 本次成功下载了几条
• 文件保存到了哪里
• 每条视频的标题和大小
• 汇总文件路径

适合接到什么流程后面

这个组件适合放在内容采集链路的前面。

比如：

• 先下载视频号素材
• 再把视频交给本地分析组件做拆解
• 再把结论写回白板或博客

它的定位不是“看文章”，而是“先把素材拿下来”。