O czym jest ten film
- Autor prezentuje YouTube Scout — własny, darmowy skill z otwartym kodem, który po komendzie
/scoutbuduje ranking filmów na dowolny temat. - Dane pochodzą z YouTube Data API; według autora darmowy limit to około 1000 zapytań dziennie, a komplet do 50 filmów to jakieś 50 zapytań — realnie da się analizować nawet 1000 pozycji.
- Każdy film opisuje 48 kolumn: od wyświetleń i zaangażowania, przez pełną charakterystykę kanału, po tagi, język, miniaturę i kraje z blokadą.
- Najciekawsze są sygnały nieczytelne wprost z interfejsu YouTube: wybicie filmu ponad swój kanał, tempo przyrostu wyświetleń, hak wyciągnięty z napisów, najpopularniejszy komentarz i najczęściej przewijane fragmenty.
- Instalacja sprowadza się do wklejenia linku z GitHuba i prośby skierowanej do własnego agenta (Claude Code, Codex, Hermes); jedyny ręczny krok to wyrobienie klucza YouTube Data API.
- Wbudowany yt-dlp pozwala pobrać pełny transkrypt dowolnego filmu.
- W parze z drugim narzędziem autora, YouTube Pro, tworzy kompletny pakiet: filmy, kanały, streszczenia, komentarze i transkrypty.
- Autor na tych arkuszach planuje własne publikacje — tytuł, miniaturę i opis — oraz szuka danych pozwalających wyprzedzić konkurencję.
- Komentarze pod hitami to kopalnia pytań bez odpowiedzi; film, który na nie odpowiada, potrafi „oderwać kawałek tortu” cudzego zasięgu.
- Wynik zapisuje się jako plik XLS na pulpicie; autor importuje go do Arkuszy Google i na tym zestawieniu rozmawia z Gemini o kolejnych krokach.
10 najważniejszych takeaways — z kontekstem zastosowania
1.Jedna komenda zamiast ręcznego przeklikiwania YouTube
Na czym polega: zamiast otwierać dziesiątki kart i przepisywać statystyki, wpisujesz /scout i temat — agent sam pobiera dane i układa ranking.
Jak stosować: w Claude Code lub Codex wystarczy np. /scout najlepsze filtry do prysznica; zakres doprecyzujesz zwykłym zdaniem, np. „top 10 filmów z ostatnich 20 dni o ziemniakach”.
Na co uważać: narzędzie czerpie wyłącznie z publicznego API, więc nie zastąpi wewnętrznych statystyk z YouTube Studio — pełnej retencji czy CTR.
2.Darmowy limit API wystarcza na naprawdę głęboki research
Na czym polega: według autora YouTube Data API pozwala na około tysiąc zapytań dziennie bez opłat, a komplet danych do 50 filmów kosztuje ok. 50 zapytań.
Jak stosować: ustal rano priorytetowe tematy i badaj je po kolei; przy większych projektach rozłóż pracę na kilka dni zamiast sięgać po płatną opcję.
Na co uważać: zapytania mogą zjadać też inne narzędzia podpięte pod ten sam klucz — warto pilnować łącznego zużycia limitu.
3.48 kolumn: pełny obraz filmu i całego kanału
Na czym polega: arkusz łączy dane pojedynczego materiału (wyświetlenia, polubienia, komentarze, długość, język, tagi, miniatura) z charakterystyką kanału (subskrypcje, średnie wyświetlenia, kraj, data założenia, słowa kluczowe).
Jak stosować: przed nagraniem przefiltruj kolumny pod konkretny cel — np. porównuj wyświetlenia w przeliczeniu na subskrypcje, żeby ocenić, czy film przebija typową skuteczność kanału.
Na co uważać: nadmiar danych przytłacza; z góry wybierz pięć–sześć metryk, które naprawdę decydują w Twojej niszy.
4.Sygnały, których nie wyczytasz z interfejsu YouTube
Na czym polega: poza surowymi liczbami skill wylicza współczynnik wybicia filmu ponad kanał, tempo wyświetleń dziennie, najpopularniejszy komentarz, hak odczytany z napisów oraz najczęściej przewijane fragmenty — najbliższe publiczne przybliżenie retencji.
Jak stosować: analizuj momenty przewijania u konkurencji i przenoś te „punkty zapalne” do własnego scenariusza oraz montażu.
Na co uważać: wykres ponownych odtworzeń to tylko przybliżenie retencji — nie traktuj go jak dokładnego wykresu z YouTube Studio.
5.Format i hak ustal, zanim włączysz kamerę
Na czym polega: dane o zwycięskich formatach i pierwszych sekundach filmów pozwalają rozstrzygnąć kwestię kształtu materiału jeszcze przed produkcją — dokładnie tak robi autor przed każdym odcinkiem.
Jak stosować: dla planowanego tematu przejrzyj 5–10 najlepiej radzących sobie filmów, wypisz wspólne cechy (długość, tytuł, miniatura, otwarcie) i dopasuj do nich swój plan.
Na co uważać: kopiowanie wzorca jeden do jednego odbiera Ci własny styl — traktuj dane jako punkt odniesienia, nie przepis.
6.Komentarze jako darmowy brief na kolejny film
Na czym polega: większość twórców nie czyta komentarzy, a to w nich widzowie zadają pytania, na które nikt jeszcze nie odpowiedział. Odpowiadanie na pytania ludzi to — jak podkreśla autor — jedna z kluczowych zasad YouTube, Google i SEO w ogóle.
Jak stosować: przejrzyj komentarze czołowych filmów w swojej niszy, zbierz powtarzające się pytania i nagraj na nie materiały.
Na co uważać: pojedynczy komentarz to nie trend — szukaj pytań, które wracają pod wieloma filmami.
7.Poluj na filmy, które wyrwały się ponad swój kanał
Na czym polega: porównanie wyniku filmu ze średnią kanału wskazuje materiały-wybicia — gotowe wzorce do naśladowania i inspiracja do własnego wzrostu, niezależnie od tematu czy rynku.
Jak stosować: filtruj filmy o wysokim stosunku wyświetleń do subskrypcji kanału i rozkładaj na czynniki, co je wyróżniło: temat, miniaturę, tytuł, moment publikacji.
Na co uważać: jedno wybicie bywa dziełem przypadku albo trendu, który już minął — potwierdź wzorzec na kilku przykładach, zanim zmienisz strategię.
8.Instalacja przez agenta, klucz API jedynym wymogiem
Na czym polega: skilla instaluje się, prosząc własnego agenta (Claude Code, Codex, Hermes) o wykonanie czynności z linku do GitHuba; samodzielnie załatwiasz tylko klucz YouTube Data API, z którym agent może przeprowadzić Cię za rękę.
Jak stosować: wklej link z opisu filmu i napisz „zainstaluj ten skill”; jeśli coś pójdzie nie tak, opisz problem agentowi i poproś o naprawę.
Na co uważać: klucz API trzymaj w bezpiecznym miejscu i nigdy nie publikuj go publicznie.
9.Wynik pracuje w Twoich arkuszach, nie w czarnej skrzynce
Na czym polega: efektem jest zwykły plik XLS zapisywany na pulpicie — można go wgrać do Arkuszy Google, uzupełnić własnymi notatkami i dalej analizować, np. rozmawiając z Gemini bezpośrednio nad danymi. Dokładnie tak pracuje autor.
Jak stosować: zaimportuj arkusz, dodaj podsumowanie i pytaj model o rekomendacje — tytuł, miniaturę, kolejne kroki.
Na co uważać: model nie zna Twojej strategii — zanim poprosisz o wnioski, podaj kontekst: grupę docelową i cele kanału.
10.Oszczędność tokenów: jeden przebieg zamiast wielu
Na czym polega: samodzielny research prowadzony przez agenta potrafi pochłonąć mnóstwo tokenów i czasu, a na koniec zostaje i tak stos otwartych kart. Gotowy skill zbiera wszystko w jednym przebiegu.
Jak stosować: sięgaj po /scout zawsze wtedy, gdy zamiast „dowiedzieć się czegoś” potrzebujesz porządnego zestawu danych do analizy.
Na co uważać: jakość wyniku zależy od jakości polecenia — im precyzyjniej określisz zakres (czas, liczba filmów, temat), tym mniej ręcznego czyszczenia danych potem.
Redakcyjne tłumaczenie
Jedna komenda i temat — gotowy ranking 50 filmów
Jedna komenda w Claude albo Codex i dowolny temat: AI w SEO, najlepsze ziemniaki, przepisy na matchę — cokolwiek. Na wyjściu dostajesz uporządkowany arkusz z pięćdziesięcioma filmami, które w danym temacie naprawdę się liczą: z wyświetleniami, zaangażowaniem i twórcami, którzy stoją za poszczególnymi materiałami. To YouTube Scout — narzędzie, które Daniel Agrici zbudował w tym tygodniu i które przez najbliższe cztery minuty pokazuje w akcji.
Jak to działa
Zasada jest banalnie prosta. Wpisujesz /scout i temat — na przykład „najlepsze narzędzia AI” — i całość rusza. Narzędzie odpytuje YouTube Data API, czyli oficjalny interfejs Google do publicznych danych YouTube, i spisuje twórców działających w danej dziedzinie. Jeśli prowadzisz własny kanał, możesz podpiąć także swój profil — wtedy śledztwo idzie znacznie szybciej. I od razu ważna uwaga: ponieważ korzystamy z API, całość działa bez opłat, a projekt udostępniono ponadto z otwartym kodem.
(Informacja dodatkowa: „skill” to w świecie agentów takich jak Claude Code rozszerzenie — pakiet gotowych czynności instalowany raz i wywoływany potem pojedynczą komendą, tutaj: /scout.)
Co ląduje w arkuszu: 48 kolumn na film
Po wpisaniu /scout — przykładowo „filtry do prysznica” — dostajesz listę pięćdziesięciu najlepszych filmów dla danego zapytania, a każdą pozycję opisuje czterdzieści osiem kolumn. Znajdziemy tam dane samego materiału: platformę, twórcę, handle, identyfikator i link, datę publikacji, wyświetlenia, polubienia, komentarze, zaangażowanie, długość, tytuł, trafność, format i wiek. Dalej metryki wyliczone: wyświetlenia dziennie oraz wyświetlenia w przeliczeniu na liczbę subskrypcji. Potem cała charakterystyka kanału: adres, liczba subskrypcji, liczba filmów i łącznych wyświetleń, średnia liczba wyświetleń na film, kraj, data założenia, słowa kluczowe i tematy. Wreszcie szczegóły techniczne: kategoria, tagi i ich liczba, język, dostępność napisów, jakość HD, licencja, możliwość osadzania, oznaczenie „dla dzieci”, pełny opis, kraje z ograniczeniami oraz miniatura. Wyliczanie można by ciągnąć w nieskończoność, ale idea jest jasna: wszystko, co API udostępnia publicznie, ląduje w jednym miejscu.
Limity i koszty
Według autora YouTube Data API pozwala na około tysiąc zapytań dziennie bez żadnych opłat. Komplet danych do pięćdziesięciu filmów to w przybliżeniu pięćdziesiąt zapytań, więc jeśli ktoś ma większy apetyt, bez trudu sięgnie nawet po tysiąc pozycji. A gdyby dzienny limit się skończył, można odczekać do następnej doby albo — jeśli bardzo się spieszy — dopłacić.
Instalacja krok po kroku
Instalacja jest równie prosta. Wchodzisz na link z GitHuba (znajdziesz go także w opisie filmu), otwierasz swojego agenta — Claude Code, Codex, Hermes, z czymkolwiek pracujesz — i prosisz o zainstalowanie skilla. Zatwierdzasz i gotowe. Autor ma już rozszerzenie na pokładzie, więc sam nie musi powtarzać procedury; gdyby coś się posypało, wystarczy opisać agentowi problem i poprosić o naprawę.
Jedyną rzeczą, którą trzeba załatwić samodzielnie, jest klucz YouTube Data API. Wystarczy poszukać tego w Google — a agent chętnie przeprowadzi przez konfigurację. Google udostępnia ten interfejs po to, by dodawać funkcjonalności YouTube do własnych aplikacji; tutaj „aplikacją” jest właśnie skill, a korzystanie z niego nic nie kosztuje.
Sygnały, których nie widać w interfejsie YouTube
Najciekawsza jest jednak ta część danych, której z samego YouTube nie odczytamy. Obok surowych liczb skill wylicza:
- współczynnik wybicia (breakout ratio) — jak bardzo film przekracza typowe wyniki swojego kanału,
- tempo — wyświetlenia dziennie,
- najpopularniejszy komentarz pod każdym filmem,
- tekst otwarcia, czyli hak — wyciągnięty z napisów,
- najczęściej przewijane fragmenty — „gorące punkty” na wykresie ponownych odtworzeń, najbliższe publiczne przybliżenie retencji.
(Informacja dodatkowa: wykres „Most replayed” to publiczna funkcja YouTube pokazująca momenty filmu, które widzowie przewijają najczęściej; dla twórców bez dostępu do statystyk konkurencji to najlepszy dostępny wgląd w jej retencję.)
Zastosowanie: zaplanuj film, zanim włączysz kamerę
Wyobraź sobie, że zbierasz się do nowego materiału — o produkcie, usłudze albo, tak jak autor w tej chwili, o kolejnym odcinku na YouTube. Właśnie z takich arkuszy korzysta i będzie z nich korzystać po nagraniu tego wideo, by mieć pewność co do miniatury, opisu i dobrze zbudowanego tytułu (mówi o nim „tytuł ABC”), który spodoba się widzom. To zarazem gotowa biblioteka odniesień z innych kanałów: widać w niej, co konkretnie robić i na jakich danych oprzeć plan, żeby wyprzedzić każdą z konkurencyjnych pozycji — bo danych jest pod dostatkiem.
W samym skillu siedzi jeszcze yt-dlp, dzięki któremu można ściągnąć pełny transkrypt dowolnego filmu.
(Informacja dodatkowa: yt-dlp to popularne narzędzie o otwartym kodzie do pobierania filmów i napisów m.in. z YouTube.)
Duo z YouTube Pro
Warto pamiętać, że autor ma na koncie także YouTube Pro — jego zdaniem znakomite narzędzie — a Scout uzupełnia istniejący arkusz badawczy o kolejne dane. Połączenie obu skilli daje kompletny zestaw: filmy, kanały, streszczenia, komentarze i, w razie potrzeby, transkrypty.
Przykłady zapytań
Szybki start może wyglądać tak: /scout matcha recipes. A gdy zależy Ci na węższym oknie czasowym — ostatnich 30 czy 60 dniach albo czymkolwiek innym — po prostu to napisz: „top 10 filmów z ostatnich 20 dni o ziemniakach”. Agent zbuduje dokładnie ten sam rodzaj arkusza, tylko dla dziesięciu pozycji. Podobnie zadziała prośba o audyt, np. „/scout, sprawdź mi top 10 filmów o ziemniakach / kawie / narzędziach AI do SEO”.
Research bez pożerania tokenów
Kto robił research z agentami, ten wie: takie śledztwo pochłania mnóstwo tokenów i czasu, a na końcu i tak zostaje stos otwartych kart w przeglądarce. Ten skill ma całość zamknąć w jednym przepływie pracy — jak zapewnia autor, na razie udaje mu się objąć wszystko. Jeśli jednak coś umknęło, zachęca do zgłoszeń w komentarzach; chętnie dorzuci kolejne usprawnienia. Całość sprowadza się zatem do jednej komendy /scout i dowolnego hasła — „filtr do prysznica” albo „10 najlepszych kaw świata” — a każdy publiczny parametr wpada do wspólnego arkusza.
Trzy zastosowania prosto z warsztatu
Pierwsze: znajdź filmy, które wyrwały się ponad swój kanał. Doskonale sprawdzają się jako odniesienie, a nawet inspiracja — można po prostu rosnąć razem z nimi, niezależnie od tematu czy rynku.
Drugie: rozstrzygnij kwestię formatu, zanim zaczniesz nagrywać. Autor przetestował to na zapytaniu /scout AI SEO oraz poprzednim — i, jego słowami, efekt był fantastyczny.
Trzecie: zobacz, gdzie widzowie cofają film. Dla każdej pozycji wiadomo, czym było otwarcie, a na wykresie odtworzeń widać charakterystyczne „górki” — autor odsyła do własnego odcinka, gdzie te szczyty można dostrzec gołym okiem. Przy tworzeniu filmów to wiedza kluczowa, bo pokazuje, co ludziom się podoba — zarówno w Twoich materiałach, jak i u konkurencji.
A teraz wyobraź sobie te trzy rzeczy spięte w jeden proces. Zdaniem autora — będzie absolutnie fantastycznie.
Komentarze piszą za Ciebie następny film
Większość twórców w ogóle nie czyta komentarzy — a to one mogą napisać za nich kolejny film. Jedna z najważniejszych zasad, jeśli chodzi o YouTube, Google i SEO w ogóle, sprowadza się do jednego: odpowiadaj na pytania ludzi. Pytania zaś siedzą głównie w komentarzach. Pod popularnym filmem z milionami wyświetleń zwykle jest ich mnóstwo — i mnóstwo pytań bez odpowiedzi. Kto odpowiada na nie własnym materiałem, ten może złapać dla siebie kawałek tamtego tortu. A wszystkie te dane wpadają do arkuszy, z których już korzystasz.
Z pliku XLS do Arkuszy Google i rozmowy z Gemini
Efektem pracy skilla jest zwykły plik XLS zapisywany na pulpicie. Autor wgrał go do swoich Arkuszy Google — tak wygodniej się z niego korzysta przy analizie. Obok danych o filmach prowadzi tam także zestawienie kanałów i podsumowanie całości, bo bezpośrednio nad arkuszem może rozmawiać z Gemini i ustalać, co dalej.
Na koniec
To cała idea YouTube Scouting: jeden temat na wejściu, jeden uporządkowany raport badawczy na wyjściu. Link do repozytorium na GitHubie znajdziemy w opisie filmu. Zainstalujcie skilla przez własnego agenta i koniecznie skonfigurujcie klucz YouTube Data API — autor podkreśla, że to kwestia istotna. Autorem jest Daniel, gospodarz społeczności AI Marketing Hub; linki do społeczności i do repozytorium również lądują w opisie.