English Français العربية

StoreShots

السجل الرسمي التسويق والمبيعات

Turn raw app screenshots into App Store and Google Play marketing screenshots.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package storeshots-api-mcp
Claude Code 
claude mcp add storeshots -e 'STORESHOTS_API_KEY=<your storeshots_api_key>' -e 'STORESHOTS_API_URL=<STORESHOTS_API_URL>' -e 'STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR>' -- npx -y storeshots-api-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "storeshots": {
            "command": "npx",
            "args": [
                "-y",
                "storeshots-api-mcp@0.1.2"
            ],
            "env": {
                "STORESHOTS_API_KEY": "<your storeshots_api_key>",
                "STORESHOTS_API_URL": "<STORESHOTS_API_URL>",
                "STORESHOTS_OUTPUT_DIR": "<STORESHOTS_OUTPUT_DIR>"
            }
        }
    }
}

متغيرات البيئة

  • STORESHOTS_API_KEY إلزامي سري Your StoreShots API key (free key at https://storeshots.qaimos.co.uk/account.html)
  • STORESHOTS_API_URL API endpoint (default https://storeshots.qaimos.co.uk/api.php)
  • STORESHOTS_OUTPUT_DIR Default download folder for get_output (default ~/StoreShots)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. StoreShots MCP
  2. Quick start
  3. Tools
  4. Configuration
  5. Pricing
  6. Privacy
  7. Development
  8. Links
  9. License

StoreShots MCP

Turn raw app screenshots into polished App Store and Google Play marketing screenshots from Cursor, Claude, or any other MCP client.

This is a small stdio MCP server that talks to the hosted StoreShots API. Rendering happens on the server, so you don't need Chrome, Puppeteer, or a design tool on your machine. Give your agent a few screenshots and some headlines, and it saves store-ready PNGs (or a ZIP) into your project.

  • 1–5 screenshots per set, from local files or URLs
  • 5 curated styles: glow, midnight, sunset, mint, trailing, plus custom colours
  • Device frames: iphone, iphone-duo, android, ipad
  • Every required store size in one call: ios-6.9 (1320×2868), ios-6.5 (1242×2688), android-phone (1080×1920), ipad-13 (2064×2752)
  • Headlines and captions for each slide
  • Downloads a ZIP and/or PNGs straight into your project

Quick start

1. Get a free API key

Sign up with your email at **https://storeshots.qaimos.co.uk/account.html**. The key (ss_...) is only shown once, so copy it somewhere safe.

2. Add the server to your MCP client

Cursor: add this to ~/.cursor/mcp.json (or to .cursor/mcp.json in a project). You can also use the "Install in Cursor" button above.

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Desktop: open Settings → Developer → Edit Config, then add the same block to claude_desktop_config.json:

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Code:

claude mcp add storeshots --env STORESHOTS_API_KEY=ss_your_key_here -- npx -y storeshots-api-mcp

VS Code, Windsurf, and other clients: run npx -y storeshots-api-mcp over stdio with STORESHOTS_API_KEY set in the environment.

Requires Node.js 18.17 or newer.

3. Ask your agent

Make App Store screenshots from ./shots/home.png and ./shots/stats.png in the midnight style with the headlines "Build habits that stick" and "See your progress", and save them to ./store-assets.

Tools

ToolWhat it does
list_stylesLists the available styles with their colours and layouts
list_devicesLists the device frames and store output sizes
generate_screenshotsRenders one set from screenshots (1–5 paths or URLs). Optional inputs: style, device, targets[], headlines[], captions[], appName, theme (colour overrides), download_to, and download_format (zip \png \both). Returns a jobId
get_outputDownloads a job's ZIP and/or PNGs to output_dir. Outputs are kept for 24h
get_balanceShows your paid credits, the free sets left this month, and the available credit packs
buy_creditsReturns a Stripe Payment Link for a pack, which you open in the browser. The tool itself never charges you

Configuration

VariableRequiredDefault
STORESHOTS_API_KEYyesnone. Get a free key at account.html
STORESHOTS_API_URLnohttps://storeshots.qaimos.co.uk/api.php
STORESHOTS_OUTPUT_DIRno~/StoreShots (the default download folder)
STORESHOTS_TIMEOUT_MSno300000

Pricing

  • Free: 3 sets per month, with a small "Made with StoreShots" watermark
  • Starter: 10 sets for $3, no watermark
  • Pro: 20 sets for $5, no watermark

Each set is one generate_screenshots call and includes every size you ask for. You can buy them with buy_credits or on storeshots.qaimos.co.uk.

Privacy

Screenshots are uploaded over HTTPS to the StoreShots API, rendered there, and deleted after 24 hours. Your API key is sent as an X-API-Key header.

Development

npm install
npm run inspect   # opens the MCP Inspector against src/index.js

npm test runs an end-to-end test against a local copy of the StoreShots PHP API, which isn't part of this repo.

License

MIT

الأسئلة الشائعة

ما هو StoreShots؟

Turn raw app screenshots into App Store and Google Play marketing screenshots.

كيف أثبّت StoreShots؟

يعمل على جهازك. في Claude Code: claude mcp add storeshots -e 'STORESHOTS_API_KEY=<your storeshots_api_key>' -e 'STORESHOTS_API_URL=<STORESHOTS_API_URL>' -e 'STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR>' -- npx -y storeshots-api-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج StoreShots إلى مفتاح API؟

نعم. يتطلب STORESHOTS_API_KEY، وتضبطها في إعداداته.

هل StoreShots مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون StoreShots؟

ينشره qaimos. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.