MagicScreenshots

エージェント向け MagicScreenshots

何千もの人気アプリの実際の App Store スクリーンショットとプレビュー動画を集めたライブラリを AI エージェントに提供します。ライブラリは毎日更新されます。さらに、独自の App Store スクリーンショットを生成し、ローカライズできます。

• ライブラリ：Apple の各カテゴリで、無料アプリと売上上位アプリのトップ 100 を掲載しています。スクリーンショット、プレビュー動画、掲載履歴を確認できます。
• 検索：カテゴリ、今日のランキング、デザイン（ダーク、見出し、デバイスフレーム、ライフスタイルなど）、アプリ名で検索できます。
• 生成：ライブラリ内のアプリのようにスクリーンショットのスタイルを変更したり、App Store の解像度で 40 以上の言語に翻訳したりできます。

各エージェント向けのセットアップガイド：https://www.magicscreenshots.com/agents

MCP エンドポイント（Streamable HTTP）：https://www.magicscreenshots.com/api/mcp

インストール

検索に API キーは不要です。生成、動画のダウンロード、掲載履歴の確認には API キーが必要です。エージェントに create_api_key を呼び出すよう依頼するか、magicscreenshots.com の Settings > API でキーを作成し、MAGICSCREENSHOTS_API_KEY を設定してください。

スキルに対応するすべてのエージェント（Claude Code、Codex、Cursor、Cline、Windsurf など）

npx skills add Humanleap/magicscreenshots-mcp

これはスキルのみをインストールします。エージェントがツールを呼び出せるように、MCP サーバーも追加してください（以下を参照）。

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	不要	1 つのアプリの開発者、ランキング、デザイン、スクリーンショット、動画ポスターを表示します
get_directory_screens	不要	エージェントが確認できる画像として、順番に並んだスクリーンショットを取得します
get_app_videos	ファイルには Pro が必要	プレビュー動画のポスターを表示します。mp4 のダウンロードには Pro が必要です
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 のスキルでは、エージェントがインスピレーションレビューを実施し、App Store スクリーンショットを作成してローカライズし、プレビュー動画を調査する方法を説明しています。

料金

• 無料：ライブラリを検索してスクリーンショットを閲覧できます。
• Library Pro：$19。プレビュー動画のダウンロードと掲載履歴が追加されます。
• Team：1 シートあたり $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

アプリのリポジトリにある scripts/agent-cli.test.mjs は、2つのコピーが異なる場合、または agent-skills/index.json のダイジェストが古い場合に失敗します。

ライセンス

MIT © Humanleap。LICENSE を参照してください。