YouTube Influencer Finder API Skill
📖 Brief
This skill provides a one-stop YouTube influencer data extraction service using the BrowserAct YouTube Influencer Finder API template. It directly extracts structured creator profile data from YouTube search results, including contact details, social links, and channel statistics. Just input search keywords and an upload date filter to get clean, usable influencer data.
✨ Features
- 1. No hallucinations, ensuring stable and accurate data extraction: Pre-set workflows avoid generative AI hallucinations.
- No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
- No IP restrictions or geo-blocking: No need to deal with regional IP limits.
- Faster execution: Tasks execute faster compared to purely AI-driven browser automation solutions.
- Extremely high cost-efficiency: Significantly reduces data acquisition costs compared to AI solutions that consume massive amounts of tokens.
🔑 API Key Guide
Before running, you must check the
BROWSERACT_API_KEY environment variable. If it is not set, do not take other actions first; you should ask and wait for the user to provide it.
Agent must inform the user:
"Since you haven't configured the BrowserAct API Key yet, please go to the BrowserAct Console to get your Key."
🛠️ Input Parameters
When calling the script, the Agent should flexibly configure the following parameters based on user needs:
- 1. keywords
-
Type:
string
-
Description: Search keywords for finding YouTube influencers. Can be any keyword.
-
Example:
openclaw,
tech reviewer,
gaming
-
Default: INLINECODE5
- 2. Upload_Date
-
Type:
string
-
Description: Filter creators by their recent upload date.
-
Options:
-
Today
-
This Week
-
This Month
-
This Year
-
Default: INLINECODE11
🚀 Invocation Method (Recommended)
The Agent should execute the following independent script to achieve "one command gets results":
CODEBLOCK0
⏳ Running Status Monitoring
Since this task involves automated browser operations, it may take a long time (several minutes). The script will
continuously output status logs with timestamps while running (e.g.,
[14:30:05] Task Status: running).
Agent guidelines:
- - While waiting for the script to return results, please keep an eye on the terminal output.
- As long as the terminal continues to output new status logs, it means the task is running normally. Do not misjudge it as a deadlock or unresponsiveness.
- If the status remains unchanged for a long time or the script stops outputting without returning a result, only then consider triggering the retry mechanism.
📊 Data Output
After successful execution, the script will parse and print the results directly from the API response. The results include:
- -
total_views: Total channel views - INLINECODE14 : Total number of videos
- INLINECODE15 : Total subscriber count
- INLINECODE16 : Channel registration date
- INLINECODE17 : Creator's country/region
- INLINECODE18 : Direct link to YouTube channel
- INLINECODE19 : Contact email if available
- INLINECODE20 : All visible social links (Platform: URL format, multiple links separated by line breaks)
- INLINECODE21 : Channel description and bio
- INLINECODE22 : Creator's channel name
⚠️ Error Handling & Retry
During script execution, if errors occur (such as network fluctuations or task failure), the Agent should follow this logic:
- 1. Check the output content:
- If the output
contains "Invalid authorization", it means the API Key is invalid or expired. At this point,
do not retry, but guide the user to recheck and provide the correct API Key.
- If the output
does not contain "Invalid authorization" but the task fails (for example, the output starts with
Error: or returns an empty result), the Agent should
automatically try to run the script once more.
- 2. Retry limit:
- Automatic retry is limited to
once. If the second attempt still fails, stop retrying and report the specific error message to the user.
YouTube 网红查找器 API 技能
📖 简介
本技能利用 BrowserAct YouTube 网红查找器 API 模板,提供一站式 YouTube 网红数据提取服务。它直接从 YouTube 搜索结果中提取结构化的创作者资料数据,包括联系方式、社交链接和频道统计数据。只需输入搜索关键词和上传日期筛选条件,即可获得干净可用的网红数据。
✨ 功能特点
- 1. 无幻觉,确保数据提取稳定准确:预设工作流程避免了生成式 AI 的幻觉问题。
- 无验证码问题:无需处理 reCAPTCHA 或其他验证挑战。
- 无 IP 限制或地域封锁:无需应对区域 IP 限制。
- 执行速度更快:相比纯 AI 驱动的浏览器自动化方案,任务执行速度更快。
- 极高的成本效益:相比消耗大量 token 的 AI 方案,显著降低数据获取成本。
🔑 API 密钥指南
运行前,必须检查 BROWSERACT
APIKEY 环境变量。如果未设置,请勿执行其他操作,应先询问并等待用户提供。
代理必须告知用户:
由于您尚未配置 BrowserAct API 密钥,请前往 BrowserAct 控制台 获取您的密钥。
🛠️ 输入参数
调用脚本时,代理应根据用户需求灵活配置以下参数:
- 1. 关键词
-
类型:字符串
-
描述:用于查找 YouTube 网红的搜索关键词。可以是任意关键词。
-
示例:openclaw、科技评测、游戏
-
默认值:openclaw
- 2. 上传日期
-
类型:字符串
-
描述:根据创作者最近的上传日期进行筛选。
-
选项:
- 今天
- 本周
- 本月
- 今年
-
默认值:本月
🚀 调用方式(推荐)
代理应执行以下独立脚本,实现一键获取结果:
bash
示例调用
python -u ./scripts/youtube
influencerfinder_api.py 关键词 上传日期
⏳ 运行状态监控
由于此任务涉及自动化浏览器操作,可能需要较长时间(数分钟)。脚本在运行时会
持续输出带时间戳的状态日志(例如 [14:30:05] 任务状态:运行中)。
代理指南:
- - 在等待脚本返回结果期间,请密切关注终端输出。
- 只要终端持续输出新的状态日志,即表示任务正常运行。请勿误判为死锁或无响应。
- 如果状态长时间未变化,或脚本停止输出且未返回结果,再考虑触发重试机制。
📊 数据输出
执行成功后,脚本将直接从 API 响应中解析并打印结果。结果包括:
- - 总观看量:频道总观看次数
- 视频数量:视频总数
- 订阅者数量:订阅者总数
- 注册日期:频道注册日期
- 国家/地区:创作者所在国家/地区
- YouTube 频道:YouTube 频道的直接链接
- 联系邮箱:可用的联系邮箱(如有)
- 链接:所有可见的社交链接(平台:URL 格式,多个链接以换行符分隔)
- 个人简介:频道描述和个人介绍
- 个人资料名称:创作者的频道名称
⚠️ 错误处理与重试
脚本执行过程中,如果发生错误(如网络波动或任务失败),代理应遵循以下逻辑:
- 1. 检查输出内容:
- 如果输出
包含 无效授权,则表示 API 密钥无效或已过期。此时
不要重试,而是引导用户重新检查并提供正确的 API 密钥。
- 如果输出
不包含 无效授权 但任务失败(例如,输出以 错误: 开头或返回空结果),代理应
自动尝试再次运行脚本。
- 2. 重试限制:
- 自动重试仅限
一次。如果第二次尝试仍然失败,则停止重试,并向用户报告具体的错误信息。