Analisador de TikTok

O que Analisador de TikTok faz?

O Claude não consegue assistir vídeos ou abrir links do TikTok, mas consegue ler imagens e texto. Esta skill converte o vídeo em ambos: uma transcrição com timestamps, quadros uniformemente espaçados e os metadados da postagem. Então você os lê e responde.

Etapas

1. Execute o extrator (funciona para uma URL ou um caminho de vídeo local). <skill-dir> é a pasta que contém este SKILL.md, onde quer que a skill esteja instalada:

   python "<skill-dir>/scripts/extract.py" "<url-ou-arquivo>" "<diretorio-saida>"
   

   Se o script falhar por falta de pacote, instale as dependências uma vez com python -m pip install -r "<skill-dir>/requirements.txt". Use o scratchpad ou um diretório temporário para <diretorio-saida>, não o projeto do usuário. Argumentos opcionais: max frames (padrão 24), modelo Whisper (padrão base; use small se a fala for ruidosa, com sotaque ou não-inglesa). A primeira execução baixa o modelo Whisper, então reserve alguns minutos.
2. Leia metadata.json (legenda, autor, data, hashtags, contagens, som), depois transcript.txt.
3. Leia os quadros em frames/ com a ferramenta Read, em ordem. Os nomes dos arquivos carregam o timestamp (t0012.3s.jpg), então você pode alinhar cada quadro com a transcrição. Os quadros são importantes porque grande parte da informação do TikTok é texto embutido, fotos de produtos, gráficos e demonstrações que nunca são falados.
4. Responda à pergunta real do usuário. Para extração de fatos, separe o que foi dito (transcrição), mostrado (quadros, incluindo texto na tela) e afirmado na legenda. Cite timestamps para que o usuário possa verificar a fonte.

Regras para análise honesta

• Os quadros são amostras, cerca de um a cada 2 segundos. Não afirme que algo estava ausente do vídeo, apenas que não apareceu nos quadros amostrados ou na transcrição. Para um momento específico, execute novamente com um número maior de quadros.
• O Whisper comete erros em nomes, marcas, números e gírias. Sinalize qualquer fato que dependa de uma palavra ou número transcrito e verifique-o com o texto na tela.
• Um criador dizer algo não é evidência de que é verdade. Quando o usuário quiser verificação de fatos, liste as alegações, marque quais são verificáveis e verifique com uma pesquisa na web, em vez de repetir a alegação como fato.
• O Whisper frequentemente entende mal nomes de produtos (nos testes, ouviu "Claude" como "nuvem" toda vez). Use o contexto e o texto na tela para corrigir esses erros e diga que o fez.
• As contagens de engajamento e legendas são contexto, não vereditos.

Quando falha

• Carrosséis de fotos / apresentações de slides: o yt-dlp pode não baixá-los. Peça ao usuário para gravar a tela ou salvar o vídeo e depois passar o caminho do arquivo.
• Vídeos com login, privados, bloqueados por região ou deletados: o download falha. Peça um arquivo salvo.
• "Resposta inesperada da solicitação de página da web": o bot do TikTok precisa de personificação de navegador. Execute python -m pip install -U "yt-dlp[curl-cffi]" e tente novamente. Isso foi necessário no primeiro teste real.
• HTTP 403 ou outros erros do extrator: o TikTok muda com frequência. Execute python -m pip install -U yt-dlp e tente novamente uma vez.
• Sem fala: a transcrição fica vazia, confie nos quadros e na legenda e avise.
• Pacotes ausentes: python -m pip install -r "<skill-dir>/requirements.txt" (ffmpeg está incluído através do imageio-ffmpeg, sem necessidade de instalação no sistema).