GIF Search
Search for GIFs from GIPHY and Tenor using their public APIs.
Quick Start
/job/.pi/skills/gif-search/gif-search.js "cats"
Usage
Basic Search
/job/.pi/skills/gif-search/gif-search.js "<query>"
Search with Limit
job/.pi/skills/gif-search/gif-search.js "<query>" <limit>
Default limit is 5.
Get GIF URL Only
job/.pi/skills/gif-search/gif-search.js "<query>" 1 url
Configuration
Requires one of these environment variables (check with llm-secrets skill):
-
GIPHY_API_KEY
-
GIPHY API key
-
TENOR_API_KEY
-
Tenor API key
If both are available, GIPHY is used by default.
Output Format
Returns JSON array of GIF results:
[ { "id": "gif_id", "title": "Funny Cat GIF", "url": "https://media.giphy.com/media/xxx/giphy.gif", "preview_url": "https://media.giphy.com/media/xxx/200.gif", "width": 480, "height": 270 } ]
Examples
Search for happy birthday GIFs
/job/.pi/skills/gif-search/gif-search.js "happy birthday"
Get top 3 results
/job/.pi/skills/gif-search/gif-search.js "celebration" 3
Get just the URL of the top result
/job/.pi/skills/gif-search/gif-search.js "thumbs up" 1 url
When to Use
-
User asks for a GIF, reaction image, or meme
-
Need visual content for Discord/Slack messages
-
Adding personality to chat responses
-
Finding anniversary/birthday/celebration content