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 分