Skip to content

Add GetYouTubeTranscript adapter - #1819

Open
pushkarsingh32 wants to merge 1 commit into
HelpCode-ai:mainfrom
pushkarsingh32:adapter-getyoutubetranscript
Open

pushkarsingh32 wants to merge 1 commit into
HelpCode-ai:mainfrom
pushkarsingh32:adapter-getyoutubetranscript

Conversation

@pushkarsingh32

@pushkarsingh32 pushkarsingh32 commented Nov 21, 2026 •

Copy link
Copy Markdown

Closes #1810

Adds a REST adapter for the GetYouTubeTranscript API (https://getyoutubetranscript.com/api/v1), following the REST route suggested in #1810. The user pastes one API key; it is sent as the x-api-key header.

Tools

All GET, all read-only. Every successful call costs 1 credit except getyoutubetranscript_get_credits, which is free.

Tool Endpoint What it returns
getyoutubetranscript_get_transcript GET /transcript?v=&language=&timestamps=&translate= The transcript of one video as text, with title, author and thumbnail; timestamps=true adds per-line segments; translate machine-translates it
getyoutubetranscript_list_languages GET /transcript/languages?v= The caption languages a video has (manual or auto) and the default
getyoutubetranscript_search GET /search?q=&type=&country=&language=&limit=&page_token= YouTube search for videos or channels, paged with continuation_token
getyoutubetranscript_get_channel_latest GET /channel/latest?channel= Channel details and its 15 newest uploads
getyoutubetranscript_list_playlist_videos GET /playlist?list=&continuation= The videos of a playlist, paged with continuation_token
getyoutubetranscript_get_credits GET /credits Remaining credit balance, plan and rate limit

Endpoints, parameters and answer shapes are taken from the public spec at https://getyoutubetranscript.com/openapi.json.

Setup check

  • probe: getyoutubetranscript_get_credits with no parameters. It costs no credit, so the install check never spends the user's balance.
  • verifyHints: 401 (wrong or revoked key, where to create a new one) and 429 (plan rate limit).
  • envVarMeta.GETYOUTUBETRANSCRIPT_API_KEY: secret, links to https://getyoutubetranscript.com, pattern ^sk_live_[A-Za-z0-9_-]{20,}$ (keys start with sk_live_).
  • Errors come back with real HTTP statuses and a JSON {success: false, code, message} body, so no errorWhen rule is needed.

Other files

  • Logo at packages/frontend/public/logos/connectors/getyoutubetranscript.svg.
  • catalog.ts regenerated, adapter counts bumped 957 to 958, llms.txt and llms-full.txt regenerated.
  • getyoutubetranscript.live.spec.ts: static checks (base URL, auth header, routes, every declared parameter reaches the query, all GET, probe, every tool named in the instructions) that always run, plus a live part behind RUN_GETYOUTUBETRANSCRIPT_LIVE=1 (without a key it only checks that /credits answers 401 MISSING_API_KEY; with GETYOUTUBETRANSCRIPT_API_KEY it reads the balance and one transcript, 1 credit).

Validation

Run locally on this branch:

  • node scripts/validate-adapters.mjs: Validated 976 adapters: 976 passed, 0 failed. With --warn, no warning names this adapter.
  • node scripts/adapter-count.mjs --check: OK: every quoted count equals 958 adapters (51 keyless, 20022 tools).
  • node scripts/generate-llms-txt.mjs --check: exit 0.
  • node scripts/regenerate-catalog.mjs: the committed catalog.ts matches.
  • node --test scripts/validate-adapters.test.mjs scripts/adapter-new.test.mjs scripts/generate-llms-txt.test.mjs: 73 pass, 0 fail.
  • npx jest src/adapters/intl/getyoutubetranscript (packages/backend): 7 passed, 2 skipped (live part).
  • RUN_GETYOUTUBETRANSCRIPT_LIVE=1 npx jest src/adapters/intl/getyoutubetranscript, no key: 8 passed, 1 skipped (/credits answered 401 MISSING_API_KEY).
  • npx jest src/adapters/catalog.spec.ts src/adapters/catalog-summary.spec.ts: 23294 passed.
  • npx jest src/mcp-server/catalog-patterns: 12 passed (the key pattern passes the slow-regex check).
  • npx eslint src/adapters/intl/getyoutubetranscript.live.spec.ts: clean.

I can test it against a real account once it is in a build, as offered in #1810.

REST adapter for the GetYouTubeTranscript API (https://getyoutubetranscript.com/api/v1),
as discussed in HelpCode-ai#1810. One API key, sent as the x-api-key header.

Six read-only GET tools: transcript (optional timestamps and translation),
caption languages, YouTube search, a channel's latest uploads, playlist
videos, and the credit balance. The free /credits call is the setup probe,
so the install check spends no credit. verifyHints cover 401 and 429.

The spec checks the base URL, auth header, routes, that every declared
parameter reaches the query, and the probe; live calls run behind
RUN_GETYOUTUBETRANSCRIPT_LIVE=1.

Catalog regenerated, counts bumped to 958, llms.txt regenerated, logo
added under public/logos/connectors.
@github-actions

Copy link
Copy Markdown


Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.


I have read the CLA Document and I hereby sign the CLA


You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Adapter] GetYouTubeTranscript: YouTube transcripts, search, channels and playlists (hosted MCP or REST)

1 participant