MagicScreenshots

面向 Agent 的 MagicScreenshots

为你的 AI Agent 提供一个包含数千款热门 App Store 应用真实截图和预览视频的资源库，每日更新；然后让它生成并本地化你自己的 App Store 截图。

• 资源库：Apple 每个类别中排名前 100 的免费应用和营收最高的应用，包含截图、预览视频和上架历史。
• 搜索：按类别、今日榜单、风格（深色、标题、设备边框、生活方式等）或应用名称搜索。
• 生成：将你的截图改成资源库中任意应用的风格，或将其翻译成 40 多种语言，并保持 App Store 分辨率。

每种 Agent 的设置指南：https://www.magicscreenshots.com/agents

MCP 端点（Streamable HTTP）：https://www.magicscreenshots.com/api/mcp

安装

搜索无需密钥。生成、视频下载和上架历史需要 API 密钥：让你的 Agent 调用 create_api_key，或在 magicscreenshots.com 的 Settings > API 中创建密钥，然后设置 MAGICSCREENSHOTS_API_KEY。

任何支持技能的 Agent（Claude Code、Codex、Cursor、Cline、Windsurf 等）

npx skills add Humanleap/magicscreenshots-mcp

这只会安装技能。还需要添加 MCP 服务（如下），以便 Agent 调用工具。

Claude Code

插件（技能 + MCP 服务）：

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

或者只添加 MCP 服务：

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

该插件会发送 Authorization: Bearer ${MAGICSCREENSHOTS_API_KEY}。启动 Claude Code 前请设置此变量。如果未设置密钥，搜索仍可使用，但 get_app_videos、get_app_history 和生成会返回身份验证错误。如需完全免密使用，请从插件的 .mcp.json 中删除 headers 区块。

Cursor

从 Cursor Marketplace 安装插件，或将以下内容添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json：

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

如果未设置 MAGICSCREENSHOTS_API_KEY，请省略 headers（原因与上文 Claude Code 部分相同）。

Codex

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

如需生成，请在 config.toml 中设置密钥：

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

Gemini CLI

扩展（技能 + MCP 服务，搜索工具）：

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

使用密钥：

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

任何其他 MCP 客户端

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

有些客户端将 URL 字段称为 serverUrl（Windsurf）或 httpUrl（Gemini）。若只使用搜索，请省略 headers。

命令行

npx magic-screenshots search --category finance --chart grossing
npx magic-screenshots app duolingo
npx magic-screenshots screens duolingo --out ./reference
npx magic-screenshots videos instagram

工具

工具	密钥	功能
list_directory_apps	否	按文本、类别、风格、榜单或是否包含预览视频搜索资源库
list_directory_categories	否	Apple 类别及应用数量
list_directory_tags	否	上架风格（标题、设备边框、深色等）及应用数量
get_directory_app	否	单个应用的信息：开发者、榜单排名、风格、截图、视频封面
get_directory_screens	否	按顺序提供截图图片，供 Agent 查看
get_app_videos	文件需 Pro	预览视频封面；使用 Pro 可下载 mp4
get_app_history	Pro	上架信息的历史版本
create_api_key	否	创建密钥；需在浏览器中领取
get_screenshots	实时查询需密钥	查询你的应用当前的 App Store 截图
create_restyle	是	将你的截图改成资源库中应用的风格
create_localize	是	将你的截图翻译成其他语言
get_job_group、approve_restyle、list_results	是	跟踪并批准生成任务

skills/magicscreenshots/SKILL.md 中的技能会指导 Agent 如何进行灵感调研、制作 App Store 截图、本地化以及研究预览视频。

定价

• 免费：搜索资源库并查看截图。
• Library Pro：$19，可下载预览视频并查看上架历史。
• Team：每席位 $49。
• 图像额度：生成（改风格和本地化）按张付费。

当前价格：https://www.magicscreenshots.com/pricing

法律声明

资源库中的截图和预览视频归其开发者所有。MagicScreenshots 展示这些内容仅供参考和研究。请勿将其作为你自己的 App Store 素材重复使用。

维护

MagicScreenshots 应用仓库中的网页副本 public/.well-known/agent-skills/magicscreenshots/SKILL.md 是源文件。将其原样复制到此处：

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

如果两个副本不一致，或者 agent-skills/index.json 中的摘要已过期，应用仓库的 scripts/agent-cli.test.mjs 测试就会失败。

许可证

MIT © Humanleap。请参阅 LICENSE。