giphy-search

Search the Giphy API for GIFs and return embeddable URLs.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/astralform-ai/skills --skill giphy-search-astralform-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: giphy-search
Source: https://github.com/astralform-ai/skills/tree/main/skills/giphy-search
Command: npx skills add https://github.com/astralform-ai/skills --skill giphy-search-astralform-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a relevant GIF to express a reaction or emotion in a conversation requires manually browsing Giphy, copying links, and verifying they are appropriate. This Skill automates that search and returns a ready-to-use GIF URL directly in the conversation. ## Core Features & Use Cases - Giphy API Search: Queries the Giphy search endpoint with a short emotional or action phrase and returns the best-matching GIF URL. - Safe Content Filtering: Always applies the rating=g parameter so results stay safe for work. - Query Guidance: Provides a mapping of common intents (celebration, disappointment, surprise) to effective search phrases. - Use Case: A user says "congrats on shipping the release!" and the assistant responds with text plus a celebration GIF fetched from Giphy. ## Quick Start Find a celebration GIF on Giphy and include its URL in your reply.

Frequently Asked Questions about giphy-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for GIFs using the Giphy API?▼

Send a GET request to https://api.giphy.com/v1/gifs/search with your api_key, a URL-encoded query q, a limit, and rating=g. The GIF URL is found at data[0].images.original.url in the JSON response.

What API key do I need for Giphy GIF search?▼

You need a GIPHY_API_KEY environment variable containing a key from the Giphy Developers portal. Without this key set, the search endpoint cannot be called.

How do I keep Giphy search results safe for work?▼

Always include the rating=g parameter in the search request. This restricts results to G-rated content, which is the default behavior of this Skill for every query.

What are good search queries for reaction GIFs?▼

Use short emotional or action phrases like "happy dance", "mind blown", "facepalm reaction", or "celebration confetti". Concise intent-based phrases return more relevant matches than long descriptive sentences.

What happens if Giphy returns no results for a query?▼

If no matching GIF is found, the Skill says so and asks for different keywords rather than returning an irrelevant or off-topic GIF.