instagram-research

Instagram の調査

Crawlora API から、公開 Instagram プロフィール、投稿、リールを正規化された JSON 形式で取得します。アプリのスクレイピングや非公式のクライアントライブラリは使用しません。

このスキルを使用する場面

• 「 の Instagram プロフィール／フォロワー数は？」
• 「この Instagram 投稿の詳細を取得して。」
• 「 の最近のリールを取得して。」
• Instagram に絞った競合他社のソーシャル監査、インフルエンサーの審査、ブランドへの言及のモニタリング。

セットアップ（一度のみ）

• 無料の Crawlora API キーを https://crawlora.net で取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. プロフィール — /instagram/profile/{username} は、指定した Instagram ユーザー名の公開プロフィールの詳細を返します。
2. リール — /instagram/reels/{id} は、Instagram ユーザー ID のリールフィードを返します。オプションの max_id カーソルでページネーションできます。
3. 投稿の詳細 — /instagram/post/{id}/{post_id} は、Instagram ユーザー ID と投稿 ID を指定して、特定の投稿のメディア詳細を返します。

エンドポイント、メソッド、パラメーターの一覧については、reference/endpoints.md を参照してください。

API の呼び出し

# Profile:
scripts/crawlora.sh /instagram/profile/nasa | jq '.'

# Reels feed (paginate with max_id from the previous response):
scripts/crawlora.sh /instagram/reels/528817151 | jq '.'
scripts/crawlora.sh /instagram/reels/528817151 max_id=<cursor> | jq '.'

# Post detail (requires both the user ID and the post ID):
scripts/crawlora.sh /instagram/post/528817151/3123456789012345678 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルが使用する Instagram エンドポイントの一覧については、reference/endpoints.md を参照してください。

使用例

• インフルエンサーの審査： プロフィールとリールフィードを確認し、パートナーシップの前にフォロワー数、投稿頻度、コンテンツ構成を把握します。
• 競合他社のソーシャル監査： 競合他社のプロフィール統計と最近のリールを取得し、フォロワーの増加やコンテンツ戦略の推移を把握します。
• 投稿単位のエンゲージメント確認： 既知の投稿 URL からユーザー ID と投稿 ID を抽出し、/instagram/post/{id}/{post_id} を呼び出して、その投稿のメディア詳細を取得します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開プロフィールと投稿が対象です。ログインや非公開コンテンツには対応していません。Instagram の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコード、クエリパラメーターへの指定、コミットはしないでください。
• リールと投稿の検索にはユーザー名ではなく数値のユーザー ID が必要です — /instagram/reels/{id} と /instagram/post/{id}/{post_id} は、どちらも @username ではなく Instagram 内部の数値ユーザー ID をキーとして使用します。ハンドル名しか分からない場合は、まず /instagram/profile/{username} のレスポンスから ID を取得してください。
• 公開範囲は限定されています — このスキルで対応しているのは、プロフィールの検索、リールフィード、単一投稿の詳細のみです。Instagram のキーワード検索、ハッシュタグ検索、トレンドエンドポイントには対応していません。
• リールのページネーションは max_id によるカーソル方式です。最初のページ以降を取得するには、レスポンスで返されたカーソルを使用してください。