clean-playlist
Scan a YouTube playlist to plan removal of deleted/private video tombstones, duplicates, or videos from specified channels. Preview the cleanup plan, then optionally delete.
Instructions
Scan a playlist (1 unit/page) and plan removal of [Deleted video]/[Private video] tombstones, duplicates, and/or videos from given channels. Defaults to dry-run (dryRun: true) — returns the plan without deleting. Pass dryRun: false to actually delete, at 50 quota units per item.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"playlistId": "<playlistId>"
},
"name": "clean-playlist"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dedupe | No | Remove duplicate videos, keeping the first occurrence | |
| dryRun | No | When true (default), only returns the plan — no deletes performed | |
| playlistId | Yes | Playlist ID | |
| pruneChannelIds | No | Channel IDs whose videos should be removed | |
| removeTombstones | No | Remove [Deleted video]/[Private video] tombstones |