tteg

Unsplash sem registro. Pesquise e salve fotos reais de banco de imagens sem chaves de API.

GitHub
3
Experimente este MCPPatrocinado

Documentação

tteg

PyPI version Python 3.10+ License: MIT CI

Fotos de stock do Unsplash sem registro ou chaves de API.

uv tool install tteg
tteg save "startup office" ./public/hero --orientation landscape
# → saves a real photo to ./public/hero.jpg

Sem aplicativo Unsplash. Sem chave de API. Sem arquivos .env. Apenas fotos.

Por que isso existe

O Unsplash tem mais de 4 milhões de fotos gratuitas. Para usá-las programaticamente, você precisa registrar uma conta de desenvolvedor, criar um aplicativo e gerenciar chaves de API. A biblioteca oficial em JavaScript foi arquivada em 2024.

Enquanto isso, o source.unsplash.com/random — a alternativa sem configuração que todos usavam — foi descontinuado em meados de 2024 e agora retorna erro 503. Uma busca autenticada no código do GitHub retorna cerca de 16.500 ocorrências ativas em aproximadamente 885 repositórios únicos que ainda o referenciam; veja RESEARCH.md para a lista completa, incluindo vários projetos com mais de 1.000 estrelas que atualmente distribuem tags <img> quebradas.

O tteg lida com tudo isso no lado do servidor. Você obtém uma CLI, uma API HTTP, um servidor MCP e um widget incorporável — tudo sem configuração.

Instalação

uv tool install tteg
# or: pip install tteg

Uso

Buscar — obtenha URLs de imagens:

tteg "coffee shop" -n 3 --orientation landscape

Salvar — baixe uma foto para o seu projeto:

tteg save "modern office" ./public/hero --orientation landscape

Lote — preencha uma página inteira a partir de um manifesto JSON:

tteg batch landing-page-images.json

[
  {"query": "startup office", "output": "./public/hero", "orientation": "landscape"},
  {"query": "developer portrait", "output": "./public/founder"},
  {"query": "team meeting", "output": "./public/team", "orientation": "landscape"}
]

API HTTP (sem necessidade de instalação)

curl "https://tteg-api-53227342417.asia-south1.run.app/search?q=coffee+shop&n=3"

Sem cabeçalhos. Sem autenticação. CORS habilitado. Experimente ao vivo →

Parâmetros: q (consulta), n (quantidade, 1-10), orientation (paisagem/retrato/quadrado/qualquer), width, height

Servidor MCP

Para Claude Code, Cursor ou qualquer host MCP:

{
  "mcpServers": {
    "tteg": {
      "command": "uvx",
      "args": ["tteg-mcp"]
    }
  }
}

Ferramentas: search_images, save_image, search_and_save_image, batch_save_images

Widget incorporável

Adicione em qualquer página HTML:

<div data-tteg="coffee shop" data-count="3"></div>
<script src="https://tteg.kushalsm.com/embed.js"></script>

Opções

FlagPadrãoDescrição
-n, --count5Número de resultados (1–10)
--orientationqualquerlandscape, portrait, square ou any
--width—Largura máxima em pixels
--height—Altura máxima em pixels

Kit inicial

Blocos de copiar e colar para CLAUDE.md e AGENTS.md: STARTER_KIT.md

Links