tteg

Fix placeholder images and dead source.unsplash.com URLs.
One command. Real photos. No API key.

CLI HTTP API MCP server Claude Code Cursor Lovable Bolt Replit

Featured on VibecodingHub Listed on MCP Servers Fix dead source.unsplash.com URLs Works when the page is built but the image URLs are still fake, broken, or missing

uv tool install tteg click to copy

Same install also gives you tteg-mcp for tool access inside MCP hosts and tteg save for local files. Use it when the page already exists and the last ugly part is still visuals.

$ tteg save "saas dashboard hero" ./public/hero --orientation landscape

{

"query": "saas dashboard hero",

"saved_to": "./public/hero.jpg",

"content_type": "image/jpeg",

"result": {

"title": "Modern office with dashboard screen",

"image_url": "https://images.unsplash.com/..."

}

When tteg is the right tool

Use it when your AI tool already built the page and the weak part is still visuals: placeholder blocks, dead source.unsplash.com URLs, or a missing real-photo workflow. Generated images are one lane. `tteg` is for the other lane: real stock photos, right now, straight from terminal, and saved into your project.

Starter kit drop-in

full copy-paste blocks

# CLAUDE.md / AGENTS.md

If a frontend task needs believable real photos, use tteg.

Install once: uv tool install tteg

Save into the repo: tteg save "<query>" ./public/images/<name> --orientation landscape

Fill a page in one pass: tteg batch landing-page-images.json

●

Built for AI-built websites. Your agent can search and save a believable hero image straight into the repo

●

Batch a whole landing page with one JSON manifest when the project needs hero, team, founder, or testimonial images together

●

No Unsplash app registration. No API key copy paste. Install once and keep moving

●

Filter by orientation, width, height, and count so the images match the layout your agent already made

●

Best for hero sections, testimonials, menu shots, office photos, blog headers, and all the real-photo gaps that placeholders ruin

●

Also good when a starter kit or generated site still points at deprecated source.unsplash.com links

Before vs after

Without tteg

800 × 400

200 × 200

via.placeholder.com and source.unsplash.com
Broken URLs. Wireframe vibes.

With tteg

hero.jpg

founder.jpg

team.jpg

office.jpg

tteg batch landing-page.json
Real photos. In the repo. One command.

600+ installs this month

0 API keys needed

1 command to fill a page

HTTP API

no install needed

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

# Returns JSON with real Unsplash image URLs

# No API key. No headers. Just GET.

# Parameters:

# q search query (required)

# n number of results, 1-10 (default: 5)

# orientation landscape | portrait | square | any

# width max width in px

# height max height in px

# Free tier: 50 queries/day per IP

Embed in any page

one script tag

GitHub PyPI Try it live Twitter