メインコンテンツへ移動
AIチュートリアル

InstagramリールをClaude Codeで毎日のコンテンツリサーチシステムに変える方法

Instagram Research Toolのインストールと設定、データプロバイダーの接続、個別リールの分析、毎日の外れ値レポートの生成、そしてClaude Codeを使ってリサーチをオリジナル台本に変換する方法を学びます。

約12分で読了
InstagramリールをClaude Codeで毎日のコンテンツリサーチシステムに変える方法

Instagramリサーチツールの機能

Instagramリサーチツールは、保存したリールやニッチな検索結果を、検索可能なリサーチライブラリに変換します。Claude Codeを使うと、リールの文字起こし、フック、形式、切り口、パフォーマンス数値、視覚的な構成、スクロールを止める可能性の高い場面を分析できます。

また、あなたのニッチで通常より高い成果を上げているリールを強調する、毎日のアウトライヤーレポートも作成します。各分析の最後には、元のクリエイターをコピーするのではなく、voice.mdファイルに記載されたスタイルで新しいフックと台本が書かれます。

リールライブラリ

生成されたライブラリはブラウザで開くため、調査したリールを比較したり、撮影前にアイデアを見直したりできます。

必要なもの

  • Claude Code
  • Node.js 18以降
  • Sandcastles、Apify、yt-dlp、独自データなどのデータソース1つ
  • 任意: フレーム単位の映像分析に使うffmpeg
  • 任意: 利用中のプロバイダーが文字起こしを提供しない場合に使うローカル転写用のWhisper
  • 任意: 共有ボタンでリールを保存するiPhone

このプロジェクトにはnpm依存関係がありません。フレーム抽出を行う場合は、brew install ffmpegでffmpegをインストールしてください。ローカル転写には、pipx install openai-whisperでWhisperをインストールします。

データソースを選ぶ

データプロバイダーは、動画ファイル、キャプション、文字起こし、パフォーマンス数値などの元データを取得します。分析はClaude Codeが行うため、分析ワークフローを変更せずにプロバイダーを切り替えられます。

  • Sandcastles: リールの分析データ、タイムスタンプ付き文字起こし、フック分析、アウトライヤー検索を提供する有料MCPプロバイダーです。MCPの利用にはProプラン以上が必要です。
  • Apify: 有料の結果単位アクターを通じて、リールデータと動画ファイルを提供します。毎日のハッシュタグ検索に対応しており、アウトライヤースコアではなく、1時間あたりの視聴数でランキングします。
  • yt-dlp: 公開されている個別のInstagram、TikTok、YouTube Shortsリンクに使える無料の選択肢です。文字起こしにローカルのWhisperを利用できますが、Instagramの視聴数は取得できない場合があります。
  • 任意のソース: 動画ファイル、別サービスからのエクスポート、または自分で入力した数値を使えます。

個別のリールにはyt-dlp、毎日の検索にはApifyやSandcastlesというように、用途ごとに異なるプロバイダーを使えます。プロバイダーごとの手順は、リポジトリのprovidersディレクトリにあります。

セットアップウィザードをインストールして実行する

  1. リポジトリをクローンして、そのディレクトリに移動します:
git clone https://github.com/manthanpatelll/instagram-research-tool.git
cd instagram-research-tool
claude
  1. Claude Code内で初回セットアップウィザードを開始します:
/research-setup

ウィザードでは、使用するプロバイダー、接続が必要なサービス、あなたのニッチについて確認します。また、毎日の検索クエリを作成し、あなたのキャプション3件から文章スタイルを学習します。任意のiPhone共有ワークフローの設定も案内し、セルフテストを実行します。

リポジトリには、主な設定がconfig.json、ニッチ検索がniche.json、文章作成の指針がvoice.mdに保存されます。結果を手動で調整したい場合は、セットアップ後にこれらのファイルを確認してください。

まずサンプルワークフローを試す

リールライブラリ

プロバイダーに接続しなくても、プロジェクトを確認できます。付属のサンプルは合成データを使用しており、実在のクリエイターを表すものではありません。

npm run library
npm run sample-report
npm run selftest
  • npm run libraryはサンプルのリールライブラリを開きます。
  • npm run sample-reportはサンプルのアウトライヤーレポートを開きます。
  • npm run selftestはオフラインチェックを実行します。成功すると終了コード0で終了します。

個別のリールを分析する

セットアップが完了したら、公開リールのリンクをリールリサーチスキルに渡します:

/reel-research <reel link>

ツールは利用可能な元データを取得して標準化し、必要に応じて動画を文字起こしし、抽出したフレームを映像分析に使用します。結果はlibrary/reels/にJSONファイルとして保存され、ブラウザのライブラリにも追加されます。

通常、次の内容が分析に含まれます:

  • 視聴数、いいね数、コメント数、エンゲージメント率、利用可能な場合はアウトライヤースコア、投稿日
  • タイムスタンプ付き文字起こし
  • 冒頭のフック、フックの種類、単語数、話す時間、強い言葉、効果がある理由の説明
  • リールのカテゴリー、視覚的なレイアウト、テンポ、形式
  • テーマ、具体的な切り口、一般的な考え、対照的な主張
  • 画面上のテキストと視聴維持の目的を含む、ショットごとの映像タイムライン
  • タイムスタンプ付きの、スクロールを止める可能性が高い場面2〜5個
  • あなたの声で書かれた新しいフックと完全な台本

受信箱に保存したリールを処理する

任意のiPhoneワークフローを使う場合は、リールで共有をタップし、Save to Researchを選択します。ショートカットがリンクをiCloud Driveの受信箱ファイルに書き込み、Macと同期できます。

保存したリンクを処理するには、次を実行します:

/reel-research inbox

ツールは新しいリンクを読み取り、選択したプロバイダーで分析して、結果をライブラリに追加します。iPhoneがない場合は、リンクをClaude Codeに直接貼り付けるか、config.jsonのinboxPathをコンピューターと同期する別のテキストファイルに変更できます。

毎日のアウトライヤーレポートを生成する

外れ値ワークフローは、設定したニッチを検索し、結果をフィルタリングして重複を統合し、条件を満たすリールをランキングします。デフォルトでは過去24時間を対象とし、再生回数が2,000回未満のリールを除外します。条件を満たすリールが15件未満の場合、検索期間は最大48時間まで拡張できます。

/outliers

レポートはreports/に保存され、HTMLページとして開きます。Claude Codeはチャット内で上位10件の結果を解説し、コンテンツのアイデアの切り口も提案します。

外れ値レポート

より広い検索期間を使用するには、次のコマンドを実行します。

外れ値レポート

/outliers --48h

デフォルトの日次検索では、niche.json内のクエリを使用します。これらのクエリは、ニッチのクリエイターが実際にリールのキャプションや説明で使う表現を反映したクラスターに整理してください。

処理パイプラインを理解する

このプロジェクトでは、ソースデータからリサーチ結果まで、明確な順序で処理が進みます。

  1. リールのリンク、動画ファイル、またはソースのエクスポートデータがワークフローに入力されます。
  2. 選択したプロバイダーが、数値、キャプション、動画、または文字起こしを提供します。
  3. 文字起こしがautoに設定されている場合、ツールはプロバイダーの文字起こしを使用し、利用できなければローカルのWhisperに切り替えます。
  4. frames.mjsがffmpegを使って、視覚的な確認用のコンタクトシートを作成します。
  5. Claude Codeがフック、形式、切り口、映像、視聴維持に影響する場面を分析します。
  6. 完成した分析結果はJSONとして保存され、out/library.htmlから表示されます。
  7. 外れ値ワークフローは検索データの生データを保存し、フィルタリングしてランキングし、HTMLレポートを作成します。

重要な設定を構成する

ワークフローを調整するには、config.jsonを開きます。

  • providerは、個別リールのソースとしてsandcastles、apify、ytdlp、またはanyを選択します。
  • searchProviderは、日次検索に使用するSandcastlesまたはApifyを選択します。
  • inboxPathは、同期された受信トレイファイルを指定します。
  • windowHoursは、通常の外れ値検索期間を設定します。
  • maxWindowHoursは、レポートが検索期間を拡張できる上限を設定します。
  • minViewsは、再生回数の少ない結果をレポートから除外します。
  • transcriptionは、ソースの文字起こしとローカルのWhisperのどちらを使用するかを制御します。
  • myHandleには、必要に応じてInstagramのハンドルを保存できます。

不足しているパフォーマンス指標は空欄のままになります。ツールは値を推測しないため、メタデータが限られたソースの結果では、再生回数やエンゲージメント数が不明と表示される場合があります。

朝のリサーチを自動化する

このリポジトリには、cronまたはmacOSのlaunchdを使って受信トレイと外れ値ワークフローを自動化するためのガイドが含まれています。関連する例では、次のようなコマンドを実行します。

claude -p "/reel-research inbox"
claude -p "/outliers"

iPhoneの共有設定と、日次自動化のオプション例については、docs/iphone-shortcut.mdを参照してください。スケジュールされたコマンドを有効にする前に、必ず内容を確認してください。特に、選択したプロバイダーが結果ごと、または分析ごとに課金する場合は注意が必要です。

コピーせずにリサーチを活用する

このツールは、コンテンツの再投稿ではなく、アイデアの研究を目的に設計されています。リールのテーマ、切り口、形式をリサーチとして活用し、そこに自分の経験、成果、商品、または視点を加えてください。

生成されるMy versionセクションは、あなたの声で新しい表現を作るためのものです。クリエイターのセリフ、ジョーク、ストーリーを再利用することはなく、保存前にコピーされたフレーズがないかプロジェクトが確認します。ダウンロードした動画は分析のためにコンピューターに保存されますが、再アップロードしないでください。

まとめ

Instagram Research Toolは、Claude Codeとデータプロバイダーを組み合わせ、リールのリサーチを再現可能な作業にします。セットアップ後は、スマートフォンからリールを保存し、個別に分析し、日次の外れ値レポートを確認し、実績のある形式や切り口からオリジナルの台本を作成できます。

まずサンプルコマンドから始め、/research-setupを実行してください。その後、niche.jsonとvoice.mdを調整して、リサーチをあなたのオーディエンスと文体に合わせます。