Bulk Edit & Optimize Videos with PreFilm's YouTube MCP

Matching

match: exact swaps the text, case and all, and keeps what follows it. It matches a link only where its host ends, so https://old.link leaves https://old.linkedin.com alone. match: url_prefix swaps every link that starts with it, whatever follows.

Your id in the link

A description's replacement can carry {video_id}, filled with each video's own id. utm_content={video_id} on a link shows in your own site's analytics which video sent each visit.

The preview

Lists each video that would change with every field before and after, the videos that cannot change and why (a title over 100 characters, a description over 5,000 bytes), the YouTube quota it needs and the day it would finish. The first 100 are listed; the job holds them all.

The apply

Send the preview's id and the same find and replace, with confirm: true. Up to 5 videos change at once and the rest are queued, each checked against the preview first. A video that moved since is skipped and named, and PreFilm emails you when the job finishes. A preview stands for 24 hours.

Following and undoing

mode status shows how far a job is. Stopping it with mode cancel keeps what already changed, and mode undo puts the changes back, each only if its video still says what the change left. A job still unfinished 14 days after its apply stops, and the email lists what did not change.

What a preview looks like

{
  "mode": "preview",
  "find": "https://old.link",
  "replace": "https://new.link",
  "match": "url_prefix"
}

The hash

my_videos gives each video a hash of its title, description and tags. Send it with the change. PreFilm reads the video again first and refuses if it changed since.

What stays

YouTube deletes any field an update leaves out, so PreFilm sends the whole video text back with only the fields you asked for changed. Tags, category and languages stay as they were.

Undo

mode undo with the edit_id puts a change back while the video still says what the change left.

What it sorts

Each link is opened once and sorted into dead, redirecting somewhere else, still pointing at an earlier offer, or not checked, with the reason. One link can be both dead and an earlier offer.

What else it lists

The videos that ask nothing of the viewer in the first two lines of the description.

How much it opens

Up to 50 links a run, 5 seconds for each, and 10 audits an hour.

What comes next

Each video it lists comes with its hash, so the fix is one replace_across_videos or update_video call away.

What it reads

Your top 50 videos of the last 90 days, and the 10 of them with the most views from YouTube search. For each, the exact searches people typed to find it. Searches for your channel's name or a video's own title are left out.

What it checks

For the best 10 phrases, how many people search each on Google a month and where your video ranks on YouTube for it. A phrase with very few searches is not checked on YouTube.

What it offers

Where your video ranks 4th to 20th, a new title and a new first line for the description, with the update_video call ready to preview and apply. Where it already ranks in the top 3, no change.

What it leaves to you

Nothing is applied by this tool. update_video makes the change after you confirm.

• Google's searches and YouTube's rankings here are for the United States.
• The monthly searches are Google's: YouTube does not publish how often a phrase is searched.
• Needs the YouTube connection with YouTube Analytics allowed. Priced in credits as a keyword check.

What it returns for each phrase

phrase

The search people typed.

verdict

Where you stand: in YouTube's top 3, 4th to 20th, not in the top 20, few searches, or not checked.

views_from_this_search

The views of your video that came from it, from YouTube Analytics.

google_searches_a_month

How many people search it on Google a month.

youtube_position

Where your video ranks on YouTube for it.

above_you

The videos ranking just above yours, with their channel, size and views.

change

For a video ranking 4th to 20th: title_before, title_after, first_line_before, first_line_after and the update_video call with the video's hash.

01Preview

A bulk replace and a change to one video are always previewed first, and the preview changes nothing.

02The hash check

Every change names the hash of the video as you saw it, and PreFilm reads the video again before it writes. A video that moved is refused, or in a bulk job skipped and named.

03Confirm

update_video's change after its preview, and the apply, cancel and undo of a bulk replace, each need confirm: true. Without it nothing is sent to YouTube.

04Undo

update_video with mode undo puts a change back while the video still says what the change left, and replace_across_videos with mode undo does it for a whole job. An undo is never undone, and it is priced as a video change, like the change it puts back.

Credits

One pot of credits a month, and every tool that spends is priced from it. list_channels shows what is left, and a refusal says what the call takes and what you have left.

1. 01A PreFilm plan. The $1 trial for 7 days counts.
2. 02An assistant connected to PreFilm: ChatGPT, Claude, Claude Code or Cursor.
3. 03Your channel connected to YouTube in Settings, which opens for every account once Google finishes reviewing PreFilm.