scrapesocial-instagram

Scrapesocial Instagram

読み取り専用のInstagram調査や情報取得には、このスキルを使用します。ジョブからコマンドを選ぶ形で進め、適切なエントリーポイントをすばやく選び、まずは軽量なレスポンスを優先し、前のコマンドで返されたIDやカーソルを再利用します。

前提条件

• このスキルにはScrape Creators APIキーが必要です。scrapecreators.comで取得してください。

クイックセットアップ

CLIを一度だけインストールします。

npm install -g scrapesocial

SCRAPECREATORS_API_KEYで認証してから、scrapesocialを使ってコマンドを実行します。

SCRAPECREATORS_API_KEY=... scrapesocial instagram ...

便利なグローバルフラグ：

• サポートされている場合、レスポンスを小さくするには--trimを使用します。
• リストをダウンストリームツールにストリーミングする場合は、--format jsonlを使用します。
• CLIにコストの高いリクエストを非表示またはブロックさせる場合は、--credit-limit <n>を使用します。

クイックスタート

• アカウント全体についてのタスクでは、instagram profiles getから開始します。
• クリエイターの通常のフィードについてのタスクでは、instagram postsを使用します。
• 特定の投稿またはリールについてのタスクでは、instagram posts getを使用します。
• リールまたは動画投稿の音声コンテンツについてのタスクでは、instagram transcriptを使用します。
• トピックに関連するリールを探すタスクでは、instagram reels searchを使用します。
• 1件の投稿に対するオーディエンスの反応についてのタスクでは、instagram commentsを使用します。
• クリエイターのリール一覧についてのタスクでは、instagram reelsを使用します。
• ストーリーハイライトについてのタスクでは、instagram highlightsを使用してから、instagram highlights detailを使用します。
• プロフィールに埋め込み可能なマークアップについてのタスクでは、instagram embedを使用します。

目標別ワークフロー

目標	このスキルを使用する場面	開始方法
リード獲得	既知のクリエイターやブランドのアカウントを評価する場合や、リールの検索結果から候補を絞り込む場合に使用します。連絡先情報の取得には別の情報源と組み合わせてください。	instagram reels search から始め、評価のために instagram profiles get、instagram posts、または instagram reels に切り替えます。
インフルエンサーの発見	ニッチなリール、繰り返し登場するテーマ、アカウントの質を通じて、クリエイターを発見または審査する場合に使用します。	instagram reels search から始め、候補に絞ったハンドルを instagram profiles get、instagram reels、instagram highlights で確認します。
ブランドのモニタリング	フィード投稿、リール、ハイライトを通じて、既知のブランドやクリエイターのアカウントをモニタリングする場合に使用します。	instagram profiles get から始め、その後 instagram posts、instagram reels、instagram highlights に分岐します。
競合分析	複数のブランドやクリエイターが、フィード、リール、ハイライトをどのように構成し、オーディエンスの反応を得ているかを比較する場合に使用します。	各アカウントで instagram profiles get を実行し、代表的なアイテムの instagram posts、instagram reels、instagram comments を比較します。
コンテンツ分析	アイテムの詳細、コメント、文字起こしを使って、特定の投稿やリールが成果を上げている理由を説明する場合に使用します。	instagram posts または instagram reels から始め、目立つアイテムを instagram posts get、instagram comments、instagram transcript で詳しく調べます。
トレンド調査	リールを起点にトピックを調査し、新たに生まれつつあるクリエイティブのパターンを検証する場合に使用します。	instagram reels search から始め、instagram posts get で最適な事例を確認します。
オーディエンス分析	オーディエンスが使う言葉、よくある質問、懸念を定性的に分析する場合に使用します。オーディエンスの属性別内訳は提供しません。	代表的な投稿やリールの instagram comments から始め、文脈を把握するために instagram profiles get と instagram highlights を使用します。

コマンド選択の全表が必要な場合は、references/instagram-command-map.md をお読みください。

開始時の入力を選ぶ

• ユーザーがアカウントを調査しており、より詳細な識別子がまだない場合は、--handle を優先します。
• ユーザーが特定の投稿やリールを指定している場合は、--url を優先します。1つのアイテムを調べたり、そのコメントや文字起こしを取得したりする最も確実な方法です。
• --user-id は、別のコマンドがすでに返している場合にのみ優先します。リールやハイライトでは、ハンドルから再度解決するよりも速い場合があります。
• クエリを再開するよりも、返されたページネーショントークンを優先します。Instagram のコマンドでは、next_max_id、max_id、cursor など、コマンド固有のカーソルフィールドが使用されます。
• ハイライトを一覧表示した後、特定のハイライトを詳しく調べる場合は、返されたハイライト ID を優先します。

作業パターン

1. 作業に合った、最も上位のコマンドから始めます。
2. すばやい確認、要約、または後続処理の簡略化が目的の場合、対応しているコマンドでは --trim を使用します。
3. 同じ探索手順を繰り返さないよう、レスポンスに含まれる ID とカーソルを保持します。
4. 簡略化されたレスポンスに必要なフィールドが含まれていない場合にのみ、--trim を付けずに再実行します。
5. コマンドが対応しており、ワークフローで繰り返しページングする場合は、最初の検索以降、ハンドルベースから ID ベースのコマンドに切り替えます。

よくあるフロー

クリエイターアカウントを監査する

まず instagram profiles get を使ってアカウントを把握し、その後、目的に応じて分岐します。

• フィードの履歴には instagram posts を使います。
• 短尺動画の出力には instagram reels を使います。
• アーカイブされたストーリーズには instagram highlights を使います。
• 分析ではなく埋め込み可能なマークアップが必要な場合は instagram embed を使います。

1 件の投稿またはリールを分析する

ユーザーが Instagram の URL を 1 つ指定し、メタデータやコンテンツの詳細を求めている場合は instagram posts get を使います。必要な場合にのみ、さらに分岐します。

• オーディエンスの反応を確認するには instagram comments を使います。
• 動画コンテンツから話し言葉を書き起こすには instagram transcript を使います。

Instagram Reels でトピックを調査する

トピックの探索、トレンドの調査、または候補の収集には instagram reels search を使います。気になるリールが見つかったら、そのリールの URL を使って instagram posts get または instagram comments に進みます。

コマンドに関する注意事項

• instagram profiles basic は、ユーザー ID をすでに取得しており、より簡易的な基本プロフィール表示だけが必要な場合に使う、限定的な追加コマンドです。
• instagram highlights detail は探索用のコマンドではありません。instagram highlights が目的のハイライト ID を返した後にのみ使います。
• instagram comments、instagram posts、instagram reels はページングに適しています。繰り返し収集する際は、返されたカーソル値を保持してください。
• instagram transcript が役立つのは、実際に音声が含まれているメディアに限られます。
• この CLI は Instagram での取得と分析用であり、投稿、メッセージ送信、「いいね」などの書き込み操作には対応していません。

リファレンス

一般的な入力、結果、後続の操作をコマンドごとにまとめた一覧は、references/instagram-command-map.md を参照してください。