Claude CodeでInstagram投稿を完全自動化する方法【Pencil MCP × Meta Graph API】

なぜInstagram投稿を自動化するのか

手動運用で消耗する6つのポイント

Instagramのカルーセル投稿は、1本あたりの情報量が多く、フォロワー獲得効率が高い反面、制作工数が他のSNSより圧倒的に重いのが現実です。僕が手動運用していた頃の内訳を正直に書くと、以下のようになっていました。

合計すると、1投稿におおよそ1〜2時間かかります。週2本のペースで投稿すると、月に換算して10時間前後はSNS運用で消えていく計算です。個人開発者にとってこれは致命的で、本来プロダクト開発に充てられるはずの時間を、SNSの作業に毎週持っていかれることになります。

なぜClaude Codeが自動化のハブに向いているのか

SNS自動化というと、まず思い浮かぶのはZapierやMake、あるいはn8nのようなワークフロー自動化ツールかもしれません。ただ、カルーセル投稿のように「デザイン生成」と「API呼び出し」を両方含むフローだと、GUIベースの自動化ツールだと逆に組みにくくなります。デザインの微調整やテキストの差し替えは、結局手作業に戻ってしまうからです。

その点、Claude Codeは「自然言語で指示して、ツールを複数横断しながらファイルを書き換える」ことを得意とするエージェントです。Pencil MCPが対応しているからデザイン生成ができて、ローカルでPythonスクリプトが動かせるからAPI投稿までできる。これが、GUIワークフローツールにはない強みです。

さらに、Claude Codeにはスキル・カスタムコマンドの仕組みがあり、「毎回やる一連の流れ」を再利用可能な形で定義できます。詳しくはClaude Codeのカスタムコマンド活用術で解説していますが、「今回のフローをスキルとして保存」しておくだけで、次回以降は1つのコマンドで投稿完了まで持っていけます。

この記事で自動化する範囲

前提として、この記事で作る自動化フローは「1人の発信者が、Instagramビジネスアカウント1つに対して投稿する」ケースを対象にしています。複数アカウントの一斉配信や、メンバー複数人での投稿承認フローなどは、別の設計が必要です。

また、この記事では画像のみのカルーセル投稿を扱います。リール動画やストーリーズ、ショッピングタグなどの拡張機能については、Meta Graph APIの対応範囲は広がっているものの、スコープが膨らみすぎるため本記事では触れません。

自動化フローの全体像——4つのステップ

4ステップの流れ

自動化フローは、大きく以下の4ステップに分かれます。それぞれのステップをClaude Codeのスキル / カスタムコマンドとして定義しておくのがポイントです。

1つのClaude Codeセッションの中で、これらを順番に実行していきます。会話の中で「投稿計画を作って→台本→デザイン→投稿」と連続して進めていけるのが、従来のワークフローと大きく違う点です。

Before / After 比較

自動化フローを整えた前後で、各工程がどう変わったかを表で比較します。

前提となる環境

このフローを動かすには、以下の環境が必要です。

• Claude Code：ターミナルから使う前提。公式のMCP設定でPencil MCPを有効化しておく（Claude Codeの使い方参照）
• Pencil：MCPサーバーが組み込まれているデザインエディタ。.penファイルで作業する（Pencil.devの使い方参照）
• Instagramビジネス or クリエイターアカウント：通常の個人アカウントではAPIから投稿できない
• Meta for Developersのアプリ：Instagram Graph API利用のための登録が必要
• AWS S3（または同等の画像ホスティング）：Instagram APIは公開URLから画像を読み込むため、どこかにアップロード先が必要
• Python 3.x：投稿スクリプトを動かす。外部ライブラリ不要（標準ライブラリのみ）

Step 1: 投稿計画とマークダウン台本の作成

投稿計画はClaude Codeとの会話で決める

最初のステップは投稿計画です。ここは、いきなりツールを叩くのではなく、Claude Codeとの会話ベースで構成を固めていくのがコツです。

たとえば僕の場合、プロンプトはこんな感じで始めます。

「Claude CodeのHooks設定テンプレについて、Instagramカルーセル投稿を作りたい。
ターゲットは個人開発者で、『知らない人が損してる』というトーン。
10枚以内でまとめたい。構成案を出して」

すると、Claude Codeが以下のような構成を提案してくれます。

• カバー：タイトル + 興味喚起
• 導入：Hooksとは何か（1スライド）
• テンプレ①〜④：具体的な設定例（4スライド）
• 組み合わせ例：実際の settings.json 全体像
• まとめ：要点の再確認
• CTA：フォロー誘導

Instagramのカルーセルは最大10枚なので、この10スライド以内に収める構成を組みます。10枚を使い切る必要はなく、7〜8枚で完結したほうがエンゲージメント率が高くなる傾向は僕の体感としてあります（最後まで見てもらいやすい）。

マークダウン台本のフォーマット

構成が固まったら、各スライドのテキストをマークダウンでまとめます。このマークダウンが、後のPencil MCPでのデザイン生成の「原稿」になります。フォーマットはシンプルで構いません。

## スライド1（カバー）
知ってる人だけ得してる
Hooks設定テンプレ4選

## スライド2（導入）
Hooksとは？
Claude Codeの特定のタイミングで
自動的にコマンドを実行する仕組み。

設定場所:
~/.claude/settings.json

## スライド3（テンプレ①）
① 効果音で通知
Claude Codeの作業完了時に
効果音で知らせてくれる設定。

```json
"Notification": [{
  "command":
    "afplay /System/Library/
     Sounds/Glass.aiff"
}]
```

このフォーマットで書くと、Pencilデザイン生成時に「スライド何番に、何を載せればいいか」が一意に決まります。Claude Codeが迷わず実装に進める構造になっていることが重要です。

1スライドあたりの文字量の目安

Instagramのカルーセルはフォーマット上、スマホの画面1枚で完結する情報量に収めるのが正解です。実際にやってみて、僕は以下のルールに落ち着きました。

良い台本と悪い台本の例

Hooksの「効果音で通知」のスライドを例に、良い・悪いを比較します。

悪い例（詰め込みすぎ）

## スライド3
Hooksの設定で作業完了時に効果音を鳴らすようにしておくと、
長いビルド作業の終わりなどをすぐ察知できるので便利です。
設定方法は以下の通りです。まず~/.claude/settings.jsonを開き、
hooksセクションのNotificationに以下を追加してください。
（以下コード略）

良い例（1点集中）

## スライド3
① 効果音で通知
作業完了時に効果音を鳴らす

```json
"Notification": [{
  "command": "afplay Glass.aiff"
}]
```

悪い例は、文章をそのままスライドに落とし込もうとしています。良い例は、「見出し＋1行説明＋コード」の三層構造で、指を止めて読むのに必要な情報量だけに絞り込まれています。Instagramは読者がスワイプで流し見する媒体なので、1スライド＝1メッセージに徹するのが結果として情報を伝える近道になります。

Step 2: Pencil MCPでカルーセルデザインを自動生成

使うPencil MCPツール

ここが自動化フローの核心部分です。Pencilは、MCPサーバーを内蔵したデザインエディタで、.penファイルを Claude Codeから直接読み書きできます。基本的な使い方はPencil × Claude Code連携ガイドにまとめていますが、カルーセル生成で使うツールは以下の5つに集約されます。

カルーセル生成の手順

Claude Codeは、以下の順序でカルーセルデザインを組み立てていきます。

1. フレーム作成：1080×1350pxのフレームを、スライド枚数分だけキャンバス上に並べる
2. ヘッダー配置：各スライド上部に、カテゴリやタイトルを入れた帯を置く
3. カード配置：白背景＋角丸のカード内にテキストを配置
4. コードブロック：コード部分はダーク背景＋モノスペースで視覚的に差別化
5. 装飾要素の配置：キャラクターやふきだしなど、自分のブランドに合わせたパーツを追加
6. スクリーンショットで確認：get_screenshotで見た目を一枚ずつレビュー

batch_designの具体的な操作例

実際のbatch_design呼び出しは、ちょっとしたスクリプトのように書きます。たとえばテキストの更新は以下の1行です。

U("nodeId", { content: "新しいテキスト" })

コードブロックの挿入は、フレーム＋テキストの2ステップで書きます。

codeBlock = I("parentId", {
  type: "frame",
  fill: "#1e1e2eff",
  cornerRadius: 16,
  padding: 24,
  width: "fill_container"
})
codeText = I(codeBlock, {
  type: "text",
  content: "コードの内容",
  fontFamily: "Roboto Mono",
  fontSize: 34,
  fill: "#e2e8f0ff"
})

これを、スライドの枚数分だけClaude Codeが自動で展開してくれる、というイメージです。1つのbatch_design呼び出しには最大25個程度までの操作をまとめて渡せるので、10枚のカルーセルでも数回の呼び出しで組み上がります。

スキルに書いておくデザインルール

Pencilでカルーセルを毎回同じ品質で生成するには、デザインルールをスキルファイルに書き込んでおくのが必須です。僕は以下のようなルールを定義しています（実際の.claude/skills/feed-pencil-design/SKILL.mdの抜粋）。

## デザインルール
- フレームサイズ: 1080x1350px
- 背景色: #f3f8fe
- ヘッダー: 黒背景 + 白テキスト (76px, Noto Sans JP, 900)
- 本文: ダークグレー (#333333), 48px
- コードブロック: ダーク背景 (#1e1e2e) + モノスペースフォント (Roboto Mono)
- 角丸: カード16px、ヘッダー24px
- スライド間の横間隔: 80px

フォントサイズやカラーコードまで指定しておくと、Claude Codeが毎回ブレないデザインを生成してくれるようになります。ここの解像度が自動化フローの品質を決めるので、最初は手を抜かずに書き出すのがおすすめです。

画像の書き出し

デザインが完成したら、export_nodesでJPEG に書き出します。InstagramはJPEG推奨なので、PNGではなくJPEGで出しておきます。

export_nodes({
  nodeIds: ["slide1", "slide2", ..., "slide10"],
  format: "jpeg",
  outputDir: "./export"
})

書き出し後、.penファイル上のx座標の昇順でソートすることだけ忘れないでください。Pencilで並べたときの「左→右」の順序が、そのままInstagramでの並び順になります。

Step 3: Meta Graph APIでInstagramに投稿する仕組み

なぜAPI経由で投稿するのか

ここまでで画像は完成しているので、あとはInstagramに投稿するだけです。ただ、スマホから手動で投稿してしまうと、せっかくのデザイン自動化が「ラストワンマイル」で切れてしまいます。Meta Graph APIを使うと、PCから画像とキャプションを指定するだけでInstagramに直接投稿できます。

InstagramのAPI投稿は、Instagramビジネスアカウント or クリエイターアカウントで、Facebookページと連携済みであることが条件です。個人アカウントのままだとAPI経由の投稿はできないので、必要ならプロアカウントに切り替えておいてください。

カルーセル投稿は3段階のAPI呼び出し

Instagram Graph APIでカルーセル投稿を行うには、3段階のAPI呼び出しが必要です。ここはAPIの仕様なので、どんなライブラリを使っても同じ構造になります。

# ① 各画像のコンテナを作成
POST /{account_id}/media
  image_url: "画像のURL"
  is_carousel_item: true

# ② カルーセルコンテナを作成
POST /{account_id}/media
  media_type: CAROUSEL
  children: [container_id_1, container_id_2, ...]
  caption: "キャプション"

# ③ 公開
POST /{account_id}/media_publish
  creation_id: carousel_container_id

ポイントは、①のコンテナ作成後すぐに②を呼ぶと失敗することです。Instagram側でメディアの処理に時間がかかるため、ステータスが「FINISHED」になるまでポーリングする必要があります。

ステータスのポーリング処理

僕のスクリプトでは、各コンテナの作成後に最大120秒までステータスをポーリングしています。GET リクエストでstatus_codeフィールドを確認し、FINISHEDになったら次のステップに進む、という実装です。

ポーリング間隔は2〜3秒程度が目安です。それ以下にすると1時間あたりのAPI呼び出し上限（アプリ単位200件）に当たりやすくなるので注意してください。

Pythonスクリプトの構造

僕のスクリプトはscripts/instagram_post.pyに置いてあり、外部ライブラリ不要（標準ライブラリのみ）で動きます。HTTPリクエストはurllib.requestを使い、JSONのパースはjsonモジュールで十分です。

python3 scripts/instagram_post.py \
  --images "https://s3.../slide1.jpeg" \
           "https://s3.../slide2.jpeg" \
           ... \
  --caption "キャプションテキスト"

スクリプト内部では、①〜③のAPI呼び出しを順番に実行し、各ステップで必要なポーリングを挟みます。requestsなどのサードパーティライブラリを避けているのは、Claude Codeから呼び出すだけのスクリプトに依存を増やしたくないためです。pipインストール不要で、Python 3.xが入っていればどこでも動きます。

Meta Graph APIのセットアップ手順

Meta Graph APIを使うには、事前にMeta for Developersでアプリを作成する必要があります。僕が最初にセットアップしたときのメモから、必要最小限の手順を整理します。

1. Meta for Developersにアカウント作成：developers.facebook.com でFacebookアカウントでログインし、「マイアプリ」から新規アプリを作成。アプリタイプは「ビジネス」を選ぶ
2. Instagram Graph API を追加：アプリのダッシュボードで「製品を追加」→「Instagram Graph API」を追加する
3. アクセストークンを発行：Graph API Explorerで以下の権限を付けて発行する
   • instagram_basic
   • instagram_content_publish
   • pages_read_engagement
4. 短期トークンを長期トークンに変換：短期トークンの有効期限は1時間、長期トークンは約60日。毎回発行し直すのは現実的ではないので、必ず長期トークンに変換しておく
5. Instagram Business Account IDを取得：Facebookページに紐づくInstagramアカウントのIDを取得する
6. .envに設定：INSTAGRAM_BUSINESS_ACCOUNT_IDとINSTAGRAM_ACCESS_TOKENを.envに保存し、Pythonスクリプトから読み込む

長期トークンは約60日で切れるので、期限が近づいたら再発行する運用を組んでおくのが安全です。僕はカレンダーに「2ヶ月ごとにトークン再発行」のリマインダーを置いています。ここをサボるとある日突然APIが400エラーを返し始めるので要注意です。

Step 4: Claude Codeスキルとして一気通貫フローを作る

なぜスキルとして定義するのか

ここまでの3ステップを毎回手順書を見ながら動かすのは現実的ではありません。そこで、Claude Codeのスキル / カスタムコマンドとして登録して、一言で呼び出せるようにします。スキル化すると、以下のメリットが得られます。

スキルファイルの構造

僕の構成では、用途ごとにスキルを分けています。デザイン側と投稿側を別にしておくと、どちらかだけ改修したいときに楽です。

• .claude/skills/feed-pencil-design/SKILL.md：Pencilで .penファイルにカルーセルを生成するスキル
• .claude/commands/instagram-post.md：書き出し〜S3アップロード〜投稿を担うカスタムコマンド
• scripts/instagram_post.py：Meta Graph APIを叩くPythonスクリプト本体

/instagram-post コマンドの中身

投稿側のカスタムコマンドは、以下のような簡潔な指示書になっています。Claude Codeは、この指示に沿って各ツールを順番に呼び出します。

# .claude/commands/instagram-post.md の例

1. ユーザーから対象カルーセルのNode IDを受け取る
2. x座標の昇順でソート（.penファイル上の左→右の並び順）
3. export_nodesでJPEGにエクスポート
4. /s3-upload で各画像をS3にアップロードしてURLを取得
5. 画像内容に基づいてキャプションとハッシュタグを生成
6. 最終キャプションをユーザーにレビュー依頼
7. 承認後、scripts/instagram_post.py を実行して投稿

ポイントは「6. 最終キャプションをユーザーにレビュー依頼」の部分です。キャプションはLLMに全部任せるとたまに違和感のある表現になるので、投稿の直前だけ人間が確認する工程を意図的に残しています。ここを挟むだけで、意図しない投稿事故を防げます。

実際の呼び出し例

全部揃った状態でのClaude Codeとのやりとりは、こんな感じになります。

User: Claude CodeのHooks設定テンプレについて
      Instagram投稿を作って

Claude: 構成案を作ります。
        [10枚構成の提案]

User: いいね、このまま進めて

Claude: [Pencil MCPを使ってカルーセル生成]
        [get_screenshotで各スライドを確認]

User: 3枚目のコードが少し長いから
      2行詰めて

Claude: [該当箇所を更新]

User: OK、このままインスタに投稿しといて

Claude: [export → S3 → API投稿]
        投稿完了しました。

企画から投稿まで、1つのClaude Codeセッションで完結するのがわかるかと思います。手動でやっていた頃の1〜2時間の作業が、15〜20分程度の会話に置き換わるイメージです。

実運用で使える応用テクニック

テーマ別にテンプレートを使い分ける

発信を続けていくと、「技術Tips系」「オピニオン系」「事例紹介系」など、いくつかパターンが出てきます。全部を同じデザインテンプレで作ると単調になるので、テーマ別に軽く背景色や装飾を変えたテンプレを2〜3種類用意しておくと運用が長続きします。

たとえば、技術Tips系は青系×コードブロック、オピニオン系は白背景×大きめタイポ、事例紹介系はカード＋スクショ中心、 という具合です。Pencilの.penファイル内に3種類のテンプレフレームを置いておき、スキルからどれを使うかを選べるようにしておきます。

キャプションとハッシュタグの生成戦略

キャプションは、僕のスキル内で以下の構造に固定しています。ここをブレさせないのが、フォロワーにとって「読みやすい投稿主」になる近道だと感じています。

1. フック（1〜2行）：タイトルの言い換え。スワイプしたくなる一文
2. 本文要約（3〜5行）：カルーセルの要点を短く
3. CTA（1〜2行）：フォロー誘導、保存誘導、リンク案内
4. ハッシュタグ（10〜20個）：テーマ固定のものと、記事内容に応じたものを混ぜる

ハッシュタグの数は、少なめ（数個）に絞るべきか、多め（10〜20個）に入れるべきかで運用者の意見が分かれる部分です。僕自身は発見タブからの流入を狙いたいので10〜20個入れる派ですが、ここは自分の運用データを見ながら最適点を探っていくのが現実的です。

予約投稿・バッチ投稿への拡張

Meta Graph APIには、厳密な意味での「予約投稿」エンドポイントはありません（一部の承認済みアプリのみ利用可能）。ただ、スクリプト側で工夫することで、同等のことは実現できます。僕がやっているのは以下のやり方です。

• ローカルcronで時間指定実行：macのcronまたはlaunchdで、決まった時刻に投稿スクリプトを走らせる
• 週末にまとめてストック作成：Claude Codeで3〜5本分のカルーセルを連続で作り、画像をまとめてS3に置いておく
• 投稿当日はコマンド1発：ストックから1本選んで投稿コマンドを叩くだけにする

この運用にすると、週1の「SNSバッチ作成日」さえ確保すれば、あとは毎日数分でSNS運用が回る状態になります。個人開発者として、時間の使い方がかなり軽くなる実感があります。

投稿後の分析とフィードバックループ

投稿して終わり、ではなく、インサイトを取得して次の企画に活かすループを作ると、自動化の価値が何倍にもなります。Meta Graph APIにはインサイト取得用のエンドポイントがあり、以下のようなメトリクスを取れます。

Claude Codeのスキルでインサイト取得スクリプトも書いておくと、「直近5投稿のパフォーマンス比較して」の一言で分析レポートが出てくる状態が作れます。発信を「感覚」ではなく「データ」で改善できるようになるのが、エンジニア発信者の強みです。

レート制限と運用上の注意

Meta Graph APIには、アプリごとに1時間あたり200件のAPI呼び出しというレート制限があります。1つのカルーセル投稿で最低でも「コンテナ作成10回＋カルーセル作成1回＋公開1回＋ポーリング数回」を使うので、1投稿で20回前後のAPI呼び出しが走る計算です。

個人運用であれば1時間200件に当たることはまずありませんが、ポーリング間隔を無闇に短くしないことだけ気をつけてください。2〜3秒間隔でポーリングしていれば、十分安全圏です。また、ERROR時にリトライループを入れる場合は最大回数を必ず設定してください。無限リトライはレート制限を一瞬で使い切る一番の原因です。

よくある質問（FAQ）

個人アカウントのままでもAPI投稿できますか？

いいえ、できません。Instagram Graph APIは、InstagramビジネスアカウントまたはクリエイターアカウントでFacebookページと連携済みのものだけを対象にしています。個人アカウントから切り替えるのは無料でできますし、プロアカウントにしたからといって表示や機能が制限されることはないので、API運用を始めるなら先に切り替えておきましょう。

CanvaではなくPencilを選んでいる理由は？

Canvaは非常に優秀なツールですが、Claude Codeから直接編集する手段が用意されていません。CanvaのAPIはあるものの、デザインをノード単位で細かく書き換えるような用途には向きません。PencilはMCPサーバーが内蔵されており、.penファイルをClaude Codeから直接操作できるので、自動化の相性が段違いに良いのが選定理由です。詳しい比較はPencil vs Figmaの比較記事でも触れています。

S3以外でも画像ホスティングはできますか？

はい、できます。Instagram Graph APIの要件は「パブリックにアクセス可能なHTTPS URL」であること、画像のMIMEタイプが正しいこと、だけです。Cloudflare R2やSupabase Storage、GCPのCloud Storageなど、一時的にパブリックURLが出せる場所ならどれでも動きます。ただし、認証付きURL（署名付きURLの有効期限が短すぎるものなど）は投稿失敗の原因になるので、24時間程度は有効なURLを使うようにしてください。

投稿が失敗するケースでよくある原因は？

実装を何度かやって遭遇した失敗パターンは、主に以下の4つです。

1. トークン期限切れ：長期トークンでも約60日で切れる。400エラーが出たらまず疑う
2. 画像URLが非公開：S3のバケットポリシーを閉じたまま投稿しようとすると失敗する
3. 画像サイズ / 比率の問題：Instagramの仕様を外れる比率（極端な縦長など）は弾かれる
4. ポーリング前に次のAPIを呼んでしまう：status_codeがFINISHEDになる前に ②や③を呼ぶと失敗する

Claude Codeのスキルはどこに置くのが正解？

個人利用であれば、プロジェクト配下の.claude/skills/か、ユーザー全体で使える~/.claude/skills/のどちらかに置けばOKです。SNS運用用のスキルは、基本的にプロジェクトに依存しないので、ユーザー全体側に置いたほうが便利です。Claude Codeカスタムコマンドの記事で置き場所の使い分けを詳しく解説しています。

これから学び始める人はどこから手をつけるべき？

いきなり全工程を作ろうとすると必ず挫折するので、以下の順番で一つずつ動かすのがおすすめです。

1. まずClaude Codeをインストールして、通常の開発で使い慣れる
2. 次にPencil × Claude Code連携で、.penファイルを読み書きできる状態を作る
3. Meta for Developersでアプリを作り、Graph API Explorerから「画像1枚だけの投稿」を手動で成功させる
4. 単一画像をPythonスクリプトから投稿できるようにする
5. 最後にカルーセル対応と、スキル化・自動化を乗せていく

いきなり「10枚カルーセル × スキル化」を目指すと、どこで詰まったかがわからなくなるので、ワンステップずつ動かして、動いた状態でコミットしていくのが最短ルートです。

まとめ：反復作業は「生産ライン」に乗せる

Instagram投稿のように、毎回の構造が決まっている反復作業は、個人開発者にとって自動化の最優先ターゲットです。この記事で扱ったフローのポイントを最後におさらいします。

• 自動化フローは4ステップに分解：計画→台本→デザイン→投稿。各ステップをClaude Codeスキルにする
• Pencil MCPで.penファイルを直接操作：batch_design／export_nodesでカルーセル生成と書き出しを完結
• Meta Graph APIは3段階：コンテナ作成→カルーセル作成→公開。ポーリングを必ず挟む
• キャプションの最終確認だけ人間が残す：全自動にしないことで事故を防ぐ
• インサイトAPIでフィードバックループを作る：感覚ではなくデータで改善する

ShiftBでは、Claude Codeをはじめとするエージェントツールを活用して、「発信・集客・開発」を1人で回せる個人開発者を育てることを目的にしています。この記事のような自動化フローを自分の手で組めるようになると、発信の継続ハードルが一気に下がり、プロダクト開発に使える時間が増えていきます。

自分の発信や開発も「生産ラインに乗せていきたい」と感じた方は、ぜひShiftBのAIシフトコースをのぞいてみてください。この記事のような自動化フローを自分の手で組めるようになるまで、現役エンジニアがサポートします。