무료GitHub에 공개한국어 소개

gif-search

Tenor에서 주제별 GIF를 검색하고 원본 또는 가벼운 미리보기 URL을 가져옵니다. 제목과 크기를 확인하고 선택한 결과를 파일로 다운로드할 수 있으며, `curl`과 `jq`를 사용합니다.

원문원문 설명 보기

Search/download GIFs from Tenor via curl + jq.

NousResearch/hermes-agent스타 258,450(GitHub 258,450 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

채팅에 쓸 반응 GIF 찾기
가벼운 미리보기 URL 가져오기
검색 결과의 GIF 저장하기
GIF 제목과 크기 확인하기

한국어 소개

할 수 있는 일

키워드로 Tenor를 검색해 GIF URL이나 용량이 작은 미리보기 URL을 가져옵니다. 검색 결과에서 제목과 이미지 크기를 확인하고, 선택한 항목을 파일로 다운로드할 수 있습니다. Tenor API 요청에는 curl을 사용하고 응답에서 필요한 항목을 추출할 때는 jq를 사용합니다. GIF 외에 MP4와 WebM 같은 미디어 형식도 검색 결과에서 선택할 수 있습니다.

이럴 때 유용합니다

채팅에서 쓸 반응 GIF를 찾거나 기사와 자료에 어울리는 이미지를 찾을 때 사용할 수 있습니다. 파일 크기를 줄인 미리보기 URL이 필요하거나 후보들의 제목과 크기를 비교하고 싶을 때도 유용합니다.

사용 예시

“축하하는 반응 GIF를 검색해 주세요.”
“일을 잘 마쳤을 때 쓸 가벼운 미리보기를 찾아 주세요.”
“고양이 GIF 세 개를 검색하고 제목과 크기를 정리해 주세요.”

주의 사항

사용하려면 TENOR_API_KEY를 설정해야 합니다. curl과 jq도 필요합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

문서 점검

AI가 SKILL.md의 내용에서 주의가 필요한 작업과 도입 전제를 확인했습니다. 점수는 실제로 실행한 결과(실행 검증)만으로 매깁니다.

안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호자료에는 검색과 파일 다운로드가 나와 있으며 삭제나 외부 게시 작업은 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족`TENOR_API_KEY`, `curl`, `jq`가 필요하다고 명시하지만 설정 절차는 없습니다.

점수에는 넣지 않았습니다. 2026년 10월 30일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md2.7 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

GIF Search (Tenor API)

Search and download GIFs directly via the Tenor API using curl. No extra tools needed.

When to use

Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat.

Setup

Set your Tenor API key in your environment (add to ${HERMES_HOME:-~/.hermes}/.env):

TENOR_API_KEY=your_key_here

Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits.

Prerequisites

curl and jq (both standard on macOS/Linux)
TENOR_API_KEY environment variable

Search for GIFs

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

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Download a GIF

# Search and download the top result
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

Get Full Metadata

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}'

API Parameters

Parameter	Description
`q`	Search query (URL-encode spaces as `+`)
`limit`	Max results (1-50, default 20)
`key`	API key (from `$TENOR_API_KEY` env var)
`media_filter`	Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm`
`contentfilter`	Safety: `off`, `low`, `medium`, `high`
`locale`	Language: `en_US`, `es`, `fr`, etc.

Available Media Formats

Each result has multiple formats under .media_formats:

Format	Use case
`gif`	Full quality GIF
`tinygif`	Small preview GIF
`mp4`	Video version (smaller file size)
`tinymp4`	Small preview video
`webm`	WebM video
`nanogif`	Tiny thumbnail

Notes

URL-encode the query: spaces as +, special chars as %XX
For sending in chat, tinygif URLs are lighter weight
GIF URLs can be used directly in markdown: ![alt](url)

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬