The following process can be followed to diagnose when subtitle extraction fails:
Basic inspection(Solve 80% common problems): Confirm the presence of CC subtitle logo on the video (front-end display needs to be turned on), check the network proxy settings (some regions need specific configuration), and verify the validity of the API key (if configured).
technical diagnosis::
- pass (a bill or inspection etc)
DEBUG=ytt-mcp* npm startTurn on detailed logging mode and watch for error codes:- ERR_YT_NO_CAPTIONS indicates that captions are not turned on
- ERR_YT_AGE_RESTRICTED need to handle age verification
- ERR_NETWORK_TIMEOUT Checking Firewall Settings
- For some auto-generated subtitles, try adding the URL after the
&t=10Timestamp parameter forced refresh
Options: Enable the experimental speech recognition module when official subtitles are not available (to be set in the configuration)"enableASR": true), the feature is implemented based on Whisper model with an accuracy of about 75-85%. It is also recommended to submit the issue to GitHub with videoId and error logs, and the development team will usually respond within 48 hours.
This answer comes from the articleytt-mcp: server tool to get and process subtitles for YouTube videosThe
English 
简体中文 
日本語 
Deutsch 
Português do Brasil