AI 에이전트 통합

이중 레이어 아키텍처

전통적인 GIF 호스팅 플랫폼은 이미지(AI 에이전트가 해석할 수 없는 이진 블롭)를 제공합니다. AgentGIF은 모든 GIF에 머신 레이어를 첨부하여 이를 해결합니다:

AI 에이전트는 GIF 페이지를 보고 어떤 명령어가 실행되었는지, 출력이 무엇이었는지, 각 단계가 얼마나 걸렸는지를 OCR이나 컴퓨터 비전 없이 정확히 이해할 수 있습니다.

.md 엔드포인트

모든 AgentGIF URL에 .md를 추가하면 LLM에 최적화된 text/markdown 응답을 받을 수 있습니다. 이것이 AI 에이전트가 페이지 내용을 이해하는 가장 빠른 방법입니다.

# GIF detail page
curl https://agentgif.com/@agentgif/docker-compose/.md

# Tag page
curl https://agentgif.com/explore/tags/git/.md

# Guide page
curl https://agentgif.com/guides/how-to-record-terminal-gif/.md

# Search results
curl https://agentgif.com/search/.md

응답은 제목, 설명, 메타데이터, 관련 링크를 포함한 구조화된 Markdown 문서입니다. Content-Type: text/markdown; charset=utf-8.

AgentGIF의 모든 페이지는 .md 접미사를 지원합니다 — 에이전트에게 막다른 길이 없습니다.

Cast 파일 (Asciinema v2)

The cast file is the richest machine layer. It's an asciinema v2 recording — a JSON header followed by timestamped terminal events:

GET /api/v1/gifs/{id}/cast/

응답 형식:

{"version": 2, "width": 120, "height": 40, "timestamp": 1710000000, "env": {"SHELL": "/bin/zsh", "TERM": "xterm-256color"}}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]
[3.1, "o", "Container db-1   Started\r\n"]

각 이벤트는 튜플입니다: [timestamp_seconds, event_type, data]

• "o" — output (터미널에 출력된 텍스트)
• "i" — input (입력된 키 입력, 녹화된 경우)

cast 파일을 파싱하여 실행된 정확한 명령어, 그 출력, 타이밍 정보를 추출하세요. env 헤더는 셸 및 터미널 유형을 알려줍니다.

전사본

더 단순한 사용 사례를 위해 전사본 엔드포인트는 ANSI 코드가 제거된 일반 텍스트를 반환합니다:

GET /api/v1/gifs/{id}/transcript/

응답:

$ docker compose up -d
Creating network...
Container app-1  Started
Container db-1   Started

전사본은 검색 인덱싱, LLM 컨텍스트 윈도우에 임베딩, 빠른 콘텐츠 추출에 이상적입니다.

구조화된 JSON API

REST API는 모든 GIF의 전체 메타데이터를 반환합니다:

GET /api/v1/gifs/{id}/

This includes title, command, tags, shell, theme, file dimensions, embed codes, and download URLs — everything an agent needs to understand and reference the GIF. See the full API reference.

대량 작업을 위해 목록 및 검색 엔드포인트를 사용하세요:

# Find all GIFs about Docker
GET /api/v1/search/?q=docker

# Browse by tag
GET /api/v1/tags/kubernetes/gifs/

# Featured GIFs (curated quality)
GET /api/v1/featured/

llms.txt

The /llms.txt file provides a site-level summary optimized for AI crawlers. It describes what AgentGIF is, lists all API endpoints, and explains how to discover and consume content.

This follows the llms.txt convention — a lightweight alternative to sitemaps for AI agents that want to understand a site's structure quickly.

검색 및 크롤링

AI 에이전트는 여러 채널을 통해 GIF를 검색할 수 있습니다:

robots.txt는 모든 크롤러를 허용합니다 — AgentGIF은 AI 에이전트를 환영합니다.

AI 에이전트를 위한 사용 사례

문서 생성

AI 에이전트는 도구 이름으로 GIF를 검색하고, cast 파일을 가져와서, 임베드된 데모가 포함된 문서를 자동으로 생성할 수 있습니다:

# Find a demo for "git rebase"
curl -s "https://agentgif.com/api/v1/search/?q=git+rebase" | jq '.results[0]'

# Get the cast file for step-by-step extraction
curl -s "https://agentgif.com/api/v1/gifs/xK9mQ2pL/cast/"

튜토리얼 조립

에이전트는 관련 GIF 컬렉션을 탐색하고 올바른 순서와 컨텍스트로 단계별 튜토리얼을 조립할 수 있습니다.

코드 리뷰 지원

PR에 GIF 데모가 포함되어 있으면 AI 에이전트는 cast 파일을 가져와 명령어를 파싱하고 PR 설명과 일치하는지 확인할 수 있습니다.

CLI 도구 검색

The tools directory catalogs CLI tools with associated GIF demos. Agents can browse tools by category and find real-world usage examples.