# Unsplash Image

> Busca imágenes en Unsplash y las descarga. Opcionalmente añade texto superpuesto (título/subtítulo) a la imagen.

Fuente: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/unsplash-image
Markdown: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/unsplash-image.md

Repositorio: https://github.com/OpenClaudia/openclaudia-skills
Autor: OpenClaudia
Licencia: MIT
Actualizado: hace 5 meses
Coste de contexto: 57 tok instalada, 774 tok al activarse, 774 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: bash(*), read, write

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent claude-code
# Cursor
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent cursor
# Codex
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent codex
# Gemini CLI
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent gemini
# Windsurf
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent windsurf
# Cline
npx -y skills add OpenClaudia/openclaudia-skills --skill stock-images --agent cline
```

## Qué hace

- Busca imágenes en Unsplash según una consulta y descarga la seleccionada al archivo indicado
- Permite filtrar por orientación (landscape, portrait, squarish) y color
- Añade opcionalmente un overlay de texto (título y subtítulo) sobre la imagen descargada
- Puede listar resultados sin descargar o elegir entre selección aleatoria o el primer resultado
- Imprime la URL de descarga, la atribución del fotógrafo y la ruta del archivo guardado

## Cuándo usarla

- El usuario pide encontrar una foto de stock o buscar una imagen
- El usuario pide obtener una imagen de Unsplash
- El usuario pide descargar una foto con texto superpuesto

## Qué la activa

- "Busca una foto de stock de paisajes naturales y descárgala"
- "Necesito una imagen de Unsplash sobre café para mi blog"
- "Descarga una foto de montañas con el título 'Mi aventura'"

## Antes de instalar

- Requiere el script ~/.agents/tools/unsplash-search.py, un archivo .env con UNSPLASH_CLIENT_ID, y las librerías requests y Pillow (esta última solo para overlay de texto).
- Necesita en el PATH: pip, python
- writes to your files

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde OpenClaudia/openclaudia-skills bajo MIT. Esta sección es el documento original y está en inglés.

# Unsplash Image Search & Download

Search Unsplash for images, download them, and optionally add text overlay.

## Tool Location

- Script: `~/.agents/tools/unsplash-search.py`
- Env file: `~/.agents/tools/.env` (contains `UNSPLASH_CLIENT_ID`)

## Quick Usage

### Search and download a random matching image

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "nature landscape" \
  --output ./image.jpg
```

### With orientation filter

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "coffee shop" \
  --orientation landscape \
  --output ./coffee.jpg
```

### With text overlay (title and subtitle)

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "technology abstract" \
  --output ./cover.png \
  --title "My Blog Post Title" \
  --subtitle "A short description"
```

### List results without downloading

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "sunset" \
  --list
```

### Pick the first result instead of random

```bash
python ~/.agents/tools/unsplash-search.py \
  --query "mountains" \
  --pick first \
  --output ./mountains.jpg
```

## CLI Options

| Option | Description |
|--------|-------------|
| `--query, -q` | **(Required)** Search query string |
| `--output, -o` | **(Required unless --list)** Output file path |
| `--orientation` | Filter: `landscape`, `portrait`, or `squarish` |
| `--color` | Color filter (e.g., `blue`, `green`, `red`, `black_and_white`) |
| `--pick` | How to select from results: `random` (default) or `first` |
| `--title` | Title text to overlay on the image |
| `--subtitle` | Subtitle text to overlay (only used with --title) |
| `--list` | List search results instead of downloading |
| `--count` | Number of results to fetch, max 30 (default: 30) |

## Text Overlay

When `--title` is provided, the script adds a text overlay to the bottom portion of the image with:
- Semi-transparent dark background behind the text
- White title text with shadow
- Gray subtitle text (if provided)
- Automatic word wrapping and font sizing

**Requires Pillow**: `pip install Pillow`

## Dependencies

- `requests` (for API calls and image download)
- `Pillow` (only needed if using text overlay with `--title`)

Install if needed:
```bash
pip install requests Pillow
```

## Output

The script prints:
- The download URL
- Photographer attribution (required by Unsplash)
- The saved file path
- Confirmation of text overlay if applied

## Notes

- Unsplash API guidelines require attribution. The script prints photographer info.
- The script triggers Unsplash's download tracking endpoint as required by their API terms.
- Images are downloaded at "regular" quality (1080px width). For higher resolution, modify the script to use `urls.full` or `urls.raw`.

## Dónde encaja

- Categoría: [Diseño y UI](https://skillsagentes.com/categorias/diseno-ui.md) — Sistemas de diseño, trabajo con componentes y acabado visual.
- Creador: [OpenClaudia](https://skillsagentes.com/creators/openclaudia.md) — 76 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Competitor Traffic Report](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/competitor-traffic-report.md): Genera un informe HTML autocontenible de tráfico competitivo: visitas mensuales (SimilarWeb), tráfico orgánico y Domain Rating (Ahrefs), con gráficos ranked, tendencias y tabla de datos.
- [Brand Dev](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-dev.md): Obtiene datos de marca (nombre, descripción, logos, industria) desde la API de brand.dev y guarda los logos localmente.
- [Gsc Portfolio Audit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/gsc-portfolio-audit.md): Audita TODAS las propiedades de Google Search Console a la vez: ranking por clics e impresiones con deltas, y diff de keywords por sitio (nuevas, suben, bajan, perdidas, o bien rankeadas sin clics).
- [Wechat Moments](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/wechat-moments.md): Clasifica y resume el feed de WeChat Moments (朋友圈) del usuario para que los eventos reales y la información genuina destaquen sobre la promoción, ponderando según cuánto le escribe el usuario a cada autor.
- [Podcast Edit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/podcast-edit.md): Edita audio o video de podcast: recorta charla previa/posterior, quita muletillas, corta silencios, mejora el audio y aplica el mismo corte a una versión en video.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)