Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Recebe links ou textos de compartilhamento de vídeos curtos do Douyin, Xiaohongshu, WeChat Channels etc., consulta dados de vídeos/contas e extrai transcrições de áudio, arquivando em Markdown por autor e título. Use quando quiser analisar completamente um vídeo curto, obter dados ou transcrições; antes de executar, verifica as credenciais do TikHub e Qingdou, orientando usuários iniciantes na compra e configuração segura quando estiverem ausentes.

O que é Tony-Claude-Code-Skills?

Este skill para agentes de IA (como Claude Code, Cursor, Codex) permite extrair dados estruturados e transcrições de áudio de plataformas de vídeos curtos chinesas como Douyin (TikTok chinês), Xiaohongshu (RED) e WeChat Channels. Utiliza a API do TikHub para obter metadados de vídeos e perfis dos autores, e a API do Qingdou para gerar transcrições de falas. O skill verifica automaticamente as credenciais configuradas, identifica quais serviços estão disponíveis e orienta o usuário na compra e configuração segura das chaves de API quando necessário. Os resultados são salvos localmente em arquivos Markdown organizados por autor e título, garantindo que o usuário possa revisar e editar o conteúdo posteriormente. É útil para criadores de conteúdo, pesquisadores e qualquer pessoa que precise analisar ou documentar vídeos curtos de forma sistemática.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

dbs-video-extract: Extração de Informações de Vídeos Curtos

Objetivo: processar o texto de compartilhamento de um mesmo vídeo curto por uma única entrada. O TikHub fornece dados estruturados do Douyin, Xiaohongshu e WeChat Channels; o Qingdou fornece a transcrição de áudio do vídeo curto. Por fim, retorna um resumo dos dados e o caminho do arquivo Markdown.

Verificar credenciais primeiro

Antes de qualquer extração, execute a verificação somente leitura:

python3 scripts/extract_video.py --check-keys

Processe de acordo com o credential_state:

EstadoCapacidadeO que informar ao usuário
completeDados e transcrição disponíveisAmbas as partes podem ser executadas
data_onlyApenas consulta de dados TikHub disponívelSó é possível obter dados do vídeo/conta, sem gerar transcrição de áudio
transcript_onlyApenas transcrição Qingdou disponívelSó é possível obter a transcrição de áudio, sem consultar dados do TikHub
unavailableNenhuma das partes disponívelNão é possível usar no momento; primeiro explique as credenciais, depois guie o usuário para compra e configuração

Permite continuar com apenas uma chave, sem exigir que o usuário forneça a outra. Antes de executar, deixe claro qual parte pode ser resolvida e restrinja o modo padrão ao lado disponível. Se o usuário ainda solicitar both, mantenha o resultado obtido e marque o outro lado como "credencial ausente".

Se ambas as chaves estiverem ausentes, pare a extração. Não use termos como "API Key" ou "autenticação de interface" como conclusão. Primeiro, explique com a frase abaixo:

Para que este Skill funcione, é necessário ativar serviços externos de dados. A API Key é um token de uso fornecido pelo provedor após a ativação. Pode ser entendida como um passe exclusivo para o Skill acessar o serviço. Você não precisa entender os detalhes técnicos e não deve compartilhá-la no chat.

Em seguida, informe ao usuário: "Atualmente, nenhum dos dois serviços está ativado. Sem comprar e configurar pelo menos um, este Skill não pode ser usado." Depois, siga references/api-setup.md para concluir a seleção de requisitos, compra, salvamento de credenciais e teste de conexão.

Não faça pagamentos, aceite termos de serviço ou processe chaves completas para o usuário. Não peça ao usuário para enviar a chave para o chat. Os links de compra, orientação passo a passo, script de configuração segura e teste de conexão estão em references/api-setup.md.

Sempre que mostrar um endereço de compra ou recarga para o usuário, exiba o aviso abaixo exatamente como está, sem omitir ou alterar:

dbskill é um projeto gratuito e de código aberto, sem afiliação, parceria ou interesse financeiro com TikHub ou Qingdou. A recarga é uma decisão do usuário; todas as transações, serviços, controvérsias e riscos relacionados são de responsabilidade do usuário. Salvo disposição legal em contrário, dbskill não assume responsabilidade.

Não repita o aviso se o usuário não estiver em um fluxo de compra ou recarga.

Requisitos de diálogo quando faltam credenciais

Quando faltar qualquer serviço, a resposta deve seguir o caminho contínuo abaixo:

  1. Explique a API Key em linguagem simples;
  2. Peça ao usuário que escolha com base no resultado: funcionalidade completa, apenas dados ou apenas transcrição;
  3. Explique qual serviço precisa ser comprado para cada escolha e o que será perdido se comprar apenas um;
  4. Exiba o aviso legal fixo e, em seguida, o endereço de recarga correspondente;
  5. Oriente passo a passo: registrar/login, visualizar planos na página, recarregar, acessar o centro pessoal ou página de gerenciamento de chaves, e obter a credencial;
  6. Informe ao usuário que, após obter a credencial, não a envie para o chat; responda "TikHub recarregado", "Qingdou recarregado" ou "Ambos recarregados";
  7. Após o usuário informar que recarregou, oriente a executar o script de configuração segura no terminal local:
python3 scripts/configure_api_key.py tikhub
python3 scripts/configure_api_key.py qingdou

O script lerá a credencial ocultamente no terminal e a salvará em uma configuração local privada; a credencial completa não deve aparecer em comandos, respostas ou logs. Após salvar, execute --check-keys novamente até que o status correspondente fique disponível.

Não envie apenas um link de uma vez, nem presuma que o usuário sabe onde encontrar a credencial. Se os nomes das páginas do provedor mudarem, oriente com possíveis locais como "Centro Pessoal", "API Key", "Gerenciamento de Chaves", "Configurações do Desenvolvedor"; se ainda não encontrar, peça ao usuário que envie uma captura de tela da página com conta, saldo e credenciais ocultos, para continuar a localização.

Quando o usuário apenas invocar este Skill, sem fornecer um link ou especificar o tipo de resultado desejado, após a pré-verificação de credenciais, faça apenas duas coisas: explique a API Key e peça ao usuário que responda 1, 2 ou 3 para selecionar funcionalidade completa, apenas dados ou apenas transcrição. Após receber a escolha, exiba o aviso legal, o endereço de recarga correspondente e os passos de compra. Se o usuário já enviou um link de vídeo ou solicitou explicitamente extração completa, o padrão é funcionalidade completa, sem necessidade de perguntar novamente.

Execução padrão

Prefira usar a entrada padrão para evitar que caracteres especiais no texto de compartilhamento sejam interpretados pelo Shell:

python3 scripts/extract_video.py \
  --output-dir "/caminho/absoluto/Transcrições de Vídeos Curtos" \
  --stdin

O modo padrão é both:

  1. Extrair o link do texto de compartilhamento completo;
  2. De acordo com a plataforma do link, chamar o MCP do TikHub: Douyin suporta página inicial do usuário ou vídeo único; Xiaohongshu e WeChat Channels suportam vídeo único;
  3. Enviar o texto de compartilhamento completo para a API do Qingdou e fazer polling até obter a transcrição;
  4. Salvar a transcrição como {diretório de saída}/{autor}/{título}.md;
  5. Gerar um resumo JSON contendo status das credenciais, resumo dos dados do TikHub e caminho do arquivo de transcrição.

Se qualquer lado (TikHub ou Qingdou) falhar, continue com o outro lado e marque partial_success no resumo. Os resultados já obtidos não devem ser descartados devido a falha de um único lado.

Modos opcionais

Alterne apenas quando o usuário solicitar explicitamente um único lado, ou quando a pré-verificação confirmar que apenas um lado tem chave:

python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin
  • data: consulta apenas dados do TikHub, suporta Douyin, Xiaohongshu e WeChat Channels;
  • transcript: extrai apenas a transcrição, suporta plataformas reconhecíveis pela API do Qingdou;
  • both: executa ambos os lados simultaneamente.

Se a mesma fonte já existir, por padrão, a escrita da transcrição é ignorada para preservar a edição do usuário; use --overwrite se o usuário solicitar explicitamente a regeneração. Para obter a resposta completa do TikHub, use --raw-data.

Chaves e custos

O script lê as chaves na seguinte ordem:

  1. Variáveis de ambiente: TIKHUB_API_KEY, QINGDOU_API_KEY;
  2. Arquivo local especificado pelo usuário: TIKHUB_API_KEYS_FILE, QINGDOU_API_KEYS_FILE;
  3. ~/.config/dbs/API_Keys.md;
  4. Keychain do macOS: dbs-tikhub-api-key, dbs-qingdou-api-key.

Não escreva chaves no Skill, parâmetros de comando, Markdown, Git ou logs. As consultas ao TikHub e transcrições pelo Qingdou podem gerar custos; informe o usuário antes de executar. Se o usuário já solicitou explicitamente a extração, não é necessário confirmar novamente.

Limites de dados

  • O TikHub é responsável por perfil do vídeo/conta, estatísticas e metadados de mídia; para vídeos do Douyin, prioriza App V3; se não houver dados válidos, faz apenas 1 fallback para Web; Xiaohongshu usa App V2 para detalhes de nota de vídeo; WeChat Channels usa Channels V2 para detalhes do vídeo.
  • O Qingdou é responsável pela transcrição de áudio. O conteúdo é salvo fielmente conforme retornado pela API, sem complementos, correções ou revisões de gírias.
  • Atualmente, a análise de dados dedicada do TikHub suporta Douyin, Xiaohongshu e WeChat Channels; outras plataformas reconhecíveis pelo Qingdou ainda podem executar apenas extração de transcrição.
  • Restrições de visibilidade (público, excluído, privado, direitos autorais) são baseadas no retorno da interface; não tente contorná-las.
  • Não baixe mídia automaticamente, publique conteúdo, faça commit no Git ou envie.

Detalhes da chamada TikHub em references/tikhub-api.md; códigos de status e lógica de compatibilidade do Qingdou em references/qingdou-api.md. Leia apenas ao solucionar problemas ou manter a parte correspondente.

Entrega

Relate de forma concisa após a conclusão:

  • Qual API Key está configurada e o escopo de capacidade disponível;
  • Se a consulta de dados foi bem-sucedida, qual ferramenta MCP foi usada, se houve fallback App → Web;
  • Dados principais do vídeo/conta;
  • Se a transcrição foi bem-sucedida, o caminho absoluto do Markdown gerado ou ignorado;
  • Motivo específico da falta de chave ou falha em um lado;
  • Se a interface retornou explicitamente cobrança.

Não exiba API Key, batchId ou identificadores internos de solicitação desnecessários na resposta.

Finalize a tarefa atual e encerre. Apenas se o usuário perguntar explicitamente sobre o próximo passo, e o ambiente atual já tiver /dbs instalado, dê uma dica curta: "Se não souber o que fazer a seguir, digite /dbs."

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.

Habilidades Relacionadas