digitalsamba/claude-code-video-toolkit

youtube-stats

How published videos are doing on YouTube, and what to learn from it.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/digitalsamba/claude-code-video-toolkit --skill youtube-stats

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

YouTube stats

bash
uv run --extra youtube tools/youtube_stats.py --account personal                 # every upload, newest first
uv run --extra youtube tools/youtube_stats.py --account personal --video 1hyDgC5Qg_o e4HW-tvi8-8 --since 7d
uv run --extra youtube tools/youtube_stats.py --account personal --github --json  # plus repo referrers

Each run saves a snapshot to _internal/.youtube/stats/<account>/ and reports the change since the last one, so a daily or weekly run is the trend. --no-save for a look without a snapshot.

Setup

It reuses the token youtube_upload.py --auth --account NAME cached, so views, likes and comments work at once. Watch time, retention and traffic sources need the YouTube Analytics API:

  1. Google Cloud Console, the uploader's project: APIs & Services → Library → YouTube Analytics API → Enable.
  2. OAuth consent screen → Data access → Add or remove scopes: add

https://www.googleapis.com/auth/yt-analytics.readonly. It is a sensitive scope, the same class as the youtube scope the uploader already has, so the consent screen should behave as it did at the first login.

  1. uv run --extra youtube tools/youtube_stats.py --auth --account personal: one consent that asks for the upload

scopes and Analytics together and replaces the cached token, so the uploader keeps working.

Impressions and click-through rate are asked for separately: the metrics reference lists them, but the API has refused them in the past. When it refuses, the report says so; Studio still shows them.

Reading it

  • A Short lives or dies in the feed. Traffic source SHORTS is the feed; YT_SEARCH, EXT_URL (links from

the README, chat) and SUBSCRIBER are the rest. A Short with views only from EXT_URL was never pushed by the feed: change the cover frame and first second, not the title.

  • A Short's views stay on the Short unless it points somewhere. Compare its views with the long video's and

with youtube.com in the repo referrers. Give it a way on: the long video as its related video (set by hand in Studio; youtube_upload.py says when), and the link in its description and a pinned comment.

  • Average view percentage is the Short's real score. Over 100% means people loop it. Under ~50% on a 60-90 s

Short means the hook or the middle lost them; check where with Studio's retention graph.

  • Long videos: impressions × CTR × view duration. A low CTR is the title or thumbnail; a short duration is the

opening.

  • YouTube lags. Analytics is 1-2 days behind, and a new Short's first 48 hours are the feed testing it; judge

after a week.

  • The repo is the goal. --github shows the last 14 days of repo referrers; youtube.com appearing there is

the signal that a video sends people to the toolkit.

Before the next Short

What the numbers above point at is nearly always the opening. Three things to settle while planning, each of which qc.py --render then measures on the finished file (and --layout for the text):

  • The first 2 seconds. Start on the action: movement, a strong picture or a line already being said. Cut the

lead-in, the establishing shot and any pause before the first word.

  • Text from the first frame. A short line that says what the viewer gets by staying. Frame 0 is also the

cover, so the same line sells the video in a grid.

  • Something new every few seconds. A cut, a push in, a new piece of text. The check reports how long the

first shot runs and warns past 5 s.

Treat these as defaults to depart from on purpose, and let the retention graph say whether the departure worked: a slow opening that people watch through is a finding worth writing below.

What has worked on Shorts

Findings, not numbers: write each as what changed and what happened, with the dates, once there is a week of data.

  • 2026-11-08, baseline: You're On Mute (1hyDgC5Qg_o) and The Great Return (e4HW-tvi8-8) public for about a

day, 1 and 0 views; channel 26 subscribers. The repo got ~10k unique visitors in 14 days, mostly from Google, none from YouTube yet.

来自同一仓库

更多 Skills

全部 Skills
digitalsamba
社区

video-design

Visual design for videos - colour by act, type scale, chart and layout rules for 16:9 and 9:16 scenes, a design.md handoff that any design skill can fill, and a contact-sheet critique of the render. Use when designing or refining how a video looks (title cards, data scenes, slides, a whole video's palette), when a scene looks generic or busy, when choosing colours for a video, or when /design or /scene-review asks for visual work. Works on its own with a brand, or takes direction from a design s

1小时安装量
2
GitHub Stars
2651
最近更新
11月17日
digitalsamba
社区

acestep

AI music generation with ACE-Step 1.5 — background music, vocal tracks, covers, stem extraction, audio repainting, and continuation for video production. Use when generating music, soundtracks, jingles, or working with audio stems. Triggers include background music, soundtrack, jingle, music generation, stem extraction, cover, style transfer, repaint, continuation, or musical composition tasks.

1小时安装量
4
GitHub Stars
2627
最近更新
11月17日
digitalsamba
社区

blender

3D scenes, character acting and product shots from a shot spec, rendered in Blender, as a finished film, as clips for any other build (moviepy, a video job, an editor), or as elements of a Remotion video (transparent characters over a scene, a Remotion render on a 3D laptop, phone or floating card that the camera pulls back from, an imported 3D model on a studio stage), or a brand's opening and closing ident built from its SVG logo. A rigged cartoon cast described in JSON (build, face, hair, clo

1小时安装量
4
GitHub Stars
2627
最近更新
11月17日
digitalsamba
社区

elevenlabs

Generate AI voiceovers, sound effects, and music using ElevenLabs APIs. Use when creating audio content for videos, podcasts, or games. Triggers include generating voiceovers, narration, dialogue, sound effects from descriptions, background music, soundtrack generation, voice cloning, or any audio synthesis task.

1小时安装量
4
GitHub Stars
2627
最近更新
11月17日