CropDen: image sizes and AI image tools

social-media-image-sizes

14 のプラットフォームに対応した画像サイズです。セーフゾーン、アップロード上限、最小サイズを含む 55 種類のサイズに加え、パスポート写真とビザ写真の仕様を 6 種類掲載しています。JSON、npm パッケージ、エージェントスキル、MCP サーバーとして提供しています。データは CC BY 4.0 で公開されています。

ウェブサイト · JSON · 中国語の説明

多くのサイズ一覧は幅 × 高さまでしか記載していません。画像を切り抜くときには、アプリが画像の上に何を重ねるかも知る必要があります。たとえば、YouTube のバナーに重なるプロフィール画像、ストーリーの下部に表示されるキャプションバー、4:5 の Instagram 投稿をトリミングする 3:4 のプロフィールグリッドなどです。このデータセットでは、こうした領域をピクセル単位で掲載しています。

まずは一覧を見る

各行にサイズを 1 つ掲載しています。各グループには、ほかにも複数のサイズがあります。

プラットフォーム	画像	サイズ（px）	比率	CropDen で切り抜く
Instagram	縦向き投稿（3:4）（ほか 3 種類）	1080 × 1440	3:4	切り抜く
Instagram	ストーリー（ほか 2 種類）	1080 × 1920	9:16	切り抜く
Instagram	プロフィール画像（ほか 1 種類）	320 × 320	1:1	切り抜く
YouTube	チャンネルバナー（ほか 1 種類）	2560 × 1440	16:9	切り抜く
YouTube	動画サムネイル（4K）（ほか 2 種類）	3840 × 2160	16:9	切り抜く
YouTube	ショート（9:16）（ほか 1 種類）	1080 × 1920	9:16	切り抜く
Facebook	カバー写真（ほか 2 種類）	851 × 315	2.70:1	切り抜く
Facebook	フィード投稿（4:5）（ほか 3 種類）	1080 × 1350	4:5	切り抜く
Discord	プロフィールバナー（ほか 3 種類）	600 × 240	5:2	切り抜く
Discord	カスタム絵文字（ほか 2 種類）	128 × 128	1:1	切り抜く
LinkedIn	プロフィール背景（ほか 3 種類）	1584 × 396	4:1	切り抜く
X (Twitter)	ヘッダー写真（ほか 3 種類）	1500 × 500	3:1	切り抜く
Twitch	プロフィールバナー（ほか 3 種類）	1200 × 480	5:2	切り抜く
TikTok	動画／写真スライド（ほか 2 種類）	1080 × 1920	9:16	切り抜く
Pinterest	標準ピン（2:3）（ほか 2 種類）	1000 × 1500	2:3	切り抜く
Snapchat	ストーリー／スポットライト	1080 × 1920	9:16	切り抜く
Etsy	商品写真（4:3）（ほか 2 種類）	3000 × 2250	4:3	切り抜く
Shopify	商品画像	2048 × 2048	1:1	切り抜く
eBay	出品写真	1600 × 1600	1:1	切り抜く
Amazon	メイン商品画像	2000 × 2000	1:1	切り抜く

パスポート写真（CropDen で作成）：

書類	ピクセル	印刷サイズ
米国のパスポートとビザ	600 × 600	50.8 × 50.8 mm
英国のパスポート	600 × 771	35 × 45 mm
EU／シェンゲン	600 × 771	35 × 45 mm
カナダ	600 × 840	50 × 70 mm
オーストラリア	600 × 771	35 × 45 mm
中国のビザ	600 × 873	33 × 48 mm

すべてのサイズとそのゾーンは data/social-media-image-sizes.json にあります。ブラウザーで画像をいずれかのサイズに切り抜くには、最後の列にあるリンクをクリックしてください。

使い方

npm

npm install social-media-image-sizes

import { getSize, groups } from 'social-media-image-sizes';

const post = getSize('instagram-post/portrait-34');
// { width: 1080, height: 1440, ratio: '3:4', exact: true, ... }

const youtube = groups.filter((g) => g.platform === 'YouTube');

CommonJS も使用できます：const { getSize } = require('social-media-image-sizes')。

HTTP 経由で JSON を取得する

const res = await fetch('https://cropden.com/data/social-media-image-sizes.json');
const { groups, passportPhotos } = await res.json();

このエンドポイントではクロスオリジンリクエストが許可されており、1 時間キャッシュされます。

AI エージェントと一緒に使う

適切なサイズで画像を作成するスキル

skills/social-media-image-sizes は、SKILL.md を読み込む Claude Code、Codex、Cursor などのエージェント向けの Agent Skill です。「この写真を YouTube バナーにして」や「Instagram ストーリーのサイズは？」と尋ねると、適切なサイズを選び、sharp を使ってお使いのマシン上で画像をトリミングし、ファイルサイズをアップロード上限以下に保ちながら、対象領域を赤く示したプレビューを描画します。

npx skills add geektao1024/social-media-image-sizes

または、フォルダーを ~/.claude/skills/（Claude Code）またはエージェントのスキルフォルダーにコピーしてください。

MCP サーバー：サイズ情報と AI 画像ツール

CropDen は、https://cropden.com/mcp でリモート MCP サーバーを実行しています（Streamable HTTP）。

ツール	機能	料金
get_image_sizes	このデータセットのサイズ、安全領域、アップロード上限を取得します	無料、キー不要
ai_extend_image	画像を横長または縦長に拡張します（アウトペインティング）	5 クレジット
ai_upscale_image	2 倍または 4 倍にアップスケールします	8 または 12 クレジット
ai_remove_background	透明な PNG にします	1 クレジット
get_ai_task, get_credit_balance	長時間の処理や残高を確認します	無料、キーが必要

Claude Code：

claude mcp add --transport http cropden https://cropden.com/mcp \
  --header "Authorization: Bearer YOUR_CROPDEN_API_KEY"

その他のクライアント：同じヘッダーを設定した Streamable HTTP サーバーとして、https://cropden.com/mcp を追加してください。cropden.com の「Settings」→「API keys」からキーを取得できます。AI ツールではウェブサイトと同じクレジットを使用し、処理に失敗した場合はクレジットが返金されます。キーがない場合は、get_image_sizes のみ使用できます。

エントリーの内容

フィールド	意味
id	<group>/<size>。例：youtube-banner/banner
width、height	書き出し時のピクセル数
ratio	アスペクト比。例：3:4
exact	false の場合、比率のみが重要です
recommended	グループに複数のサイズがある場合に推奨するサイズ
minWidth、minHeight	プラットフォームが受け付ける、または必要とする最小のアップロードサイズ
maxBytes	アップロード上限（バイト単位。1 MB = 1,000,000）
zones	ピクセル単位の領域：safe-area（コンテンツをこの範囲内に収めます）、ui-overlay（アプリによって覆われます）、crop-preview（別のビューに表示される範囲）
zones[].measured	実際のアプリで測定済み。プラットフォームは公開していません
zones[].x、y、...	画像の左上からのピクセル数。領域は画像の端を越えることがあります。たとえば、バナーの下部に重なるプロフィール画像など
note	英語と中国語で書かれた一行のヒント

各グループには、formats、facts（動画の長さなど）、verified、CropDen でトリミングするための url もあります。パスポート写真には、印刷サイズ（ミリメートル単位）と、写真の高さに対する割合で示した頭部と目のラインの範囲が追加されます。

数値の確認方法

• まずプラットフォームのヘルプページを参照します。プラットフォームが情報を公開していない場合（たとえば Instagram のプロフィール画像）は、現在のガイドで一致しているサイズを使用します。
• measured: true の領域はアプリ上で測定したものです。アプリのボタンの位置は変わるため、目安としてお使いください。
• verified は、グループの最終確認月を示します。すべてのグループの出典リンクは 0.2.0 で追加予定です。
• サイズが古くなっている場合は、出典へのリンクを添えて issue を作成してください。

プラットフォームが公式に公開している値のみを使いたい場合は、The Social Specification をご利用ください。そこでは、それ以外のすべての値が「未文書化」として示されています。このデータセットはトリミング用に作られているため、実用的なサイズとセーフゾーンでそうした不足を補っています。

ウェブサイトについて

トリミングには CropDen をご利用ください。サイズを選び、お手持ちの画像にセーフゾーンを重ねて確認し、正確なピクセルサイズでアップロード上限以下の画像を書き出せます。トリミングとリサイズのツールはブラウザー上で動作します。サイトには一括リサイズ機能と、拡張、アップスケール、背景削除などの AI ツールもあります。

ライセンス

• データ（data/ と、index.js および index.cjs に含まれる同じデータ）：CC BY 4.0。次のようにクレジットを表示してください：Image size data by CropDen (https://cropden.com), CC BY 4.0。ウェブサイトでは、リンクを掲載すれば十分です。
• コード：MIT。

謝辞

SammaPix（MIT）は、対象とするプラットフォームとパスポート写真を選ぶ際の最初の参考資料として利用し、そのデータファイルと照らし合わせてサイズを確認しました。

この情報が検索の手間を省けたなら、スターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

Geektao が公開しながら開発しました（@geektao0319、中国語で投稿）。