youtube-batch-transcript-extractor-api-skill

This skill helps users automatically extract YouTube video transcripts and metadata in batch via the BrowserAct API. The Agent should proactively apply this...

📖 Introduction

This skill uses the BrowserAct YouTube Batch Transcript Extractor API template to provide users with an automated service for extracting YouTube video transcripts and metadata in batch. Simply by providing search keywords and filters, you can batch extract full video transcripts, likes, and channel metadata without writing crawler scripts.

✨ Features

1. No hallucinations, ensuring stable and accurate data extraction: Pre-set workflows avoid generative AI hallucinations.
2. No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
3. No IP access restrictions or geofencing: No need to deal with regional IP restrictions.
4. Faster execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
5. High cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of tokens.

🔑 API Key Guide Process

Before running, you must check the BROWSERACT_API_KEY environment variable. If it is not set, do not take any other actions; you should request and wait for the user to provide it collaboratively. The Agent must inform the user at this time:

"Since you have not yet configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key first."

🛠️ Input Parameters

When calling the script, the Agent should flexibly configure the following parameters based on user needs:

1. KeyWords

   • Type: string
   • Description: The keyword to search for on YouTube.
   • Example: OpenClaw, AI Automation

2. Upload_date

   • Type: string
   • Description: Filter for the upload date of the videos.
   • Optional values: Today, This week, This month, This year.
   • Default value: This week

3. Datelimit

   • Type: number
   • Description: The number of videos to extract. Adjust as needed.
   • Default value: 5
   • Recommendation: Set a smaller value (1-5) for quick tests and a larger value for bulk extraction.

🚀 Invocation Method (Recommended)

The Agent should execute the following independent script to achieve "one-line command to get results":

# Example invocation
python -u ./scripts/youtube_batch_transcript_extractor_api.py "keywords" "Upload_date" Datelimit

⏳ Execution Status Monitoring

Since this task involves automated browser operations, it may take a long time (several minutes). The script will continuously output timestamped status logs (e.g., [14:30:05] Task Status: running) while running. Agent Notes:

• While waiting for the script to return results, please keep an eye on the terminal output.
• As long as the terminal is still outputting new status logs, it means the task is running normally. Please do not mistakenly judge it as a deadlock or unresponsiveness.
• Only consider triggering the retry mechanism if the status remains unchanged for a long time or the script stops outputting without returning a result.

📊 Data Output Description

After successful execution, the script will parse and print the results directly from the API response. The results include:

• Video title: The title of the YouTube video.
• Video URL: The direct link to the original video.
• Publisher: The name of the channel publishing the video.
• Channel link: The URL of the publisher's YouTube channel.
• Video likes count: The number of likes the video has received.
• Subtitles: The complete extracted transcript/subtitles of the videos.

⚠️ Error Handling & Retry

If an error is encountered during the execution of the script (such as network fluctuation or task failure), the Agent should follow the logic below:

1. Check the output content:

   • If the output contains "Invalid authorization", it indicates that the API Key is invalid or expired. Do not retry at this time. You should guide the user to recheck and provide the correct API Key.
   • If the output does not contain "Invalid authorization" but the task execution fails (for example, the output starts with Error: or returns an empty result), the Agent should automatically try to execute the script once more.

2. Retry limits:

   • Automatic retry is limited to once. If the second attempt still fails, stop retrying and report the specific error message to the user.