Quando Usar

Use quando uma tarefa precisa de uma foto/clipe REAL ou DE ARQUIVO (herói, textura, referência, filmagem histórica) ou uma reação/GIF animado, em vez de um gerado — pesquise em fontes gratuitas de imagens/vídeos/GIFs em uma única consulta e baixe resultados com tags de licença.

Fonte: connerkward/web-media-getter-skill (MIT).

web-media

Consulte várias fontes gratuitas de imagens/vídeos em uma única pesquisa distribuída, obtenha uma lista de resultados normalizada, opcionalmente baixe os top-K com um arquivo lateral de atribuição. Script stdlib sem dependências.

Script: webmedia.py (neste diretório). Chaves: PEXELS_API_KEY, PIXABAY_API_KEY em central/.env (opcional — as 5 fontes sem chave funcionam sem elas).

Fontes

Fontes de GIF são acionadas apenas com --type gif. Chaves: KLIPY_API_KEY, GIPHY_API_KEY em central/.env. (adaptador do tenor removido — Google descontinuou a API em 30/06/2026). klipy é o que você quer (gratuito + ilimitado); seu adaptador é não verificado — assume solicitação/resposta compatível com Tenor; verifique contra docs.klipy.com ao configurar sua chave. webmedia.py "shrug" --type gif --count 6 --json

Uso

webmedia.py "1950s street scene" --type image --count 8 --json
webmedia.py "rocket launch" --type video --source nasa,internetarchive
webmedia.py "car factory 1930s" --source all --download --out /tmp/cars

• --source all (padrão) | nokey (apenas sem chave) | lista separada por vírgula (wikimedia,pexels)
• --type image|video · --count N · --json · --download --out DIR
• --download busca a URL de mídia direta de cada resultado e escreve attribution.json (fonte, autor, licença, url, url_da_página) ao lado dos arquivos.

Esquema do registro

{source, title, url, thumb, dl, page_url, author, license, w, h, type} — dl é a URL de mídia diretamente baixável (Nulo quando existe apenas uma página).

A ressalva do vídeo (importante)

Fontes de arquivo (Internet Archive, Europeana, LoC) hospedam filmes/documentários completos, não tomadas únicas. Portanto:

• Clipe único moderno → pexels / pixabay (criados como clipes curtos, MP4 direto). Pronto.
• Tomada única histórica → recupere o filme do IA aqui e, em seguida, extraia a tomada:
  • Pesquisa Marengo da Twelve Labs (600 min gratuitos) — passe a URL pública do MP4 do IA, obtenha um momento com timestamp para "carro na linha de montagem", corte com ffmpeg. Semântico, barato.
  • ou PySceneDetect (gratuito, local) para cortar o filme em tomadas, e então classificar keyframes com CLIP através da habilidade muser. Totalmente offline.

Áudio: freesound + QA de áudio

webmedia.py é imagem/vídeo. Para efeitos sonoros (reais, licenciados por CC) e para julgar áudio (já que Claude não pode ouvir), dois scripts irmãos residem em central/scripts/:

• freesound-fetch.py "<query>" [count] [max_sec] [out_dir] — pesquisa freesound.org e baixa prévias curtas em mp3 de alta qualidade. Imprime uma linha JSON por arquivo com license/user para atribuição. Chave: FREESOUND_API_KEY em central/.env (leitura baseada em token; originais completos exigiriam OAuth — prévias são suficientes para SFX).
• audio-judge.py <file> "<target>" — envia o clipe para o gpt-audio da OpenAI (nativo de áudio) e retorna JSON {heard, score, matches, suggestion}, permitindo um loop de gerar/buscar → julgar → iterar. Busca automaticamente um sk- OPENAI_API_KEY real de .env (ignora uma variável de ambiente stub lm-studio local). Preenche clipes com menos de 2 segundos para que o modelo ajustado para fala não recuse. Ressalva: ele descreve áudio de forma confiável e filtra incompatibilidades óbvias, mas NÃO é um juiz confiável de qualidades subjetivas como "irritante" — ele rotula quase qualquer bipe como "agudo/de alta frequência". Use-o para filtrar, não para fazer a chamada estética final; confirme de ouvido.

Onde isso se encaixa

Esta é a capacidade de recuperação da internet — par à muser (pesquisa semântica local)

…