Communitygithub.com

V4TIME/V4SKILL

Busca/descarga GIFs desde Tenor usando curl + jq.

¿Qué es V4SKILL?

Esta habilidad permite buscar y descargar GIFs directamente desde la API de Tenor utilizando únicamente `curl` y `jq`, sin necesidad de herramientas adicionales. Es útil para encontrar GIFs de reacción, crear contenido visual o enviar GIFs en chats. Funciona en cualquier sistema con `curl` y `jq` estándar (macOS/Linux) y requiere configurar una clave de API gratuita de Tenor. La habilidad proporciona ejemplos de búsqueda, descarga y metadatos, además de documentar parámetros como el límite de resultados, filtros de contenido y formatos disponibles (GIF completo, vista previa, video MP4, etc.).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/media/gif-search

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

alt

Documentación

Búsqueda de GIFs (API de Tenor)

Busca y descarga GIFs directamente a través de la API de Tenor usando curl. No se necesitan herramientas adicionales.

Cuándo usarlo

Útil para encontrar GIFs de reacción, crear contenido visual y enviar GIFs en chats.

Configuración

Establece tu clave de API de Tenor en tu entorno (agrega a ${HERMES_HOME:-~/.hermes}/.env):

TENOR_API_KEY=tu_clave_aqui

Obtén una clave de API gratuita en https://developers.google.com/tenor/guides/quickstart: la clave de API de Tenor de Google Cloud Console es gratuita y tiene límites generosos.

Requisitos previos

  • curl y jq (ambos estándar en macOS/Linux)
  • Variable de entorno TENOR_API_KEY

Buscar GIFs

# Buscar y obtener URLs de GIF
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Obtener versiones más pequeñas/vista previa
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Descargar un GIF

# Buscar y descargar el primer resultado
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif

Obtener metadatos completos

curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'

Parámetros de la API

ParámetroDescripción
qConsulta de búsqueda (codificar espacios como +)
limitMáximo de resultados (1-50, por defecto 20)
keyClave de API (de la variable de entorno $TENOR_API_KEY)
media_filterFiltrar formatos: gif, tinygif, mp4, tinymp4, webm
contentfilterSeguridad: off, low, medium, high
localeIdioma: en_US, es, fr, etc.

Formatos multimedia disponibles

Cada resultado tiene múltiples formatos bajo .media_formats:

FormatoCaso de uso
gifGIF de calidad completa
tinygifGIF pequeño de vista previa
mp4Versión de video (tamaño de archivo más pequeño)
tinymp4Video pequeño de vista previa
webmVideo WebM
nanogifMiniatura muy pequeña

Notas

  • Codifica la consulta en URL: espacios como +, caracteres especiales como %XX
  • Para enviar en chats, las URLs de tinygif son más livianas
  • Las URLs de GIF se pueden usar directamente en markdown: ![alt](url)

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

Skills relacionados