YouTube Influencer Finder：油管红人采集软件，用Python爬取海外博主邮箱等信息

本文从技术角度介绍软件实现功能，最终得到什么结果，帮助用户理解工具。 参考项目：https://github.com/mashukui/youtube_user

1. 软件是做什么的

软件界面

这是一款 YouTube 博主（红人 / KOL）线索采集工具。你只需要告诉它「搜什么关键词、要哪个国家的博主、粉丝数在什么范围」，它就会自动：

1. 按关键词搜索 YouTube 视频；
2. 找到视频背后的博主频道；
3. 采集频道的粉丝数、视频数、总播放量、注册日期等数据；
4. 尽可能提取博主的邮箱和 Telegram / WhatsApp / Twitter(X) / Facebook / Instagram / TikTok 等联系方式；
5. 全部汇总成一个 CSV 表格，方便后续用 Excel 打开做筛选、做达人营销邀约。

典型用途：跨境电商找带货博主、MCN 机构找达人、品牌方做红人营销、外贸找潜在合作对象等。

2. 核心功能一览

3. 使用前准备

3.1 申请 YouTube Data API Key

软件本身不提供数据，需要自行申请 Google 的 YouTube Data API v3 密钥。

开通方法：手把手教你开通YouTube官方API接口(youtube data api v3)

3.2 配置 config_pub.json

在软件运行目录下有一个 config_pub.json 文件，格式如下：

{
  "wait_sec": 1,
  "youtube_api_keys": [
    "你的第1个key",
    "你的第2个key",
    "你的第3个key"
  ]
}

• youtube_api_keys：填入你的 API Key，可以填多个，用英文逗号分隔。当某个 Key 的每日额度用尽，软件会自动切到下一个。
• wait_sec：请求间隔（秒），最小值为 1，建议保持默认，避免请求过快被限流。

注意：这是 JSON 格式，最后一个 Key 后面不要多写逗号，Key 必须用英文双引号包起来。填错时软件会弹出具体的格式错误提示。

4. 操作步骤

1. 登录：启动软件后先输入账号密码登录（付费软件，需作者开通账号）。
2. 配置：确保 config_pub.json 已填好 API Key。
3. 填写搜索关键词（必填）：例如 beauty，多个用 | 分隔。
4. 填写国家或地区（选填）：例如 美国、United States 或 US，多个用 | 分隔；留空表示不限。
5. 设置粉丝数范围：例如最小值 10000、最大值 1000000；无需筛选就保留两个 0。
6. 选择补抓模式：
   • 不开启：只调 API，速度快，邮箱字段可能显示 Unknown(API限制)；
   • 开启：API 之外再访问频道 About 页补全联系方式，速度变慢但信息更全。
7. 设置前几页：每个关键词采集的页数，-1 为不限。
8. 点击 开始执行，在下方运行日志中实时查看采集进度。
9. 采集完成后会弹出提示，并生成结果 CSV 文件。

5. 界面说明

填写项

• 搜索关键词：必填，灰色提示文字，点击后自动清空。
• 国家或地区：选填，支持中英文国家名。
• 粉丝数范围：两个数字框，中间 ~ 分隔。
• 补抓模式：下拉框，二选一。
• 前几页：数字框，-1 代表不限。
• 运行日志：实时滚动显示「第几页第几条是否满足条件、已存入文件」等进度。
• 菜单栏（File）：About（版本历史）、使用协议、意见收集。

6. 输出结果字段说明

生成的 CSV 文件包含以下 22 列（Excel 可直接打开，中文不乱码）：

csv结果：（字段实在太多了，我分成2张图展示）

前半段：

前半部分字段

后半段：

后半部分字段

7. 常见问题（FAQ）

Q1：提示「未检测到 YouTube API Key」？

在 config_pub.json 的 youtube_api_keys 数组里填入 Key，注意 JSON 格式不要出错。

Q2：提示「所有 YouTube API Key 均不可用」？

说明所有 Key 的当日配额已用尽，或 Key 无效。可等待次日配额重置，或新增可用 Key。

Q3：国家填中文还是英文？

都可以，例如「美国」「United States」「US」均有效；不确定可参考 country.json 里的中英对照表。

Q4：为什么有的博主邮箱是空的？

很多博主不在简介里放邮箱；未开启补抓模式时也无法探测 About 页，这是正常现象。

Q5：macOS 怎么运行？

不要双击打开，按软件内附的《mac端运行方法.txt》中的链接操作（需在终端以命令方式运行）。

Q6：为什么采集速度较慢？

受 API 配额和请求间隔限制。开启补抓模式会进一步变慢，因为每个频道都要额外访问一次网页。

8. 使用协议与合规提示

• 软件仅授权用于合法的个人或商业用途，禁止用于任何违法活动（未经授权的数据采集、侵犯隐私等）。
• 采集到的数据需遵守当地数据保护法律和 YouTube 的服务条款。
• 软件的免责声明明确指出：因使用本软件产生的一切法律后果由使用者自行承担。

9. 演示视频

软件完整使用演示视频：【技术分享】youtube红人采集软件

END、 版权声明

油管红人采集软件由作者马哥python说本人研发并发布上线，为海外业务从业者提供便利使用。

过程中有任何技术沟通需求，可通过 GitHub Issue 或公号后台取得联系。