Sammle Kurzvideo-Daten
Das Creator-Dashboard zeigt nur die aktuellen kumulierten Werte, nicht die von gestern. Ein täglicher Snapshot zur gleichen Zeit zeigt den täglichen Zuwachs und Änderungen nach Optimierungen.
Die Erfassung erfolgt über playwright-cli, das mit einem bereits angemeldeten Chrome-Browser verbunden wird. Es öffnet die eigenen Tabs, liest die vom Backend geladenen Daten, und schließt sie danach wieder. Nur lesend – keine Buttons, keine Einstellungen.
Vorbereitung
- playwright-cli und die dazugehörige Chrome-Erweiterung; Chrome mit den angemeldeten Plattformen. Bei zeitgesteuerter Erfassung muss Chrome geöffnet bleiben und der Computer darf nicht in den Ruhezustand gehen.
- Lege im Stammverzeichnis des Video-Projekts eine
video-data.jsonan (nachvideo-data.example.jsonanpassen):
| Feld | Standard | Beschreibung |
|---|---|---|
time | "12:10" | Tägliche Erfassungszeit, HH:MM, gemäß lokaler Zeitzone |
timezone | Lokale Zeitzone | Bestimmt das Datum der Snapshot-Datei |
platforms | Alle drei | Auswahl aus douyin, weixin, xiaohongshu |
outDir | data/snapshots | Snapshot-Verzeichnis relativ zum Projektstamm |
Wähle eine feste Uhrzeit nach der Veröffentlichung. Die Daten der Plattform-Backends sind verzögert; Videos, die abends veröffentlicht werden, sind am nächsten Mittag stabil.
Erfassung
Führe im Stammverzeichnis des Projekts aus (<skill> ist das Verzeichnis dieser Skill):
node <skill>/scripts/collect.mjs # Alle Plattformen aus der Konfiguration
node <skill>/scripts/collect.mjs douyin # Nur eine Plattform nachträglich sammeln
- Ausgabe:
<outDir>/<Datum>.json. Ein erneuter Lauf am selben Tag führt zum Merge: erfolgreich gesammelte Daten überschreiben alte, fehlgeschlagene Plattformen behalten die bereits vorhandenen Daten. - Nach jeder erfolgreichen Plattform wird die Datei geschrieben. Bei Unterbrechung gehen bereits gesammelte Daten nicht verloren.
- Bei Fehlern ist der Exit-Code 1; im Terminal wird die fehlgeschlagene Plattform und die Fehlerursache angezeigt.
not_logged_inbedeutet Login abgelaufen – der Benutzer muss sich in Chrome erneut anmelden. Bei anderen Fehlern einmal manuell wiederholen; Douyin hat gelegentlich temporäre Ausfälle. - Führe die Erfassung nicht aus, während der Benutzer in Chrome ein noch nicht veröffentlichtes Formular ausgefüllt hat: Die Erfassung öffnet neue Tabs und könnte den Fokus vom Formular nehmen.
Zeitplanung
node <skill>/scripts/schedule.mjs gibt basierend auf time einen Cron-Ausdruck und eine Crontab-Zeile aus – nur als Information, ohne Änderung am System. Um die Zeit zu ändern, passe video-data.json an und erstelle den Zeitplan neu. Zwei Optionen:
- Integrierter Task-Scheduler des KI-Agenten (empfohlen): Erstelle einen geplanten Task mit dem ausgegebenen Cron-Ausdruck. Prompt: "Führe im die Video-Datensammlung durch, wiederhole fehlgeschlagene Plattformen einmal, und berichte für jede Plattform die Anzahl der Videos und Follower." Der Agent kann Fehler lesen und nachträglich sammeln.
- System-Crontab: Der Benutzer fügt die ausgegebene Zeile selbst mit
crontab -ehinzu. Logs werden im Snapshot-Verzeichnis incollect.loggeschrieben.
Zeige dem Benutzer vor dem Erstellen eines Zeitplans oder Ändern der Crontab immer die genaue Uhrzeit und den Befehl an.
Was ein Snapshot enthält
Jede Plattform als eigener Block: account (Nickname, Follower), works[] (jeweils id, desc, publishedAt, durationSec, metrics), sowie error oder warning. Verhältnisse sind Dezimalzahlen (0.55 = 55%).
| Plattform | Zusätzliche Daten | Einschränkungen |
|---|---|---|
| Douyin | Traffic-Quellen, Kapitel-Klickrate, Suchbegriffe, Retention-Kurven der letzten 30 Tage (max. 12 Videos) | Videoliste max. 5 Seiten lesbar |
| Weixin Channels | Tägliche Trends zu Aufrufen, Likes, Saves, Shares, Follower, aufgeschlüsselt nach Quelle | Videoliste nur erste Seite; warning bei mehreren Seiten |
| Xiaohongshu | Impressions, Cover-Klickrate, 2-Sekunden-Abbruch, 5-Sekunden-Abschluss | Nur Video-Notizen der letzten 30 Tage (max. 12); keine Quellenanalyse bei < 100 Aufrufen |
Metriken mit unterschiedlichen Definitionen sind nicht direkt vergleichbar: Bei Douyin und Xiaohongshu ist das frühe Verlassen die "2-Sekunden-Abbruchrate", bei Weixin Channels die "Schnell-Weg-Wische-Rate" (fast_flip_rate).
Daten ansehen
node <skill>/scripts/stats.mjs erstellt aus allen Snapshots eine Tabelle pro Video: tägliche Aufrufe, neue Aufrufe, durchschnittliche Wiedergabesekunden, Abschlussrate, frühes Verlassen, Interaktionen und Follower-Wachstum, sowie die neuesten Traffic-Quellen, Suchbegriffe und Retention-Kurven.
Bei wenigen Datenpunkten wird die Schlussfolgerung als "unzureichende Daten" markiert. Beim Vergleich zweier Videos wird zuerst auf die gleiche Anzahl Stunden nach Veröffentlichung geachtet, dann auf die Änderungen.
Bei der Übergabe zu erklären
- Welche Plattformen wurden gesammelt, wie viele Videos und Follower pro Plattform, welche Plattform fehlgeschlagen ist und warum.
- Pfad zur Snapshot-Datei.
- Bei der Einrichtung des Zeitplans: Cron-Ausdruck, Zeitzone der Auslösezeit, welche Zeitplanungsmethode verwendet wird.