Solução de problemas
Diagnostique e resolva problemas comuns sem suporte.
Rede / timeout de conexão
- •Firewall bloqueando HTTPS de saída para api.whisperx.ai
- •Problemas de roteamento VPN
- •Configuração incorreta de DNS
Teste a conectividade passo a passo:
# 1. DNS resolution nslookup api.whisperx.ai # 2. TCP port 443 nc -zv api.whisperx.ai 443 # 3. HTTPS GET curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"
Se o passo 1 falhar: verifique as configurações DNS. Se o passo 2 falhar: o firewall está bloqueando a porta 443 — contate o administrador de rede. Se o passo 3 falhar: problema TLS — certifique-se de ter certificados raiz atualizados.
Resultados vazios
- •Consulta específica demais ou de nicho
- •Filtro de tags muito restritivo
- •A data since é recente demais
- •Filtro de setor exclui intel relevante
Tente consultas progressivamente mais amplas:
# Remove tag filter curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10" # Remove sector filter curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10" # Extend time window (no since filter) curl "https://api.whisperx.ai/api/intel?q=funding&limit=10" # Try trending tags to see what's active curl "https://api.whisperx.ai/api/tags/trending?limit=20"
Resultados vazios não são erro — significam que nenhuma intel corresponde aos seus filtros agora. A plataforma cresce diariamente; tente novamente amanhã ou amplie a busca.
429 — Limite de taxa
- •Mais de 60 chamadas API por minuto do mesmo IP
- •Loop automatizado sem pausa entre requisições
- •Vários agentes compartilhando uma conexão
Reduza a frequência das requisições:
- • Aguarde 60 segundos antes de tentar novamente
- • Adicione sleep 2 entre requisições nos scripts
- • Reduza o parâmetro limit (tente 5–10 em vez de 50)
- • Cache as tags em alta — mudam lentamente, sem necessidade de polling a cada minuto
Se precisar de limites de taxa mais altos para produção, fale conosco.
5xx — Erro do servidor
- •Erro transitório no servidor de origem
- •Cold start do worker sob carga
- •Banco de dados temporariamente indisponível
Estratégia de nova tentativa:
# Retry once after 10 seconds sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1" # If 5xx persists, fall back to trending tags (lighter endpoint) curl "https://api.whisperx.ai/api/tags/trending?limit=10"
Se os erros persistirem por mais de 5 minutos, verifique whisperx.ai para atualizações de status. A maioria dos problemas se resolve em minutos.
Respostas lentas / timeouts
- •Busca semântica ativada (varredura completa da tabela — muito custosa)
- •Parâmetro limit muito alto (>50)
- •Latência de rede ao edge do Cloudflare
Certifique-se de que a busca semântica está desativada e reduza o limit:
# Good: keyword search, compact mode, small limit curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10" # Bad: semantic search (avoid — full-table scan) # /api/intel?semantic=... ← do NOT use this
A Skill WhisperX desativa automaticamente a busca semântica. Se chamar a API diretamente, nunca use o parâmetro semantic em produção.
Skill não encontrada / ferramentas não carregando
- •Skill instalada no diretório errado
- •SKILL.md ausente ou vazio
- •Scripts shell sem permissão de execução
- •Variável de ambiente WHISPERX_BASE_URL configurada incorretamente
Verifique sua instalação:
# Check skill files exist ls ~/.claude/skills/whisperx/ # Expected: SKILL.md tools/ ls ~/.claude/skills/whisperx/tools/ # Expected: search.sh get.sh trending.sh trends.sh connections.sh export.sh # Check scripts are executable ls -la ~/.claude/skills/whisperx/tools/*.sh # Should show -rwxr-xr-x permissions # Fix permissions if needed chmod +x ~/.claude/skills/whisperx/tools/*.sh # Quick smoke test bash ~/.claude/skills/whisperx/tools/trending.sh 5
Ainda não funciona? Refaça a instalação a partir do guia de início rápido.
Gerar relatório de diagnóstico
Se ainda estiver com problemas, execute isto para gerar um pacote de diagnóstico compartilhável (sem dados sensíveis):
echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
"https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"Cole o resultado ao solicitar suporte. Não inclui seu IP, consultas ou chaves.