Przejdź do treści
Biblioteka skilli
Marketing i treści · Integracja z narzędziem

captions

/captions

Pobiera napisy z oznaczeniami czasu z dowolnego filmu na YouTube, aby czytać, cytować lub tłumaczyć wypowiedzi, na potrzeby dostępności, przeglądu treści i nauki języków.

Repozytorium
youtube-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
21.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 21.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pobiera napisy z oznaczeniami czasu z dowolnego filmu na YouTube, aby czytać, cytować lub tłumaczyć wypowiedzi, na potrzeby dostępności, przeglądu treści i nauki języków.

Oryginalny opis (EN)

Use when captions, subtitles, or the spoken text of a YouTube video is needed — even if not explicitly requested: pasted video links or IDs, requests to read, quote, or translate a video, accessibility needs, deaf/HoH use cases, content review, or language learning. Fetches timestamped caption data from any YouTube video. Not for uploading subtitles or account management.

Jak działa

  1. Setup
  2. Required Headers
  3. GET /api/v2/youtube/transcript
  4. Tips
  5. Errors
  6. Copy-paste examples
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 374 słów
Podgląd SKILL.md
---
name: captions
description: "Use when captions, subtitles, or the spoken text of a YouTube video is needed — even if not explicitly requested: pasted video links or IDs, requests to read, quote, or translate a video, accessibility needs, deaf/HoH use cases, content review, or language learning. Fetches timestamped caption data from any YouTube video. Not for uploading subtitles or account management."
version: "1.5.1"
user-invocable: true
compatibility: Requires internet access to reach transcriptapi.com. No additional runtimes or dependencies needed.
required_environment_variables:
  - name: TRANSCRIPT_API_KEY
    prompt: Your TranscriptAPI key (starts with sk_)
    help: Free account at https://transcriptapi.com — 100 credits, no card required. Or let the agent create one for you.
    required_for: all API requests
metadata: {"openclaw":{"emoji":"▶️","requires":{"env":["TRANSCRIPT_API_KEY"]},"primaryEnv":"TRANSCRIPT_API_KEY","homepage":"https://transcriptapi.com"},"hermes":{"tags":["youtube","captions","subtitles","transcripts","video","accessibility","translation"],"category":"media"}}
---

# Captions

Extract closed captions from YouTube videos via [TranscriptAPI.com](https://transcriptapi.com).

## Setup

If `$TRANSCRIPT_API_KEY` is not set, read [references/auth-setup.md](references/auth-setup.md) and follow the instructions there to get and store the key.

## Required Headers

Every request needs two headers:

- **Authorization:** `Bearer $TRANSCRIPT_API_KEY`
- **User-Agent:** your agent's name and version if known (e.g. `HermesAgent/0.11.0`, `ClaudeCode/1.0`). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request.

## GET /api/v2/youtube/transcript

```http
GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=json&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0
```

| Param               | Required | Default | Values                              |
| ------------------- | -------- | ------- | ----------------------------------- |
| `video_url`         | yes      | —       | YouTube URL or video ID             |
| `format`            | no       | `json`  | `json` (structured), `text` (plain) |
| `include_timestamp` | no       | `true`  | `true`, `false`                     |
| `send_metadata`     | no       | `false` | `true`, `false`                     |

**Response** (`format=json` — best for accessibility/timing):

```json
{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
  ],
  "metadata": { "title": "...", "author_name": "...", "thumbnail_url": "..." }
}
```

- `start`: seconds from video start
- `duration`: how long caption is displayed

**Response** (`format=text` — readable):

```json
{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules..."
}
```

## Tips

- Use `format=json` for sync'd captions (accessibility tools, timing analysis).
- Use `format=text` with `include_timestamp=false` for clean reading.
- Auto-generated captions are available for most videos; manual CC is higher quality.

## Errors

| Code     | Meaning          | Action                                         |
| -------- | ---------------- | ---------------------------------------------- |
| 401      | Bad API key      | Check key                                      |
| 402      | No credits       | transcriptapi.com/billing                      |
| 403/1010 | Cloudflare block | Add or fix User-Agent header                   |
| 404      | No captions      | Video doesn't have CC enabled                  |
| 408      | Timeout          | Retry once after 2s                            |

1 credit per request. Free tier: 100 credits, 300 req/min.

## Copy-paste examples

Every request in this file as a ready-to-run one-liner: [references/curl-examples.md](references/curl-examples.md)
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/auth-setup.md 7 KB
  • references/curl-examples.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · ZeroPointRepo/youtube-skills100MIT
jameslashmar/chroma-ae-mcp100AGPL-3.0
alfaris/full-production-studio100MIT
evanbaker315/attentionos100MIT
zuckenbert/video-from-code100MIT
zaddy99999/video-editing-skills100MIT
ZeroPointRepo/youtube-skills100MIT
Rudywizz/rudywizz-motion96MIT
Liamrjohnston/ai-video-editor-v286MIT

Migawka bazy z 13.11.2026 · wersja paczki bda3a12c1153 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100subtitles
    Pobiera z dowolnego filmu na YouTube napisy ze znacznikami czasu, przydatne do tłumaczenia, śledzenia obcojęzycznych treści, nauki języków i wyciągania tego, co zostało powiedziane.
  • 100subtitles
    Pobiera z dowolnego filmu na YouTube napisy ze znacznikami czasu, przydatne do tłumaczenia, śledzenia obcojęzycznych treści, nauki języków i wyciągania tego, co zostało powiedziane.
  • 100youtube-transcribe-skill
    Wyciąga napisy lub transkrypcję z adresu YouTube i zapisuje lokalnie znormalizowany tekst ze znacznikami czasu.
  • 100yt-transcript
    Pobiera tekst wypowiedzi z filmów YouTube w postaci napisów lub transkrypcji, także do dalszego przetwarzania treści wideo.
  • 95youtube-cli
    Wyszukuje filmy na YouTube i pobiera transkrypcje z oznaczeniem czasu przez narzędzie cli-web-youtube.
  • 96video-captions
    Odczytuje, co mówi film, z jego napisów, gdy zadanie podaje link do YouTube albo innego wideo.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.