techhorizonlabs/creator-audience

Zielgruppe des Erstellers

YouTube veröffentlicht keine Zielgruppendemografie. Die von youtube-channel-profile verwendete Data API enthält keine solchen Daten. Es gibt zwei ehrliche Quellen: die eigene Analyse des Kanalbesitzers, die mit dessen Einwilligung geteilt wird, oder eine kostenpflichtige Drittanbieter-Schätzung, die der Mensch genehmigt. Alles andere ist eine Vermutung. Sage das auch.

Die Einwilligungsregel

1. Daten des Besitzers stammen vom Besitzer. Er entscheidet, was er teilt, für welche Zeiträume und wer es sehen darf. Holen Sie dies schriftlich ein (E-Mail oder Nachricht), bevor Sie um Zugriff bitten.
2. Der Besitzer meldet sich mit seinem eigenen Konto an. Fragen Sie niemals nach seinem Passwort oder einem Anmeldecode, und geben Sie niemals einen für ihn ein.
3. Ausgaben benötigen ein Ja. Fragen Sie den Menschen vor jeder kostenpflichtigen Abfrage und nennen Sie die Kosten.
4. Leiten Sie niemals Alter, Geschlecht oder Land aus Namen, Gesichtern, Stimmen, Kommentaren oder Thumbnails ab.
5. Behalten Sie die Daten nur für den Auftrag. Zeigen Sie sie nur dem Besitzer und den von ihm genehmigten Personen (YouTube-Richtlinie III.E.3.b). Löschen Sie sie innerhalb von 7 Tagen nach einer Anfrage (III.E.4.g). Falls Sie sie behalten, überprüfen Sie die Einwilligung des Besitzers alle 30 Tage erneut (III.E.4.b).

Route 1: Der Besitzer teilt aus YouTube Studio (hier beginnen)

Dies erfordert keine API-Arbeit. Es eignet sich für einmalige Kurzbriefings.

Option A, Export: Bitten Sie den Besitzer, YouTube Studio zu öffnen, zu Analytik und dann zum Tab Zielgruppe zu gehen. Er wählt einen Datumsbereich (die letzten 90 Tage sind ein guter Standard) und teilt dann einen Screenshot oder Export von Alter, Geschlecht und den wichtigsten Ländern.

Option B, Schreibgeschützter Zugriff: Der Besitzer öffnet YouTube Studio und geht zu Einstellungen, dann Berechtigungen, dann Einladen. Er gibt die Google-Konto-E-Mail des Menschen ein und wählt die Rolle Betrachter (Eingeschränkt). Diese Rolle kann Analytik sehen, aber keine Einnahmen. Einladungen laufen nach 30 Tagen ab. Wenn der Auftrag endet, entfernt der Besitzer den Zugriff auf demselben Bildschirm. Markenkanal-Konten müssen zuerst zu Kanalberechtigungen wechseln.

Route 2: Die YouTube Analytics API (wiederholte oder größere Aufträge)

Verwenden Sie diese, wenn der Besitzer oder sein Team sie ausführt, oder für ein laufendes Engagement mit einer schriftlichen Einwilligung.

1. Erstellen Sie in Google Cloud ein Projekt. Aktivieren Sie die YouTube Analytics API und die YouTube Data API v3.
2. Richten Sie den OAuth-Zustimmungsbildschirm ein: Benutzertyp Extern, Veröffentlichungsstatus Test. Fügen Sie das Google-Konto des Besitzers als Testbenutzer hinzu.
3. Erstellen Sie eine OAuth-Client-ID vom Typ Desktop-App und laden Sie die Client-Datei herunter. Behandeln Sie sie als Geheimnis.
4. Fordern Sie nur diese Bereiche an:
   • https://www.googleapis.com/auth/yt-analytics.readonly
   • https://www.googleapis.com/auth/youtube.readonly (die reports.query-Referenz erfordert diesen jetzt ebenfalls)
   • Fügen Sie yt-analytics-monetary.readonly nur hinzu, wenn der Besitzer zustimmt, Einnahmen zu teilen.
5. Führen Sie die Anmeldung auf dem Rechner durch, auf dem sich der Besitzer selbst anmeldet. Zum Beispiel:

# pip install google-auth-oauthlib requests
from google_auth_oauthlib.flow import InstalledAppFlow
import requests
SCOPES = ["https://www.googleapis.com/auth/yt-analytics.readonly",
          "https://www.googleapis.com/auth/youtube.readonly"]
creds = InstalledAppFlow.from_client_secrets_file("client_secret.json", SCOPES).run_local_server(port=0)
base = "https://youtubeanalytics.googleapis.com/v2/reports"
common = {"ids": "channel==MINE", "startDate": "2026-08-01", "endDate": "2026-10-31"}
auth = {"Authorization": f"Bearer {creds.token}"}
age_gender = requests.get(base, headers=auth, params={**common,
    "metrics": "viewerPercentage", "dimensions": "ageGroup,gender"}).json()
countries = requests.get(base, headers=auth, params={**common,
    "metrics": "views,estimatedMinutesWatched", "dimensions": "country",
    "sort": "-views", "maxResults": 10}).json()

6. Der Besitzer wählt beim Google-Login den richtigen Kanal aus. channel==MINE bedeutet den Kanal, mit dem er sich angemeldet hat.
7. Lesen Sie columnHeaders und rows. viewerPercentage deckt nur die angemeldeten Zuschauer ab. Wenn keine Daten vorhanden sind, lässt YouTube rows weg. Melden Sie dies als "nicht verfügbar", niemals als Null.
8. Halten Sie das Token nur im Arbeitsspeicher. Widerrufen Sie es anschließend: Der Besitzer kann dies unter myaccount.google.com/permissions tun. Die Aktualisierungstokens einer Test-App laufen ebenfalls nach 7 Tagen ab.

Route 3: Eine kostenpflichtige Schätzung (Influencers Club MCP)

Der Influencers Club schätzt die Zielgruppendemografie für öffentliche YouTube-Kanäle. Es handelt sich um ein Drittanbieter-Modell, nicht um YouTube-Daten. Jede Abfrage verbraucht Credits.

1. Führen Sie check_credits (kostenlos) aus und notieren Sie den Kontostand.
2. Teilen Sie dem Menschen das Tool und seine Kosten mit, und warten Sie dann auf ein Ja. Kosten aus der Server-README, überprüft am 5. November 2026: enrich_by_handle_analytics kostet 0,8 Credits und gibt Zielgruppendemografie zurück. enrich_by_handle kostet 1 Credit; auf älteren Servern übergeben Sie include_audience_data true für den Zielgruppenabschnitt. enrich_by_handle_raw kostet 0,03 Credits und enthält keine Zielgruppendaten. Lesen Sie zuerst die eigene Beschreibung des Tools, da die Versionen variieren.
3. Tätigen Sie einen Aufruf für den einen Kanal, mit platform gesetzt auf youtube und handle gesetzt auf den Handle oder die Kanal-ID.
4. Wenn ein Aufruf einen Limit- oder Credit-Fehler zurückgibt, brechen Sie ab. Wiederholen Sie nicht und melden Sie, wie viele Abfragen durchgeführt wurden.
5. Verwenden Sie dafür nicht get_audience_locations oder get_audience_interests. Dies sind kostenlose Listen von Filterwerten, nicht die Zielgruppe des Erstellers.

Kennzeichnen Sie das Ergebnis als "geschätzt von Influencers Club", geben Sie das Abfragedatum an und vermischen Sie es niemals mit den Zahlen des Besitzers, ohne zu sagen, was was ist.

Was in das Kurzbriefing geschrieben werden soll

• Die Quelle jeder Zahl: die YouTube-Analyse des Besitzers mit ihrem Datumsbereich, der Studio-Export des Besitzers oder eine Drittanbieter-Schätzung.
• Alters- und Geschlechtsanteile für angemeldete Zuschauer sowie die wichtigsten Länder nach Aufrufen.
• Wenn es keine Einwilligung und keine genehmigten Ausgaben gibt, schreiben Sie: "Zielgruppendemografie: nicht verfügbar ohne die Analyse des Besitzers oder eine kostenpflichtige Schätzung." Das ist eine vollständige Antwort.

Überprüft am 5. November 2026 anhand der Referenz zur YouTube Analytics API, der Metriken- und Autorisierungsseiten, der YouTube-Hilfe zu Kanalberechtigungen sowie der README und Nutzungslimits des Influencers Club MCP.