# Make App Store screenshots with your AI coding agent

> HTML version: https://storeshot.art/agents/

Claude Code, Cursor, Codex or any agent that can run `curl` can drive the StoreShot API. It is plain
REST with an OpenAPI document (https://api.storeshot.art/v1/openapi.json) and an llms.txt (https://storeshot.art/llms.txt).

## Steps

1. Create a key in the developer console (https://console.storeshot.art/). Start with a free `ss_test_…` key; your first key also brings 4 free credits.
2. Put it in your environment: `export STORESHOT_API_KEY=ss_test_…`. Never paste a live key into a chat or commit it.
3. Paste the prompt below into your agent from your app's repository.

## The prompt

```text
Use the StoreShot API (https://api.storeshot.art/v1) to create my App Store and Google Play screenshots.
My API key is in the STORESHOT_API_KEY environment variable; send it as "Authorization: Bearer $STORESHOT_API_KEY".
Read the API reference first: https://api.storeshot.art/v1/openapi.json (guide: https://storeshot.art/llms.txt).

1. Find my app's raw screenshots (simulator or device captures) and its name and one-line description.
2. Upload each screenshot with POST /uploads (multipart field "file").
3. Create one screenshot set with POST /screenshot-sets for both stores, one short caption per screen,
   and an Idempotency-Key. Quote it first with ?dryRun=true and tell me how many credits it costs.
4. Poll GET /screenshot-sets/{id} until it is final, then download
   GET /screenshot-sets/{id}/archive?layout=fastlane and unzip it in the project root (fastlane folders).
If my key starts with ss_test_ the images are free samples; tell me when to switch to an ss_live_ key.
```

## Coming soon

- MCP server: StoreShot tools for Claude, Cursor and other MCP clients.
- CLI: `storeshot` on the command line and in CI.