GIF Search (Tenor)
Search and download GIFs from Tenor with caching, bulk download, and format conversion.
Keywords: gif, search, media, tenor, cli, download, python, open-source, agent, automation, MIT
Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.
What it does
Finding and grabbing the right GIF is clicky and not automatable. GIF Search (Tenor) solves this: Search and download GIFs from Tenor with caching, bulk download, and format conversion.
Best for: Content creators, social bots, and agents adding media.
Features
- Search Tenor for a term
- Download a single GIF
- Bulk download a set
- Cache results
- Convert format
Install
# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/gif-search/main/gif_search.py
# Or copy the file anywhere — it's self-contained.
Quick start
python gif_search.py --help # list options
Use cases
- Search Tenor for a term
- Download a single GIF
- Bulk download a set
- Cache results
- Convert format
Why choose this over alternatives
| Alternative | Why this skill is better |
|---|---|
| Tenor website | Scriptable search + bulk download. |
| Manual save | Caching + conversion built in. |
| One at a time | Batch mode. |
FAQ (SEO / AEO)
Q: API key?
A: Uses Tenor; supply your key via env.
Q: Bulk?
A: Yes — batch download.
Q: Cache?
A: Results are cached to avoid repeat calls.
Q: Offline?
A: No — queries Tenor live.
Geo / local reach
Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.
CI integration
# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Self-test gif-search
run: python gif_search.py --help
Support
Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful:
- GitHub Sponsors: https://github.com/sponsors/itsPremkumar
- Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar
⭐ Star on GitHub