Communitygithub.com

geoqiao/short-video-skills

Veröffentliche Kurzvideos auf Douyin, Video Account und Xiaohongshu (für Bilibili nur Text): Lese zuerst Suchvorschläge von Douyin, Xiaohongshu und Google, schreibe Titel, Beschreibung, Themen, Cover-Text und Pinned-Kommentar; verwende dann playwright-cli, um das Veröffentlichungsformular im bereits eingeloggten Chrome auszufüllen, Video und Cover hochzuladen, sowie Sammlung, Standort, KI-Erklärung (falls KI verwendet wurde), Trends und Events zu ergänzen. Funktioniert unabhängig davon, wie das Video erstellt wurde. Standardmäßig wird vor dem Veröffentlichungsbutton gestoppt; der Nutzer muss ausdrücklich sagen, dass er dieses Video veröffentlichen möchte, bevor der Button gedrückt wird. Geeignet zum Schreiben oder Bearbeiten von Veröffentlichungstexten, Abrufen von Suchvorschlägen, Auswählen von Themen, stellvertretendem Veröffentlichen von Videos, Austauschen von Videos oder Covern, und Überprüfen bereits ausgefüllter Formulare.

Was ist short-video-skills?

Diese Fähigkeit automatisiert den Workflow zum Veröffentlichen von Kurzvideos auf chinesischen Plattformen wie Douyin, Video Account (WeChat) und Xiaohongshu (für Bilibili nur Texterstellung). Sie besteht aus zwei Phasen: Zuerst wird der Veröffentlichungstext (Titel, Beschreibung, Themen-Tags, Cover-Text und Pinned-Kommentar) auf Basis von Suchvorschlagsdaten erstellt, um die Zielgruppe genau anzusprechen. Dann wird mit playwright-cli das Veröffentlichungsformular im bereits eingeloggten Chrome-Browser ausgefüllt – Video und Cover hochgeladen, sowie Sammlung, Standort, KI-Erklärung, Trends und Events ergänzt. Die Fähigkeit ist plattformunabhängig und funktioniert mit jedem Video. Wichtig: Der Bot stoppt standardmäßig vor dem Klick auf den Veröffentlichungsbutton – der Nutzer muss das Video explizit freigeben. Nach der Veröffentlichung wird überprüft, ob das Video in der Liste erscheint und die Sammlungsfolgen stimmen. Die Fähigkeit wird über die SKILL.md-Dokumentation gesteuert, die detaillierte Plattformregeln, Referenzen und Skripte enthält. Sie ist ideal für Content-Ersteller, die mehrere Plattformen effizient bespielen möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/geoqiao/short-video-skills/tree/HEAD/skills/video-publish

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Kurzvideo veröffentlichen

In zwei Schritten: zuerst Text erstellen, dann Formular ausfüllen. Der Text wird in die post.md des jeweiligen Ausgabenverzeichnisses geschrieben (Struktur siehe references/post-template.md); beim Ausfüllen des Formulars wird er als Vorlage verwendet. Plattformregeln und Richtlinien sind in references/platform-rules.md festgehalten; vor der Veröffentlichung ist die Beitragsseite maßgeblich.

1. Text erstellen

Der Text wird anhand der Suchintention verfasst: Zuerst wird bestätigt, dass die Zuschauer genau diese Frage stellen und welche Bezeichnung sie verwenden. Titel, Cover-Text und erster Satz der Beschreibung sollten dieselbe Frage beantworten. Auf Douyin und Video Account stammt der Großteil des Traffics aus Empfehlungen und nicht aus der Suche – die Schlüsselwörter dienen hauptsächlich dazu, das Video den richtigen Personen zu präsentieren.

Zuerst Suchvorschläge abrufen

  1. Liste die Fragen auf, die dieses Video beantworten kann. Jede Frage entspricht einer Intention: Die Hauptfigur kennenlernen („Was ist X?“, „Ist X gut?“), Werkzeuge auswählen („X im Vergleich“, „Welches ist besser?“), Konzepte („Was bedeutet Begriff X?“), Handlungsanleitungen („Wie verwendet man X?“).
  2. Lies die Suchvorschläge, um zu bestätigen, dass die Zuschauer wirklich so suchen und welche Bezeichnung sie verwenden. Suchvorschläge haben kein Suchvolumen, sie zeigen nur, dass gesucht wird. Lies sie am Tag der Veröffentlichung erneut – verwende keine Ergebnisse, die Tage zuvor gespeichert wurden.
    • Douyin: Verbinde dich mit dem bereits eingeloggten Chrome (siehe unten „Browser verbinden“), öffne einen Tab mit www.douyin.com und wechsle dorthin. Ändere SEEDS in scripts/douyin-suggest.js und führe playwright-cli -s=chrome --raw run-code --filename=scripts/douyin-suggest.js aus.
    • Xiaohongshu: Öffne einen Tab mit www.xiaohongshu.com/explore, ändere SEEDS in scripts/xhs-suggest.js und führe es aus. Jedes Wort lädt die Seite neu, etwa 6 Sekunden pro Wort; maximal 25 Wörter auf einmal.
    • Google: node scripts/google-suggest.mjs '[["Seed-Wort","zh-CN"],["seed","en"]]' – kein Browser erforderlich.
    • Diese drei Skripte sind schreibgeschützt. Schließe nach der Nutzung nur die selbst geöffneten Tabs.
  3. Die Rohdaten werden mit Datum als JSON gespeichert; im Text wird auf den Dateinamen verwiesen.
  4. Die Hauptintention, die vollständig zum Inhalt passt, wird in Titel, Cover und ersten Satz der Beschreibung aufgenommen. Intentionen, die nur teilweise beantwortet werden (z. B. nur zwei Produkte verglichen, aber nach dem „Besten“ fragen), werden nur als Thema-Tag gesetzt – sonst scrollen die Zuschauer weiter. Fragen, die in den Suchvorschlägen wiederholt auftauchen, aber im Video nicht beantwortet werden, nicht erzwingen, sondern als neue Themenidee notieren.

Einige wiederholt bestätigte Erfahrungen:

  • Englische Begriffe als Hauptwörter führen oft nicht zu passendem Inhalt. Verwende für das Cover-Hauptwort die chinesische Formulierung, englische Begriffe in Beschreibung und Tags.
  • Wenn die Bezeichnung im Video von der der Zuschauer abweicht, passe Titel, Cover und Voice-Over an die Zuschauer an (z. B. suchen Zuschauer nach „上下文腐烂“, nicht nach „上下文腐化“).
  • Die Bezeichnungen auf den beiden Plattformen unterscheiden sich oft – verwende im Titel diejenige, die auf beiden Seiten vorkommt.

Wie man schreibt

  • Titel: Die Frage, die der Zuschauer stellt, plus eine konkrete Schlussfolgerung. Verwende die Suchbezeichnung der Zuschauer. Kein Begriff, den niemand sucht, gelangt in den Titel. Titel, Cover-Text und erster Satz des Voice-Overs behandeln dasselbe Thema.
  • Beschreibung: Erster Satz wiederholt die Frage des Titels und gibt eine Schlussfolgerung mit Zahl; dann Liste der im Video besprochenen Punkte mit den darin vorkommenden Entitätswörtern und Zahlen; abschließend die Einschränkungen der Datenquellen; bei KI-Verwendung eine KI-Erklärung (z. B. „Sprachausgabe per KI“). Schreiben für den Zuschauer, nicht über den Produktionsprozess.
  • Themen-Tags: Genaue Bezeichnung der Hauptfigur, verglichene Objekte, Kategorie-Wörter, ein großes, für die Zielgruppe relevantes Wort. Nur Wörter, die im Video tatsächlich vorkommen. Beim Ausfüllen im Veröffentlichungsformular #Wort eingeben, um die Aufrufzahl zu lesen – allgemeine Wörter mit Milliarden Aufrufen (z. B. #KI) sofort ersetzen. Douyin-Desktop maximal 5 Tags; Serienname in die Sammlung, nicht als Tag. Video Account kann ein oder zwei zusätzliche Tags haben, inklusive Seriennamen.
  • Pinned-Kommentar: Eine Frage, die der Zuschauer aus eigener Erfahrung beantworten kann, korrespondierend mit der Frage am Ende des Videos.
  • Cover-Text: Höchstens zwei Zeilen, Titel plus ein Haken mit Zahl oder Schlussfolgerung, Hauptwort in chinesischer Formulierung.
  • Weder URLs noch Konten außerhalb der Plattform erscheinen im Text, Cover, Voice-Over oder Bildmaterial. Keine Aufforderungen wie „Geh zur Webseite …“ oder „Suche …“. Kommentare, Follower und Sammlungen können eingeleitet werden.
  • Wird KI-Sprachausgabe, KI-Bilder oder ein digitaler Avatar verwendet, ist eine KI-Erklärung erforderlich; bei code-video ist die Sprachausgabe KI-synthetisiert, daher muss jedes damit erstellte Video eine solche Erklärung enthalten. Die Optionen der einzelnen Plattformen sind in references/platform-rules.md aufgeführt.

2. Formular ausfüllen

Selektoren, Fallstricke und Vorgehensweisen der einzelnen Plattformen:

  • Douyin Creator Center: references/douyin.md
  • Video Account Assistant: references/weixin.md
  • Xiaohongshu Creator Service Platform: references/xiaohongshu.md

Regeln

  • Nicht für den Nutzer veröffentlichen. Vor dem Veröffentlichungsbutton stoppen und auf Überprüfung durch den Nutzer warten. Nur wenn der Nutzer für dieses Video ausdrücklich „Veröffentlichen“ sagt, klicken; die Genehmigung für das vorherige Video gilt nicht für das nächste.
  • Nach dem Klicken auf Veröffentlichen prüfen, ob in der Werkliste das neue Video erscheint und Sammlungsfolge und Ausgabenummer stimmen, dann die Veröffentlichungszeit in post.md eintragen.
  • Bereits veröffentlichte Inhalte auf der Plattform weder ändern noch löschen, es sei denn, der Nutzer verlangt es.
  • Standort, Sammlung, Veranstaltungen – alles, was sich von Mal zu Mal ändern kann – bei Unklarheit den Nutzer fragen.
  • Nur selbst geöffnete Tabs schließen. Wenn in einem Tab noch nicht veröffentlichte Formulare vorhanden sind, diesen Tab nicht neu laden und keine anderen Skripte darauf ausführen.

Browser verbinden

Erfordert playwright-cli und die dazugehörige Chrome-Erweiterung; der Nutzer muss in Chrome bereits in den Creator-Backends der Plattformen eingeloggt sein.

playwright-cli -s=chrome attach --extension=chrome   # Der Nutzer klickt auf der Erweiterungsseite auf „Erlauben“
playwright-cli -s=chrome tab-new <URL der Veröffentlichungsseite>
playwright-cli -s=chrome tab-list
playwright-cli -s=chrome tab-select <Nummer>          # tab-new wechselt nicht das Ziel von run-code
playwright-cli -s=chrome --raw run-code --filename=<Skript.js>
playwright-cli -s=chrome screenshot --filename=<Bild.png>

Das Skript von run-code ist ein async page => { … }-Ausdruck; der Rückgabewert wird ausgegeben. Nach einer Trennung der Sitzung neu verbinden – zuvor geöffnete Tabs sind verschwunden, das Formular muss von vorne ausgefüllt werden.

Allgemeine Vorgehensweise

  • Jedes Skript beginnt mit await page.bringToFront(). Wenn der Nutzer gleichzeitig Chrome verwendet, wird die Veröffentlichungsseite oft in den Hintergrund geschoben; Drag-and-Drop und Klicks warten dann bis zum Timeout. Tastatureingaben, die vor dem Timeout in der Warteschlange stehen, werden nach Rückkehr der Seite in den Vordergrund nachgetragen und können die Beschreibung durcheinanderbringen. Bei Timeout zuerst das Beschreibungsfeld leeren und neu ausfüllen.
  • Ein Schritt pro Skript, nach jedem Schritt prüfen. Am Ende jedes Schrittes den innerText des relevanten Bereichs lesen oder einen Screenshot machen, um sicherzustellen, dass der Wert sich tatsächlich geändert hat, bevor der nächste Schritt ausgeführt wird.
  • Video hochladen: Zuerst playwright-cli -s=chrome drop "<Upload-Bereich-Selektor>" --path=<mp4> versuchen. Bei Plattformen, bei denen Drag-and-Drop keinen Upload auslöst, ein Injektionsskript aus scripts/ verwenden: Es konvertiert die Datei in base64, schreibt sie in ein run-code-Skript, platziert sie mit DataTransfer in den File-Input und löst change aus. Im Erweiterungsmodus sind setInputFiles und der Dateiauswahldialog nicht verwendbar.
  • Cover hochladen: Zuerst das Cover-Popup öffnen, dann das Injektionsskript ausführen. Alle drei Plattformen benötigen zwei Cover: 4:3 horizontal und 3:4 vertikal. Ein 16:9-Cover wird abgeschnitten und der Titel geht verloren.
  • Dropdown- und Suchfelder: Viele Eingabefelder sind nur sichtbar, wenn das Dropdown aufgeklappt ist. Wenn fill und click „element is not visible“ melden, zuerst das Feld klicken, das den aktuellen Wert anzeigt (ggf. mit boundingBox oder in evaluate die Koordinaten abrufen und mit page.mouse.click klicken), warten bis das Eingabefeld erscheint, dann eingeben. Bei Feldern, die eine Suche auslösen, muss keyboard.type Buchstabe für Buchstabe getippt werden; fill löst keine Suche aus.
  • Dropdown-Einträge präzise auswählen: Mit vollständiger Textübereinstimmung arbeiten, oder in evaluate nach einem Element suchen, dessen innerText exakt übereinstimmt und im Dropdown-Bereich sichtbar ist, dann die Koordinaten klicken. Bei partieller Textfilterung kann leicht der äußere Container ausgewählt und ein anderer Eintrag übernommen werden. Nach der Auswahl den aktuellen Wert erneut lesen.
  • Schaltflächen, die nur bei Hover erscheinen: Zuerst page.mouse.move auf die Karte, eine halbe Sekunde warten, dann auf die Position der Schaltfläche klicken.
  • Englische Optionen: Manche Plattformen zeigen Optionen auf Englisch an (z. B. Video-Markierung beim Video Account); nach dem tatsächlich auf der Seite angezeigten Text auswählen.

Nach der Veröffentlichung

Im Douyin-Datencenter unter „Suchbegriffe“ und der Traffic-Quelle den Suchanteil prüfen und mit den ausgewählten Wörtern vergleichen. Videos, bei denen die Schreibweise geändert wurde, notieren, damit bei späteren Vergleichen erkennbar ist, welche Änderung gewirkt hat. Tägliche Daten können mit dem Video-Data-Skill erfasst werden.

Bei der Übergabe zu erläutern

  • Welche Intention der Text bedient, welche Suchvorschläge verwendet wurden, welche nicht und warum.
  • Welche Werte pro Plattform ausgefüllt wurden: Titel, Anzahl der Themen-Tags, Cover, Sammlung und Folgen-Nummer, Standort, Erklärungen, Trends oder Veranstaltungen.
  • Bei welchem Schritt gestoppt wurde, welche Felder nicht oder nicht textkonform ausgefüllt wurden und warum.
  • Falls veröffentlicht: Veröffentlichungszeit, Prüfergebnis der Werkliste, Sammlungsfolgen.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills