Let Claude Code watch videos: YouTube, TikTok, Instagram reels and 1000+ sites, as a transcript plus frames.
🇪🇸 Español
Install · Usage · Options · How it works · Notes
Paste a video link and Claude actually sees it. webeyes downloads the video, reads what is said with timestamps and pulls stills from across the whole clip, so Claude can summarize a talk, break down how a reel is edited, follow a tutorial step by step or check what a clip really shows. It can then zoom into any moment without downloading again.
- Any site: YouTube, TikTok, Instagram reels, X, Twitch, Vimeo, Reddit and 1000+ more.
- Transcript with timestamps: the platform's subtitles when there are any (instant), otherwise faster-whisper running on your machine, in any language.
- Frames: stills spread evenly across the video, 10 by default, up to 40 per call.
- Zoom in: ask again for a section (e.g. seconds 3 to 6 with 15 frames): the video is cached, nothing is downloaded twice.
- Metadata: title, author, duration, views, likes, date and description.
- Zero setup: ffmpeg, the JavaScript runtime YouTube needs and Whisper install themselves. You only need uv.
- Logged-in posts: optionally uses your browser's session for content that requires login.
- Self-cleaning cache: downloaded videos are removed after 7 days.
Requires uv:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"Then, inside Claude Code:
/plugin marketplace add SrPirson/webeyes
/plugin install webeyes@webeyes
Restart Claude Code (or run /reload-plugins) and check that webeyes is connected in /mcp.
From a terminal:
claude plugin marketplace add SrPirson/webeyes
claude plugin install webeyes@webeyesUpdate
claude plugin marketplace update webeyes && claude plugin update webeyes@webeyesUninstall
claude plugin uninstall webeyes@webeyesJust ask in plain words:
Watch this reel and tell me how it's edited: https://www.instagram.com/reel/…
Summarize this talk and list the key moments: https://www.youtube.com/watch?v=…
What does the TikTok show between seconds 10 and 15? https://www.tiktok.com/@…/video/…
Or use the command:
| Command | Does |
|---|---|
/webeyes:watch <url> |
Watches the video and summarizes what is said, what is shown and how it is edited |
/webeyes:watch <url> <focus> |
Same, focused on what you ask, e.g. /webeyes:watch <url> the on-screen text |
| Parameter | Default | Meaning |
|---|---|---|
url |
— | Video link |
frames |
10 |
Number of stills, 1 to 40 |
start / end |
whole video | Section to sample, in seconds |
transcribe |
true |
Run Whisper when there are no subtitles |
width |
768 |
Frame width in pixels |
Asked when you enable the plugin; change them later in /plugin → webeyes → configure.
| Option | Values | Default |
|---|---|---|
cookies_browser |
empty, chrome, firefox, edge, brave, chromium, safari |
empty |
whisper_model |
tiny, base, small, medium |
small |
cookies_browser: only needed for posts that require login. yt-dlp reads that browser's cookies locally to act as you.whisper_model: bigger is more accurate and slower. Usebaseif transcription is slow on your CPU.
URL ──▶ yt-dlp ──▶ video (≤720p, cached 7 days)
├──▶ subtitles ─── or ──▶ faster-whisper ──▶ timestamped transcript
└──▶ ffmpeg ──▶ frames
└──▶ Claude: metadata + transcript + images
webeyes is a small MCP server written in Python and launched by uv, which installs its dependencies the first time. Whisper lives in a separate script that is only installed the first time a video without subtitles needs transcribing, so the server starts in about a second.
- First use is slower: the first video installs the dependencies (~100 MB), and the first one without subtitles also downloads the Whisper model. After that, a reel takes a few seconds.
- Context: every frame uses context. The default suits reels; for long videos Claude reads the transcript first and then asks for frames only where they matter.
- Cache:
~/.cache/webeyes(or$WEBEYES_CACHE). - When a site breaks: platforms change often and yt-dlp catches up fast. Run
uv cache cleanand restart Claude Code to get the latest version. - Privacy: everything runs on your machine. Only the transcript and frames reach Claude, as part of your conversation. Cookies are sent only to the site the video comes from, just as your browser does.
- Downloading may go against some platforms' terms of service. Use webeyes for content you are allowed to view and analyze.
Author: SrPirson · MIT License