MagicScreenshots

io.github.Humanleap由 GitHub 帳號 Humanleap 發布v1.3.0更新於 Oct 24, 2026

Search real App Store screenshots and preview videos; generate and localize your own.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

一個遠端 MCP 伺服器，讓助理搜尋真實 App Store 截圖與預覽影片，並生成與在地化使用者自己的 App Store 截圖。

可以做什麼
依文字、Apple 分類、排行榜名次、列表風格或有無預覽影片，搜尋並瀏覽每日更新的熱門 App Store 應用程式庫，讀取應用程式中介資料與同類應用程式。以 markdown 圖片形式取得有序的列表截圖（含在地化商店），以及預覽影片封面；使用 Pro 金鑰還可取得影片下載連結與歷史版本。查詢使用者自己應用程式在 App Store 上的即時截圖。建立換風格與在地化工作，核准換風格概覽，並查看工作狀態與近期結果。讀取網站摘要、markdown 頁面、探索文件、支援的語言與市場。
適用情境
適合助理需要 App Store 創意靈感或參考截圖、想研究熱門應用程式如何呈現列表，或需要把使用者自己的截圖換成其他風格、翻譯成其他語言並維持 App Store 解析度時使用。
執行需求
遠端 Streamable HTTP 端點，不需本機執行環境。搜尋與目錄瀏覽不需要金鑰。生成、影片下載與列表歷史需要 API 金鑰，透過 Authorization Bearer 標頭傳送，可用 create_api_key 或網站設定建立。涉及付費方案與依圖片計費的額度。
安裝前請注意
Authorization 標頭帶有金鑰，避免寫入共用設定。換風格與在地化需要使用者開啟認領連結、登入並付費，生成依圖片計費。應用程式庫中的截圖與影片歸其開發者所有，僅供參考，不可當作自己的素材重複使用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MagicScreenshots，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Humanleap%2Fmagicscreenshots-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "magicscreenshots": {
      "type": "http",
      "url": "https://www.magicscreenshots.com/api/mcp"
    }
  }
}

README

MagicScreenshots for agents

Give your AI agent a library of real App Store screenshots and preview videos from thousands of top apps, updated daily, then let it generate and localize your own App Store screenshots.

  • Library: the top 100 free and top-grossing apps in every Apple category, with screenshots, preview videos and listing history.
  • Search by category, today's chart, look (dark, headline, device frame, lifestyle, ...) or app name.
  • Generate: restyle your screenshots like any app in the library, or translate them into 40+ languages at App Store resolution.

Setup guides for every agent: https://www.magicscreenshots.com/agents

MCP endpoint (Streamable HTTP): https://www.magicscreenshots.com/api/mcp

Install

Searching needs no key. Generation, video downloads and listing history need an API key: ask your agent to call create_api_key, or create one in Settings > API on magicscreenshots.com, then set MAGICSCREENSHOTS_API_KEY.

Any agent with skills (Claude Code, Codex, Cursor, Cline, Windsurf, ...)

sh
npx skills add Humanleap/magicscreenshots-mcp

This installs the skill only. Add the MCP server too (below) so the agent can call the tools.

Claude Code

Plugin (skill + MCP server):

/plugin marketplace add Humanleap/magicscreenshots-mcp/plugin install magicscreenshots@magicscreenshots

Or just the MCP server:

sh
claude mcp add --transport http magicscreenshots https://www.magicscreenshots.com/api/mcp \  --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY"

The plugin sends Authorization: Bearer ${MAGICSCREENSHOTS_API_KEY}. Set the variable before starting Claude Code. With no key set, search still works, but get_app_videos, get_app_history and generation return an auth error. For fully keyless use, delete the headers block from the plugin's .mcp.json.

Cursor

Install the plugin from the Cursor Marketplace, or add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json:

json
{  "mcpServers": {    "magicscreenshots": {      "url": "https://www.magicscreenshots.com/api/mcp",      "headers": { "Authorization": "Bearer ${env:MAGICSCREENSHOTS_API_KEY}" }    }  }}

Without MAGICSCREENSHOTS_API_KEY set, leave out headers (same reason as Claude Code above).

Codex

sh
codex mcp add magicscreenshots --url https://www.magicscreenshots.com/api/mcp

For generation, set the key in config.toml:

toml
[mcp_servers.magicscreenshots]url = "https://www.magicscreenshots.com/api/mcp"bearer_token_env_var = "MAGICSCREENSHOTS_API_KEY"

Gemini CLI

Extension (skill + MCP server, search tools):

sh
gemini extensions install https://github.com/Humanleap/magicscreenshots-mcp

With a key:

sh
gemini mcp add --transport http --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY" \  magicscreenshots https://www.magicscreenshots.com/api/mcp

Any other MCP client

json
{  "mcpServers": {    "magicscreenshots": {      "type": "http",      "url": "https://www.magicscreenshots.com/api/mcp",      "headers": { "Authorization": "Bearer ms_live_..." }    }  }}

Some clients call the URL field serverUrl (Windsurf) or httpUrl (Gemini). Leave out headers to use search only.

Command line

sh
npx magic-screenshots search --category finance --chart grossingnpx magic-screenshots app duolingonpx magic-screenshots screens duolingo --out ./referencenpx magic-screenshots videos instagram

Tools

ToolKeyWhat it does
list_directory_appsnoSearch the library by text, category, look, chart, or apps with preview videos
list_directory_categoriesnoApple categories with app counts
list_directory_tagsnoListing looks (headline, device-frame, dark, ...) with app counts
get_directory_appnoOne app: developer, chart ranks, looks, screenshots, video posters
get_directory_screensnoOrdered screenshots as images your agent can look at
get_app_videosPro for filesPreview video posters; mp4 downloads with Pro
get_app_historyProPast versions of a listing
create_api_keynoMint a key; you claim it in the browser
get_screenshotsfor live lookupYour app's current App Store screenshots
create_restyleyesRestyle your screenshots like a library app
create_localizeyesTranslate your screenshots into other languages
get_job_group, approve_restyle, list_resultsyesFollow and approve generation jobs

The skill in skills/magicscreenshots/SKILL.md tells the agent how to run an inspiration review, make App Store screenshots, localize, and study preview videos.

Pricing

  • Free: search the library and view screenshots.
  • Library Pro: $19, adds preview video downloads and listing history.
  • Team: $49 per seat.
  • Image credits: generation (restyle and localize) is paid per image.

Current prices: https://www.magicscreenshots.com/pricing

Legal

Screenshots and preview videos in the library belong to their developers. MagicScreenshots shows them for reference and research. Don't reuse them as your own App Store assets.

Maintaining

The web copy at public/.well-known/agent-skills/magicscreenshots/SKILL.md in the MagicScreenshots app repo is the source. Copy it here unchanged:

sh
cp public/.well-known/agent-skills/magicscreenshots/SKILL.md kit/skills/magicscreenshots/SKILL.md

The app repo's scripts/agent-cli.test.mjs fails if the two copies differ or if the digest in agent-skills/index.json is stale.

License

MIT © Humanleap. See LICENSE.

來源：README.md，提交 2775a38

工具

19

create_api_key

Create API key

Create an agent API key without an account. Directory browse works with no key. Screenshot lookup works immediately with the key. Restyle and localize require the human to open claim_url, sign in, and pay.

輸入參數name

list_directory_categories

List directory categories

List App Store screenshot directory categories (Finance, Food & Drink, Productivity, …) with app counts. Use this first when an agent wants inspiration by genre. No API key required.

無需輸入參數。

list_directory_tags

List directory tags

List listing-screenshot treatments (headline, device-frame, lifestyle, dark, character, social-proof, …) with app counts. These are App Store creative tags, not in-app UI patterns. No API key required.

無需輸入參數。

list_directory_apps

Search the screenshot library

Search thousands of real App Store listings (the top 100 free and top-grossing apps in every Apple category, refreshed daily). Filter by text, Apple genre slug, listing look (tag), today's chart rank, or apps that have preview videos. Returns slugs for get_directory_app, get_app_videos, get_app_history and create_restyle. No API key required.

輸入參數tagchartlimitqueryoffsetcategoryplatformhas_video

get_directory_app

Get directory app

Get one directory app: metadata, ordered listing screenshot URLs (as markdown images), related apps in the same genre, and the create_restyle arguments to copy that style. No API key required.

輸入參數slugqueryapp_id

get_directory_screens

Get directory screens

Get the ordered App Store listing screenshots for a library app, including markdown images a vision model can inspect. Pass country (jp, de, ...) for the localized listing in that storefront. Index is 1-based and matches /apps/:slug/screens/:index. No API key required.

輸入參數slug必填indexcountry

get_app_videos

Get App Store preview videos

App Store preview videos for a library app: poster frames for everyone; with a Pro API key, 1-hour download links to the mp4 files (about 30 s each). Use them as reference when making your own app preview video. Pass slug from list_directory_apps (has_video=true finds apps that have them).

輸入參數slug必填

get_app_history

Get listing history

Every version of an app's App Store listing we have captured (screenshots and preview videos per date), newest first. Shows how top apps change their creative over time. Needs a Pro API key; without one it returns how many versions exist.

輸入參數slug必填limit

get_magicscreenshots_site_summary

Get site summary

Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.

無需輸入參數。

get_magicscreenshots_markdown

Get page markdown

Fetch a markdown representation of a known MagicScreenshots public page.

輸入參數route必填

get_magicscreenshots_discovery_document

Get discovery document

Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.

輸入參數endpoint必填

list_magicscreenshots_languages

List languages

Return supported screenshot localization languages and public guide routes.

輸入參數limit

list_magicscreenshots_markets

List markets

Return supported App Store market guides and public market routes.

輸入參數limitregion

get_screenshots

Get screenshots

Fetch high-resolution App Store screenshots. If the app is in the MagicScreenshots directory, returns those curated listing shots (with markdown images) with no API key. Otherwise looks up the live App Store listing (API key required). Pass live=true to skip the directory. Use this for the user's own app; use get_directory_app when you already have a catalog slug.

輸入參數liveslugqueryapp_idapp_urlcountry

create_restyle

Create restyle

Restyle the user's App Store screenshots to match a directory inspiration set. Prefer inspiration_slug from list_directory_apps (duolingo, monzo, doordash, …). Requires an API key; the human must claim the key and pay before generation runs.

輸入參數limitsource_app必填inspiration_appinspiration_slugsource_screenshot_urlsinspiration_screenshot_urls

create_localize

Create localize

Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.

輸入參數limitsource_app必填target_locales必填source_screenshot_urls

approve_restyle

Approve restyle

Approve a generated restyle overview and start final screenshot extraction.

輸入參數group_id必填overview_url

get_job_group

Get job group

Check restyle job group status, overview URL, errors, and final output URLs.

輸入參數group_id必填

list_results

List results

List recent MagicScreenshots restyle job groups and outputs for the authenticated account.

輸入參數limit

版本歷史

1
  1. v1.3.0最新Sep 27, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分