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:
| Status | Fähigkeit | Muss dem Benutzer mitgeteilt werden |
|---|---|---|
complete | Daten und Transkript verfügbar | Beide Teile können ausgeführt werden |
data_only | Nur TikHub-Daten-Abfrage verfügbar | Kann nur Werbe-/Account-Daten abrufen, kein Sprachtranskript generieren |
transcript_only | Nur Qingdou-Transkript verfügbar | Kann nur Sprachtranskript abrufen, keine TikHub-Werbe-/Account-Daten abfragen |
unavailable | Beide Teile nicht verfügbar | Derzeit 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:
- Zuerst den API-Key in einfachen Worten erklären;
- Den Benutzer je nach Ergebnis wählen lassen: vollständige Funktion, nur Daten, nur Transkript;
- Jede Wahl mit dem zu kaufenden Dienst und den Einschränkungen bei nur einem Dienst erklären;
- Den festen rechtlichen Hinweis anzeigen, dann die entsprechende Aufladungsadresse;
- Schrittweise Registrierung/Login, Ansicht der Seitenpakete, Aufladung, Zugang zum persönlichen Bereich oder zur Schlüsselverwaltung und Beschaffung des Nachweises erklären;
- Dem Benutzer mitteilen, dass er den Nachweis nicht in den Chat senden, sondern mit „TikHub aufgeladen“, „Qingdou aufgeladen“ oder „Beide aufgeladen“ antworten soll;
- 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:
- Aus dem vollständigen Teilungstext den Link extrahieren;
- Je nach Link-Plattform TikHub MCP aufrufen: Douyin unterstützt Benutzerprofil oder einzelnes Werk, Xiaohongshu und Channels unterstützen einzelne Videos;
- Den vollständigen Teilungstext an die Qingdou-API übermitteln und durch Polling das Transkript abrufen;
- Das Transkript nach
{Ausgabeverzeichnis}/{Autor}/{Titel}.mdspeichern; - 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:
- Umgebungsvariablen:
TIKHUB_API_KEY,QINGDOU_API_KEY; - Vom Benutzer angegebene lokale Dateien:
TIKHUB_API_KEYS_FILE,QINGDOU_API_KEYS_FILE; ~/.config/dbs/API_Keys.md;- 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.“