YouTube Data Skill

Der deterministische Lesepfad für öffentliche YouTube-Daten über UnifAPI. Dies ist ein Data Skill: Er führt für sich genommen keinen Marketing-Job aus — er benennt die konkreten youtube/...-Operationen, Antwortformen und die realen Abdeckungsgrenzen, sodass jeder kanal- oder content-first-Workflow (Creator-Vetting, Wettbewerber- Rezeption, Content-Nachfrage) aus einem bekannten Rezept liest, anstatt die Oberfläche jedes Mal neu zu entdecken.

Schreibgeschützt — Augen, keine Hände. Er recherchiert öffentliche YouTube-Daten und gibt zitierte Datensätze zurück; er lädt nie hoch, kommentiert nicht und abonniert nicht, und UnifAPI hält nie YouTube-Anmeldedaten.

Nutzen Sie den unifapi-Skill für Live-Evidenz

Verbinden Sie sich einmal über den gemeinsamen unifapi-Skill (OAuth MCP) und rufen Sie dann die Operationen unten auf. Kanäle werden über {channel_id} und Videos über {video_id} verschlüsselt — lösen Sie zuerst ein Handle oder eine URL zu einer Channel-ID auf (siehe Gotchas). Bewahren Sie alle billing-Metadaten auf, damit die Ausgabe die Datensatzkosten angeben kann.

Antwort-Vertrag

Single-Entity-Endpunkte geben das Objekt in data zurück:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

Listen-Endpunkte geben ein Array in data plus pagination zurück:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Wenn pagination.has_more true ist, übergeben Sie pagination.next_cursor als cursor der nächsten Anfrage. Bewahren Sie billing beim Berichten der Kosten immer auf.

Kernoperationen

Brauchen Sie ein hier nicht aufgeführtes Feld? Nutzen Sie das get_operation des unifapi-Skills, um das exakte Schema vor dem Aufruf zu lesen — wählen Sie die Operation aber aus dieser Tabelle, entdecken Sie nicht blind.

Workflow

Die deterministischen Rezepte. Wählen Sie das, das zum Job passt; jedes benennt genau, was aufzurufen ist.

1. Die Abfrage abstecken. Rufen Sie youtube/search?q=... für die Frage, wer ein Thema besitzt, oder youtube/trending für das, was gerade hochschießt.
2. Einen Kanal auflösen. Rufen Sie youtube/resolve/channel-id?url=... auf, um die channel_id zu erhalten, dann youtube/channels/{channel_id} für subscriber_count, video_count und view_count.
3. Den Output eines Kanals lesen. Rufen Sie youtube/channels/{channel_id}/videos (und .../shorts) auf; der view_count jedes Videos ist das Nachfragesignal. Blättern Sie über next_cursor. youtube/channels/{channel_id}/playlists kartiert, wie der Katalog organisiert ist; youtube/channels/{channel_id}/community liest Ankündigungen und Interaktion außerhalb von Videos; youtube/channels/{channel_id}/search?q=... findet die Abdeckung eines Themas durch einen Creator, ohne den ganzen Katalog zu scannen.
4. Ein Video und seine Nachbarschaft lesen. Rufen Sie youtube/videos/{video_id} für Metadaten auf (jetzt inklusive like_count, category, published_at, has_captions), dann youtube/videos/{video_id}/related, um angrenzende Nachfrage und konkurrierenden Content zu kartieren.
5. Publikum und Transkript lesen. Rufen Sie youtube/videos/{video_id}/comments (sort_by top/newest) für das auf, was das Publikum sagt — roher Kommentartext, Like- und Antwortanzahlen; jegliche Sentiment- oder FAQ-Gruppierung ist Ihre Sache zu berechnen, die API gibt nur Text zurück. Rufen Sie youtube/videos/{video_id}/captions für Caption-Tracks (Timed-Text-URL pro Sprache) auf, um das Transkript zu lesen oder zu analysieren.
6. Eine Playlist oder einen Hashtag durchlaufen. Rufen Sie youtube/playlists/{playlist_id}, dann .../videos auf, um eine kuratierte Serie in Reihenfolge aufzunehmen; youtube/hashtags/{tag}/videos verfolgt eine Kampagne oder einen Trend über Creators hinweg.
7. Themen-Nachfrage dimensionieren. Aggregieren Sie view_count über die Such- und verwandten Ergebnisse für ein Thema; title, description und keywords zeigen, wie das Thema gerahmt ist.
8. Alles zitieren. Jede Zahl knüpft an das Video oder den Kanal an, aus dem sie stammt; berichten Sie billing.records_charged (oder schätzen Sie, wenn Billing-Metadaten fehlen).

Form-Notizen

• YouTubeChannel — verschlüsselt über {channel_id}. subscriber_count, video_count, view_count, handle, keywords, links, country, created_at. is_verified wird vom Upstream nicht befüllt und ist immer false — berichten Sie keine Verifizierung, die Sie nicht lesen können.
• YouTubeVideo — verschlüsselt über {video_id}. view_count, like_count (best-effort; 0, wenn der Creator ihn verbirgt), category, channel_id, author, duration_seconds, keywords, published_at, has_captions, is_live, is_private.
• YouTubeVideoPreview — Such-/Related-/Listenzeilen: fügt published_time hinzu. category ist Teil der Form, aber bei Listenzeilen leer (nur das YouTubeVideo- Detail trägt es).
• YouTubeComment — text, author, author_channel_id, like_count, reply_count, published_time, is_verified, is_creator. Nur Text — kein Sentiment-Feld.
• YouTubeCaptions — video_id, tracks[] (language_code, Timed-Text- url, is_translatable), translation_languages[]. Einzelobjekt, als ein Datensatz abgerechnet. Track-URLs sind zeitlich begrenzt.
• YouTubePlaylist / YouTubePlaylistPreview — Playlist title, channel_id, author, video_count (Detail fügt view_count, last_updated hinzu; Preview fügt first_video_id hinzu).
• YouTubeChannelPreview — Search-Channels-Zeilen: title, handle, description, subscriber_count, video_count.
• YouTubeCommunityPost — text, author, vote_count, reply_count, attachment_type, image_url.

Gotchas

• Resolve geht nur zu Channel-IDs. youtube/resolve/channel-id?url=... löst ein Handle oder eine URL zu einer {channel_id} auf — rufen Sie es vor jedem youtube/channels/{channel_id}/...-Aufruf auf. Es gibt keinen Video- oder Playlist-ID- Resolver; übergeben Sie eine bekannte {video_id} / {playlist_id} (parsen Sie sie selbst aus der URL).
• Kommentare sind roher Text. youtube/videos/{video_id}/comments gibt Kommentartext plus Like-/Antwortanzahlen zurück — kein Sentiment, keine FAQ-Gruppierung. Berechnen Sie diese selbst aus dem Text; behaupten Sie kein Sentiment-Feld, das die API nicht zurückgibt.
• like_count ist best-effort. YouTubeVideo.like_count ist 0, wenn der Creator Likes verbirgt — behandeln Sie 0 als „verborgen oder keine“, nicht als maßgeblich.
• is_verified ist immer false für Kanäle (der Upstream legt es nicht offen) — berichten Sie keine Kanalverifizierung.
• Captions können leer sein. Ein Video mit deaktivierten Captions gibt tracks: [] zurück; prüfen Sie das, bevor Sie ein Transkript versprechen. Track-URLs sind zeitlich begrenzt.
• Hashtags nehmen den Tag mit oder ohne führendes # (youtube/hashtags/lofi/videos).
• Ein niedriges Guthaben kann Listenseiten stillschweigend abschneiden: prüfen Sie billing.truncated_due_to_balance — wenn true, ist die Seite unvollständig.

Ausgabe

Geben Sie die Datensätze zurück, die der aufrufende Workflow braucht, jeweils zitiert zu seinem Video oder Kanal, plus einer Einzeiler-Kostennotiz (records_charged). Wenn dieser Skill direkt genutzt wird, ist ein kompaktes Nachfrage-Briefing der Standard:

**{Channel}** — {subscribers} subscribers, {videos} videos, {totalViews} views. Top videos for {topic}: {title} ({views} views). Related/competitors: {channels}. Evidence: {URLs}. Records: ~{N}.

Verwandte Skills

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — bepreisen und prüfen Sie YouTube-Kanäle auf Basis dieses Lesepfads.
• competitor-profiling (Competitive Intelligence), content-opportunity-brief (Content Strategy) — Rezeptions- und Content-Nachfrage-Arbeit, die zuerst YouTube liest.
• unifapi — der gemeinsame Daten-Skill: verbinden Sie MCP und schlagen Sie exakte Schemas mit get_operation nach.