felo-youtube-subtitling
Fetch YouTube video subtitles/captions using Felo YouTube Subtitling API. Use when users ask to get YouTube subtitles, extract captions from a video, fetch transcript by video ID or URL, or when explicit commands like /felo-youtube-subtitling are used. Supports language and optional timestamps.
How do I install this agent skill?
npx skills add https://github.com/felo-inc/felo-skills --skill felo-youtube-subtitlingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is generally safe for use. A low-severity risk of indirect prompt injection was identified because the skill fetches and processes untrusted external content (YouTube subtitles) without explicit boundary markers or sanitization.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1/3 files flagged
What does this agent skill do?
Felo YouTube Subtitling Skill
When to Use
Trigger this skill when the user wants to:
- Get subtitles or captions from a YouTube video
- Extract transcript by video ID or video URL
- Fetch subtitles in a specific language (e.g. en, zh-CN)
- Get subtitles with timestamps for analysis or translation
Trigger keywords (examples):
- YouTube subtitles, get captions, video transcript, extract subtitles, YouTube 字幕
- Explicit:
/felo-youtube-subtitling, "use felo youtube subtitling"
Do NOT use for:
- Real-time search (use
felo-search) - Web page content (use
felo-web-fetch) - Generating slides (use
felo-slides)
Setup
1. Get API key
- Visit felo.ai
- Open Settings -> API Keys
- Create and copy your API key
2. Configure environment variable
Linux/macOS:
export FELO_API_KEY="your-api-key-here"
Windows PowerShell:
$env:FELO_API_KEY="your-api-key-here"
How to Execute
Option A: Use the bundled script or packaged CLI
Script (from repo):
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "dQw4w9WgXcQ" [options]
Packaged CLI (after npm install -g felo-ai):
felo youtube-subtitling -v "dQw4w9WgXcQ" [options]
# Short forms: -v (video-code), -l (language), -j (json)
Options:
| Option | Default | Description |
|---|---|---|
--video-code / -v | (required) | YouTube video URL or video ID (e.g. https://youtube.com/watch?v=ID or dQw4w9WgXcQ) |
--language / -l | - | Subtitle language code (e.g. en, zh-CN) |
--with-time | false | Include start/duration timestamps in each segment |
--json / -j | false | Print full API response as JSON |
You can pass either a full YouTube link or the 11-character video ID:
- Supported URLs:
https://www.youtube.com/watch?v=ID,https://youtu.be/ID,https://youtube.com/embed/ID - Or plain ID:
dQw4w9WgXcQ
Examples:
# With video URL
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
felo youtube-subtitling -v "https://youtu.be/dQw4w9WgXcQ"
# With video ID
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --language zh-CN
# With timestamps
node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs -v "dQw4w9WgXcQ" --with-time --json
Option B: Call API with curl
curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
-H "Authorization: Bearer $FELO_API_KEY"
API Reference (summary)
- Endpoint:
GET /v2/youtube/subtitling - Base URL:
https://openapi.felo.ai. Override withFELO_API_BASEenv if needed. - Auth:
Authorization: Bearer YOUR_API_KEY
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| video_code | string | Yes | - | YouTube video ID (e.g. dQw4w9WgXcQ) |
| language | string | No | - | Language code (e.g. en, zh-CN) |
| with_time | boolean | No | false | Include start/duration per segment |
Response (200)
{
"code": 0,
"message": "success",
"data": {
"title": "Video title",
"contents": [
{ "start": 0.32, "duration": 14.26, "text": "Subtitle text" }
]
}
}
With with_time=false, start/duration may be absent or zero. contents[].text is always present.
Error codes
| HTTP | Code | Description |
|---|---|---|
| 400 | - | Parameter validation failed (e.g. missing video_code) |
| 401 | INVALID_API_KEY | API key invalid or revoked |
| 500/502 | YOUTUBE_SUBTITLING_FAILED | Service error or subtitles unavailable for video |
Output Format
- Without
--json: print title and then each segment's text (one per line or concatenated). If--with-time, output includes timestamps. - With
--json: print full API response.
On failure (no subtitles, API error): stderr message and exit 1. Example:
YouTube subtitling failed for video dQw4w9WgXcQ: YOUTUBE_SUBTITLING_FAILED
Important Notes
- Not all videos have subtitles; the API may return an error for some videos.
- Language code must match a subtitle track available for the video.
- Same
FELO_API_KEYas other Felo skills.
References
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/felo-inc/felo-skills/felo-youtube-subtitling">View felo-youtube-subtitling on skillZs</a>