creatorloop

なぜ

「Claude 向け Instagram API」サーバーは数多くあります。creatorloop はその代わりに、クリエイターの運用サイクルを実現するために構築されています。

• 感覚ではなく、データから学びます。 成功した投稿と失敗した投稿、それぞれのフック、フォーマットの比較、リーチ 1,000 件あたりのフォロー数、リールの視聴時間、最適な曜日と時間帯を確認できます。さらに、どのキャプション（言語、質問形式のフック、CTA、長さ）が実際に効果的かもわかります。
• 合法的に競合を調査できます。 プロアカウントを追跡してフォロワー数の推移を記録し、平均より N× 高い成果を上げた投稿の通知を受け取れます。URL を使って、スライドを含む公開投稿を分析できます。
• コンテンツを作成できます。 自動チェック（最初の 1 秒のルール、安全領域、「カルーセルのコピーではないこと」）を備えた Remotion リールテンプレート、オリジナル音楽、ライセンス済みの 3D オブジェクトを利用できます。
• 安全に公開できます。 プレビュー付きの 2 段階公開、フィンガープリント付きキュー（ファイルが変更されると投稿をブロック）、投稿から 24 時間後／72 時間後のレビュー、コメントへの返信に対応します。公開操作にはすべて、明示的な承認が必要です。
• 公式 API のみを使用します。 スクレイピングもブラウザー自動化も行わないため、アカウントへのリスクがありません。

クイックスタート

uv、Claude Desktop、Facebook ページにリンクされた Instagram のビジネスアカウントまたはクリエイターアカウント、そしてご自身の Meta アプリが必要です（5 分でできるガイド）。

uvx --from creatorloop creatorloop-setup

Claude Desktop に接続し、ブラウザーでセットアップページを開きます。アプリの App ID と App Secret を入力して、Continue with Facebook を押せば完了です。続けて Claude に「直近 10 件の投稿の成果と、次に投稿すべき内容を教えて」と尋ねてみましょう。

すでに Claude をお使いですか？「Instagram に接続して」と頼むと、Claude が同じページ（open_setup）を開きます。App Secret とトークンを入力するのはローカルのそのページだけで、チャットに入力されることはありません。

creatorloop-setup は、Windows（Microsoft Store 版を含む）、macOS、Linux で Claude Desktop の設定を検出し、ほかのサーバー設定を保持したままバックアップを作成して、設定ファイルを生成します。Claude Desktop は実行中に設定を書き換えるため、macOS ではこのコマンドが Claude Desktop を終了して再起動します。Windows と Linux では、先に終了するよう求められます。

ワンクリックインストール（Claude Desktop）

ターミナルを開きたくない場合は、最新リリースから.mcpbファイルをダウンロードしてダブルクリックするか、Claude Desktop → Settings → Extensions にドラッグしてください。Claude Desktop がPythonと依存関係を自動でセットアップするため、初回の起動には1分ほどかかります。2つの任意項目は空欄のままにして、「Instagramに接続して」とClaudeに頼んでください。同じセットアップページが開きます。すでにトークンとアカウントIDをお持ちの場合に限り、そこに入力してください。入力した値はセットアップページの値より優先されます。Claude Desktop でuvが見つからないと表示された場合は、uvをインストールし（上記の「uvのインストール」を参照）、Claude Desktopを再起動してください。

docker build -t creatorloop https://github.com/pandich93/creatorloop.git
mkdir "$HOME/creatorloop"

docker run --rm -it -p 127.0.0.1:8765:8765 -v "$HOME/creatorloop:/data" --entrypoint creatorloop-auth creatorloop \
  login --no-browser --port 8765 --bind 0.0.0.0

{
  "mcpServers": {
    "creatorloop": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "/Users/you/creatorloop:/data", "creatorloop"]
    }
  }
}

できること

• 「過去60日間のコンテンツについてレポートを作成してください。リールとカルーセルでは、どちらの成果が良く、いつ投稿すべきですか？」
• 「@competitor1と@competitor2と比較してください。エンゲージメントが高いのはどちらで、その理由は何ですか？」
• 「この投稿 https://www.instagram.com/p/… を分析して、自分用のバージョンを書いてください。」
• 「@competitorを追跡して、毎週、どの投稿が注目を集めたか教えてください。」
• 「ハッシュタグ#ai、#productivity、#startupを確認してください。まず利用上限を確認してください。」
• 「my-first-reelフォルダーの投稿を、次に空いている枠にキュー登録してください。」→ プレビュー → 「はい」 → 時間どおりに投稿されます。
• 「まだ返信していない新しいコメントはどれですか？返信の下書きを作成してください。」→ 返信ごとに承認します。

Claude Desktopの**+**メニューには、すぐに使えるプロンプトがあります：週間Instagramレポート、競合の概要、データに基づくコンテンツ案。

ツール

ツールは全部で34個です。Instagramに変更を加えるツールには、その旨がClaudeに伝わるよう注記されています。また、各ツールの説明では、ユーザーの承認後にのみ動作するよう指示しています。publish_mediaとreply_commentはプレビューまたは正確な文面を承認した後に、queue_postはプレビューを確認した後、confirm=trueを指定した場合にのみ動作します。

公開

ファイルを content folder（<creatorloop home>/content/<name>/）内のフォルダーに入れます。

my-carousel/                   my-reel/
  slide_01.png … slide_10.png    reel.mp4        # H.264/HEVC, 23–60 fps, ≤1920 px wide, 3 s–15 min, ≤300 MB
  caption.txt                    caption.txt
                                 reel.json       # optional: {"cover_ms": 1667, "share_to_feed": true, "trial": "SS_PERFORMANCE"}

• スライド：PNG/JPGを1～10枚（APIの上限）。アスペクト比は4:5～1.91:1で、ファイル名順に並べます。caption.txt の --- 行より後はメモとして扱われ、公開されません。
• その後、「フォルダー my-carousel から投稿を準備して」と指示します → プレビュー → 「公開」。または、投稿枠に予約します。
• カルーセル：Instagramは公開URLから画像をダウンロードするため、creatorloopはその間、一時的なCloudflare Quick Tunnelを開きます。cloudflared を一度インストールしてください。Windowsでは winget install --id Cloudflare.cloudflared -e、macOSでは brew install cloudflared、Linuxではパッケージを使います。
• リールはMetaに直接アップロードします（トンネルは不要です）。アップロード前にMP4ヘッダー（長さ、サイズ、幅、moov が先頭にあるか）を確認し、問題があれば正確な ffmpeg 修正方法を提示します。
• 投稿枠のデフォルトは、タイムゾーンに合わせた火・木・日曜日の19:00です。これは一例なので、設定ファイルの QUEUE_SLOTS を変更してください。承認後にファイルまたはキャプションが変更された予約投稿はブロックされ、投稿枠から3時間を超えてコンピューターがスリープしていた場合は、未投稿としてマークされます。
• Metaの上限は、ローリング24時間あたり100件です。list_publications で残りの件数を確認できます。公開が自動的に再試行されることはないため、重複投稿は発生しません。

コンテンツ自体の作成については、examples/とコンテンツパイプラインをご覧ください。サンプルのカルーセル、サンプルのリール絵コンテ、Remotionのリールテンプレートが含まれています。

Instagram APIでできること・できないこと

自分の投稿のエンゲージメント率 ＝ Σ（いいね＋コメント＋保存＋シェア）／Σリーチ × 100（加重方式のため、規模の小さな投稿に数値が左右されません）。投稿から72時間未満のものは、「成長中」として別に報告されます。競合のERはフォロワー数を基準に算出されます。APIでは競合のリーチを取得できません。

設定

creatorloop-setup は、creatorloop のホームフォルダーに .env を作成します。

別のフォルダーを使用するには、CREATORLOOP_HOME を設定します。ホームフォルダーには .env、creatorloop.db データベース、content/ フォルダーが保存されます。

トークンの有効期限は get_api_status に表示されます。また、すべてのツールの回答には、有効期限の 14 日前から token_warning が含まれます。

FAQ

データとプライバシー

• トークン、設定、データベース、コンテンツは、creatorloop のホームフォルダー内にあるお使いのコンピューターに保存されます。
• creatorloop が Meta と通信するのは、Instagram Graph API（graph.facebook.com、動画アップロード用の rupload.facebook.com）と、分析を依頼された投稿のスライドをダウンロードする際の Instagram のメディアサーバーのみです。
• カルーセルを公開する場合（また、直接アップロードが拒否された場合は Reels も）、Meta がファイルを取得するのに必要な数分間だけ、一時的な Cloudflare Quick Tunnel を開いてローカルファイルを公開します。その後、トンネルを閉じ、一時コピーを削除します。
• アナリティクス、テレメトリー、サードパーティサービスは使用しません。

開発

git clone https://github.com/pandich93/creatorloop && cd creatorloop
uv sync
uv run pytest            # offline: mocked Graph API and captured response shapes
uv run creatorloop-setup # points Claude Desktop at this checkout instead of the PyPI package

CONTRIBUTING.md を参照してください。セキュリティ上の問題については、SECURITY.md をご覧ください。

免責事項

creatorloop は独立したオープンソースプロジェクトです。Meta または Instagram との提携、推奨、スポンサー関係はありません。「Instagram」は Meta Platforms, Inc. の商標です。本プロジェクトの利用にあたっては、Meta Platform Terms および Instagram のポリシーを遵守する責任があります。

ライセンス

MIT。examples/reel-template のリールテンプレートでは、独自のライセンスが適用される Remotion を使用しています。バンドルされているアセットとフォントは examples/reel-template/public/assets/LICENSES.md に記載されています。