Green Screen Memes

Green Screen Memes API の使用例

Green Screen Memes API のコピーして使える例です。 約2,100本のグリーンスクリーンのミーム動画（緑、青、または赤の単色背景に映る、トレンドのリアクションミーム。ほとんどにオリジナルの音声が付いています）を、リアクション、動作、または被写体で検索でき、REST または MCP 経由で利用できます。新しい動画は毎日追加されます。

各例では動画を検索してダウンロードし、お手持ちの写真や動画に合成して、Shorts、Reels、TikTok 向けの 1080x1920 MP4 に仕上げます。

Claude Code プラグインとして使う

このリポジトリは Claude Code プラグインのマーケットプレイスでもあります。このプラグインは MCP サーバーをセットアップし、キャプションの作成、動画の検索、ffmpeg による合成を行う make-memes スキルを追加します。ミームを 1 つ作ることも、まとめて作ることもできます。Claude Code を起動するシェルで GSM_API_KEY（無料キー）を設定してから、次を実行します。

/plugin marketplace add green-screen-memes/green-screen-memes-api
/plugin install green-screen-memes@green-screen-memes

その後、「自分のビジネス用にミームをたくさん作りたい」のように依頼してください。Codex などのエージェントについては、同じワークフローと MCP のセットアップ方法が記載された AGENTS.md を参照してください。

例	内容	実行方法
claude-code/	MCP サーバーに接続し、1 つのプロンプトからミームを作成します	claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp --header "Authorization: Bearer $GSM_API_KEY"
node/	Node 18 以降で、依存関係なしに検索、ダウンロード、合成します	node examples/node/meme.mjs "shocked cat" background.jpg
python/	Python 標準ライブラリを使って同じ処理を行います	python3 examples/python/meme.py "shocked cat" background.jpg
ffmpeg/	curl と ffmpeg のスクリプトで、写真または音声をミックスした動画に合成します	examples/ffmpeg/key-over-image.sh background.jpg greenscreen.mp4 green
remotion/	キーイング済みの透明な動画クリップを使った Remotion のコンポジションです	cd examples/remotion && npm install && npm run studio
trending-to-short/	今日のトレンド 1 位の動画を縦型ショートにします	node examples/trending-to-short/trending-to-short.mjs background.jpg

MCP のセットアップ以外は、すべて PATH 上に FFmpeg（ffprobe を含む）が必要です。

1. 無料キーを取得する

https://api.greenscreenmemes.app/dashboard にサインイン（Google またはメールリンク）し、無料の Sandbox キーを作成します。開発とテスト用に、動画を合計 50 回ダウンロードでき、月あたり 30,000 回の API 呼び出しが可能です。次に、以下を実行します。

cp .env.example .env          # put your key in GSM_API_KEY
set -a; source .env; set +a   # or: export GSM_API_KEY=gsm_live_...

キーはご利用のマシンまたはサーバーに保管してください。この API は CORS ヘッダーを送信しないため、ブラウザーではなくバックエンドから呼び出してください。

2. AI エージェントから使う（MCP）

claude mcp add --transport http green-screen-memes https://api.greenscreenmemes.app/mcp \
  --header "Authorization: Bearer $GSM_API_KEY"

Cursor などの MCP クライアントでは、URL https://api.greenscreenmemes.app/mcp と同じ Authorization ヘッダーを使用してください。すぐに使える設定は examples/claude-code にあります。このサーバーは、公式 MCP Registry に app.greenscreenmemes.api/green-screen-memes としても登録されています。

次のように依頼できます。

コーヒーショップ用のミームを作ってください。誰か、または何かが心から安堵したり喜んだりしているグリーンスクリーン動画を見つけ、縦型動画として ./shop.jpg にキーイング合成し、「Monday, fixed.」というキャプションを付けてください。

ツール：search_green_screens、get_green_screen（動画リンクと、すぐに使える ffmpeg コマンド）、get_trending、list_collections、get_collection、list_tags、get_usage。

3. REST を呼び出す

curl -H "Authorization: Bearer $GSM_API_KEY" \
  "https://api.greenscreenmemes.app/v1/memes?q=side%20eye&limit=5"

エンドポイント
GET /v1/memes?q=&tag=&color=&updatedSince=&limit=&cursor=	グリーンスクリーンを検索または一覧表示します
GET /v1/memes/{id}	1 件のグリーンスクリーン（id は URL エンコードしてください）
GET /v1/trending	Green Screen Memes アプリで現在トレンドになっているものを、rank とともに返します
GET /v1/collections、GET /v1/collections/{id}	厳選されたコレクション
GET /v1/tags	使用頻度の高いタグ
GET /v1/usage	ご利用中のプランと今月の使用量
GET /v1/removed?since=	権利者の要請により削除されたクリップ

一覧では { data, total, nextCursor } が返されます。エラーでは { error: { code, message } } が返されます。 各クリップには id、name、description、tags、chromaKeyColor（green、blue、 red または none）、durationSeconds、thumbnailUrl、videoUrl が含まれます。メディアリンクは ご利用のキーに対して署名され、有効期限は約 6 時間です。ファイルをダウンロードし、リンクを 保存しないでください。

詳細なリファレンス：https://api.greenscreenmemes.app/docs · OpenAPI：https://api.greenscreenmemes.app/v1/openapi.json · LLM 向け：https://api.greenscreenmemes.app/llms.txt

4. FFmpeg でクロマキー合成する

写真の上に合成する場合（縦型 1080x1920、クリップを下部に配置し、クリップの音声を保持します）：

ffmpeg -loop 1 -i background.jpg -i greenscreen.mp4 -filter_complex \
 "[0:v]scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,setsar=1[bg];\
  [1:v]chromakey=0x00ff00:0.2:0.05,scale=1080:-2[fg];\
  [bg][fg]overlay=(W-w)/2:H-h:shortest=1,format=yuv420p[v]" \
 -map "[v]" -map "1:a?" -c:v libx264 -crf 20 -c:a aac meme.mp4

キーの色：緑 0x00ff00、青 0x0000ff、赤 0xff0000。none の場合、クリップは そのまま使用されます。緑の縁が残る場合は 0.2 を少し上げ、被写体の一部が透ける場合は下げてください。音声が混在する動画に合成する場合は、 examples/ffmpeg を参照してください。

動画ミーム API

動画ツール、ショート動画コンテンツのパイプライン、またはミームアプリを構築していて、画像テンプレートではなく 実際の動画ミームが必要なら、この API が役立ちます。単色のキー背景に音声が付いた短い MP4 クリップと、それらを検索するためのメタデータ、および合成用の ffmpeg コマンドを提供します。ミームの生成や、 お手持ちの映像からの背景削除は行いません。すぐに使えるグリーンスクリーンを集めたライブラリを提供します。

リアクションクリップ API

クリップにはその内容に応じたタグが付いているため、感情や動作で検索すると効果的です：shocked、slow clap、side eye、crying、happy dance、waiting。 GET /v1/tags でライブラリに含まれる内容を確認でき、GET /v1/trending では Green Screen Memes アプリで現在よく使われているものが返されます。ローカルコピーを 同期するには、GET /v1/memes?updatedSince=<ISO date> をポーリングし、 GET /v1/removed に記載されているものを削除してください。

ミーム用 MCP サーバー

https://api.greenscreenmemes.app/mcp の MCP サーバーを使うと、Claude Code、Cursor、またはシェルを使える エージェントが、クリップを検索し、ダウンロードリンクを取得して、自ら合成を実行できます。get_green_screen はそのクリップのキーの色に対応した ffmpeg コマンドを返すため、 エージェントがフィルターグラフを考える必要はありません。キーや制限は REST と同じです。 ツール呼び出しごとに 1 回分としてカウントされます。

クリップの利用方法

これらはインターネット上のミームです。Green Screen Memes はグリーンスクリーン版を作成し、タグ付けと厳選を行い、検索機能を提供しています。元の映像は当社のものではなく、 API はその利用を許諾するものではありません。 クリップの利用方法はご自身の責任です。

• 有料プランでは、アプリや、ご自身またはクライアント向けに公開する動画でクリップを使用できます。サンドボックスキーは開発とテスト用です。
• 企業自身またはクライアントのアカウントでのオーガニック投稿は、人が映っている場合も含めて問題ありません。
• 人物を特定できるクリップは、有料広告、スポンサー付き投稿、または推薦に使用できません。動物、物、漫画はその用途に使用できます。
• 新しい制作物に GET /v1/removed に記載されているクリップを使用しないでください。また、保管しているものからも削除してください。

利用規約全文：https://api.greenscreenmemes.app/terms

ライセンス

このリポジトリ内のサンプル コード は MIT ライセンスです。適用対象はコードのみです。このリポジトリにクリップは含まれておらず、API から取得するクリップ、サムネイル、カタログデータには MIT ではなく、 API 利用規約が適用されます。

お問い合わせ：[email protected] · Green Screen Memes は Hedko Group LLC が運営しています。