Communitygithub.com

dbs-video-extract:短视频信息提取

Empfange Kurzvideo-Links oder Teilungs-Text von Douyin, Xiaohongshu, WeChat Channels usw., rufe Werbe-/Account-Daten ab, extrahiere Sprachtranskripte und archiviere sie als Markdown nach Autor und Titel.

Was ist dbs-video-extract:短视频信息提取?

Dieses Skill (dbs-video-extract) ist ein umfassendes Werkzeug für Entwickler und Power-User, um strukturierte Daten und Sprachtranskripte aus chinesischen Kurzvideo-Plattformen wie Douyin (TikTok China), Xiaohongshu (RED) und WeChat Channels zu extrahieren. Es kombiniert die TikHub-API für Metadaten (Benutzerprofile, Statistiken, Medieninfo) mit der Qingdou-API für Sprach-zu-Text-Transkription. Das Skill erfordert gültige API-Schlüssel für beide Dienste, führt vor der Ausführung eine Prüfung durch und leitet Benutzer bei fehlenden Schlüsseln durch einen sicheren Einrichtungsprozess, ohne dass sensible Daten im Chat preisgegeben werden. Die Ausgabe ist ein JSON-Report mit einer Zusammenfassung der TikHub-Daten und dem Pfad zur gespeicherten Markdown-Datei, die das Transkript enthält. Es unterstützt die Modi 'data' (nur TikHub), 'transcript' (nur Qingdou) und 'both' (Standard), und ist ideal für Content-Analyse, Datensammlung und KI-gestützte Verarbeitung von Kurzvideos.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/dbs-video-extract

In Ihrer bevorzugten KI fragen

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

Dokumentation

dbs-video-extract:Kurzvideo-Informations-Extraktion

Ziel: Mit einem einzigen Einstiegspunkt den Teilungstext eines Kurzvideos verarbeiten. TikHub liefert strukturierte Daten von Douyin, Xiaohongshu und WeChat Channels; Qingdou liefert das Sprachtranskript des Kurzvideos. Das Ergebnis ist eine Datenzusammenfassung und der Pfad zur Markdown-Datei mit dem Transkript.

Zuerst die Nutzungsnachweise prüfen

Vor Beginn jeder Extraktion führe folgende schreibgeschützte Vorprüfung aus:

python3 scripts/extract_video.py --check-keys

Verarbeite basierend auf credential_state:

StatusFähigkeitMuss dem Benutzer mitgeteilt werden
completeDaten und Transkript verfügbarBeide Teile können ausgeführt werden
data_onlyNur TikHub-Daten-Abfrage verfügbarKann nur Werbe-/Account-Daten abrufen, kein Sprachtranskript generieren
transcript_onlyNur Qingdou-Transkript verfügbarKann nur Sprachtranskript abrufen, keine TikHub-Werbe-/Account-Daten abfragen
unavailableBeide Teile nicht verfügbarDerzeit keine Nutzung möglich; zuerst die Nutzungsnachweise erklären, dann den Benutzer durch den Kauf und die Konfiguration führen

Wenn nur ein Key vorhanden ist, darf fortgefahren werden; es wird nicht verlangt, dass der Benutzer den anderen Key ergänzt. Vor der Ausführung klarstellen, welcher Teil gerade gelöst werden kann, und den Modus standardmäßig auf die verfügbare Seite eingrenzen. Wenn der Benutzer dennoch both fordert, das Ergebnis der einzelnen Seite beibehalten und die andere Seite als fehlenden Nachweis markieren.

Wenn beide Keys fehlen, die Extraktion stoppen. Verwende nicht direkt Begriffe wie „API-Key“ oder „Schnittstellenauthentifizierung“ als Schlussfolgerung. Erkläre es zuerst mit folgendem Satz:

Damit dieses Skill funktioniert, muss zuerst ein externer Datendienst aktiviert werden. Der API-Key ist ein vom Dienstanbieter nach der Aktivierung bereitgestellter Nutzungsnachweis, den man sich als speziellen Passierschein für diesen Skill vorstellen kann. Du musst die technischen Details nicht verstehen; gib ihn auch nicht im Chat preis.

Teile dem Benutzer anschließend mit: „Derzeit sind beide Dienste nicht aktiviert. Wenn mindestens einer nicht gekauft und konfiguriert wird, kann dieses Skill nicht genutzt werden.“ Folge dann der Anleitung in references/api-setup.md, um die Bedarfsauswahl, den Kauf, die Speicherung der Nachweise und den Verbindungstest durchzuführen.

Bezahle nicht für den Benutzer, akzeptiere keine Service-Vereinbarungen und verarbeite keine vollständigen Keys. Verlange nicht, dass der Benutzer Keys in den Chat schickt. Kaufportal, schrittweise Anleitung, sicheres Konfigurationsskript und Verbindungstest finden sich in references/api-setup.md.

Wenn du dem Benutzer eine Kauf- oder Aufladungsadresse zeigst, musst du zuerst den folgenden Hinweis unverändert und vollständig anzeigen, ohne Auslassungen oder Änderungen:

dbskill ist ein kostenloses Open-Source-Projekt und steht in keiner Verbindung, Kooperation oder finanziellen Beziehung zu TikHub oder Qingdou. Aufladungen erfolgen nach eigenem Ermessen des Benutzers; damit verbundene Transaktionen, Dienste, Streitigkeiten und Risiken trägt der Benutzer selbst. Sofern gesetzlich nichts anderes bestimmt ist, übernimmt dbskill keine Haftung.

Wenn der Benutzer nicht zur Kauf- oder Aufladungsaufforderung gelangt, diesen Hinweis nicht wiederholt anzeigen.

Gesprächsanforderungen bei fehlenden Nachweisen

Wenn ein Dienst fehlt, muss die Antwort den folgenden durchgehenden Pfad bilden:

  1. Zuerst den API-Key in einfachen Worten erklären;
  2. Den Benutzer je nach Ergebnis wählen lassen: vollständige Funktion, nur Daten, nur Transkript;
  3. Jede Wahl mit dem zu kaufenden Dienst und den Einschränkungen bei nur einem Dienst erklären;
  4. Den festen rechtlichen Hinweis anzeigen, dann die entsprechende Aufladungsadresse;
  5. Schrittweise Registrierung/Login, Ansicht der Seitenpakete, Aufladung, Zugang zum persönlichen Bereich oder zur Schlüsselverwaltung und Beschaffung des Nachweises erklären;
  6. Dem Benutzer mitteilen, dass er den Nachweis nicht in den Chat senden, sondern mit „TikHub aufgeladen“, „Qingdou aufgeladen“ oder „Beide aufgeladen“ antworten soll;
  7. Nach der Antwort des Benutzers über die Aufladung ihn anleiten, das sichere Konfigurationsskript im lokalen Terminal auszuführen:
python3 scripts/configure_api_key.py tikhub
python3 scripts/configure_api_key.py qingdou

Das Skript liest den Nachweis unbehelligt im Terminal ein und speichert ihn in der lokalen privaten Konfiguration. Der vollständige Nachweis darf nicht im Befehl, in der Antwort oder im Log erscheinen. Nach dem Speichern erneut --check-keys ausführen, bis der entsprechende Status als verfügbar angezeigt wird.

Sende nicht nur einen Link auf einmal und nimm nicht an, der Benutzer wisse, wo er den Nachweis findet. Wenn sich die Seitenbezeichnungen des Dienstanbieters ändern, mit Kandidatenpositionen wie „Persönlicher Bereich“, „API-Key“, „Schlüsselverwaltung“, „Entwicklereinstellungen“ führen. Wird der Nachweis dennoch nicht gefunden, den Benutzer bitten, einen Screenshot der Seite zu senden, auf dem Konto, Guthaben und Nachweise unkenntlich gemacht wurden, und dann weiterleiten.

Wenn der Benutzer das Skill nur aufruft, aber noch keinen Link oder gewünschten Ergebnistyp angegeben hat, nach Abschluss der Nachweisvorprüfung nur zwei Dinge tun: den API-Key erklären und den Benutzer bitten, zur Auswahl zwischen vollständiger Funktion, nur Daten oder nur Transkript mit 1, 2 oder 3 zu antworten. Nach Erhalt der Auswahl den rechtlichen Hinweis, die entsprechende Aufladungsadresse und die Kaufschnitte anzeigen. Hat der Benutzer bereits einen Videolink gesendet oder eine vollständige Extraktion gefordert, standardmäßig die vollständige Funktion wählen, ohne erneute Rückfrage.

Standardausführung

Bevorzuge die Standardeingabe, um Sonderzeichen im Teilungstext vor der Shell-Interpretation zu schützen:

python3 scripts/extract_video.py \
  --output-dir "/absoluter/Pfad/Kurzvideo-Transkripte" \
  --stdin

Der Standardmodus ist both:

  1. Aus dem vollständigen Teilungstext den Link extrahieren;
  2. Je nach Link-Plattform TikHub MCP aufrufen: Douyin unterstützt Benutzerprofil oder einzelnes Werk, Xiaohongshu und Channels unterstützen einzelne Videos;
  3. Den vollständigen Teilungstext an die Qingdou-API übermitteln und durch Polling das Transkript abrufen;
  4. Das Transkript nach {Ausgabeverzeichnis}/{Autor}/{Titel}.md speichern;
  5. Eine JSON-Zusammenfassung ausgeben mit dem Nachweisstatus, der TikHub-Datenzusammenfassung und dem Dateipfad des Transkripts.

Wenn eine Seite (TikHub oder Qingdou) fehlschlägt, die andere Seite dennoch abschließen und in der Zusammenfassung mit partial_success markieren. Bereits gewonnene Ergebnisse dürfen aufgrund eines einseitigen Fehlschlags nicht verworfen werden.

Optionale Modi

Nur wenn der Benutzer explizit nur einseitige Ergebnisse wünscht oder die Vorprüfung nur einen Key bestätigt, wechsle zu:

python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin
  • data: Nur TikHub-Daten abfragen (unterstützt Douyin, Xiaohongshu und WeChat Channels);
  • transcript: Nur Transkript extrahieren (unterstützt Plattformen, die von der Qingdou-API geparst werden können);
  • both: Beide Seiten gleichzeitig ausführen.

Wenn dasselbe Werk bereits existiert, wird das Schreiben des Transkripts standardmäßig übersprungen, um Benutzerbearbeitungen zu schützen. Bei expliziter Aufforderung des Benutzers zur Neuerstellung --overwrite hinzufügen. Wenn die vollständige TikHub-Antwort benötigt wird, --raw-data hinzufügen.

Schlüssel und Kosten

Das Skript liest die Keys in folgender Reihenfolge:

  1. Umgebungsvariablen: TIKHUB_API_KEY, QINGDOU_API_KEY;
  2. Vom Benutzer angegebene lokale Dateien: TIKHUB_API_KEYS_FILE, QINGDOU_API_KEYS_FILE;
  3. ~/.config/dbs/API_Keys.md;
  4. macOS Keychain: dbs-tikhub-api-key, dbs-qingdou-api-key.

Es ist verboten, die Keys ins Skill, in Befehlsargumente, in Markdown, in Git oder in Logs zu schreiben. Sowohl TikHub-Abfragen als auch Qingdou-Transkriptionen können Kosten verursachen; informiere den Benutzer vor der Ausführung. Wenn der Benutzer bereits explizit die Extraktion gefordert hat, ist keine erneute Bestätigung erforderlich.

Datengrenzen

  • TikHub ist verantwortlich für Werk-/Account-Profile, Statistiken und Medienmetadaten. Bei Douyin-Werken wird zuerst App V3 priorisiert; bei fehlenden gültigen Daten wird nur 1 Mal auf Web zurückgegriffen. Xiaohongshu nutzt App V2 Videodetail. Channels nutzt Channels V2 Werkdetail.
  • Qingdou ist verantwortlich für Sprachtranskripte. Der Text wird originalgetreu wie von der API zurückgegeben gespeichert, ohne Ergänzungen, Glättung oder Korrekturen von Versprechern.
  • Derzeit unterstützt die dedizierte Datenanalyse von TikHub Douyin, Xiaohongshu und WeChat Channels. Andere von Qingdou erkennbare Plattformen können weiterhin nur die Transkriptextraktion durchführen.
  • Beschränkungen der Sichtbarkeit von öffentlichen, gelöschten, privaten, urheberrechtlich geschützten und zugänglichen Inhalten richten sich nach der API-Antwort; es wird nicht versucht, sie zu umgehen.
  • Es wird nicht automatisch Medien heruntergeladen, Inhalte veröffentlicht, Git gepusht oder Änderungen übertragen.

Details zum TikHub-Aufruf finden sich in references/tikhub-api.md; Qingdou-Statuscodes und Kompatibilitätslogik in references/qingdou-api.md. Lies diese nur bei der Fehlerbehebung oder Wartung des entsprechenden Teils.

Übergabe

Nach Abschluss kurz berichten:

  • Welcher API-Key aktuell konfiguriert ist und der Umfang der verfügbaren Fähigkeiten;
  • Ob die Datenabfrage erfolgreich war, welches MCP-Tool verwendet wurde und ob ein App → Web-Fallback stattgefunden hat;
  • Wichtige Werk-/Account-Daten;
  • Ob das Transkript erfolgreich war, der absolute Pfad der erstellten oder übersprungenen Markdown-Datei;
  • Konkrete Gründe für fehlende Keys oder fehlgeschlagene Ausführung auf einer Seite;
  • Ob die Schnittstelle explizit eine Abrechnung zurückgemeldet hat.

Zeige in der Antwort keine API-Keys, batchId oder unnötige interne Anfragekennungen an.

Beende die Aufgabe direkt nach Abschluss der aktuellen Anforderung. Nur wenn der Benutzer explizit nach dem nächsten Schritt fragt und /dbs bereits in der Umgebung installiert ist, gib den kurzen Hinweis: „Wenn du unsicher über den nächsten Schritt bist, kannst du /dbs eingeben.“

Individual skills in this repo

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

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Verwandte Skills