instagram について
instagram スキルは、Bright Data の Instagram データセットを使ってプロフィール、投稿、リール、コメントを収集する手順をエージェント向けに示します。URL やユーザー名に応じて CLI、SDK、MCP の経路を選び、入力や課金、結果処理の注意点も説明します。
主な機能
- 014 種類の Instagram データセット
- 02CLI、SDK、MCP の利用経路
- 03プロフィールとコンテンツの検索
- 04入力と課金に関する注意点
- 05非同期ジョブの結果処理
活用シーン
- 01URL またはユーザー名からプロフィールを収集
- 02アカウントの最近の投稿やリールを取得
- 03投稿やリールとコメントを収集
MCP 対応
Bright Data の MCP サーバーは、スクレイパーツールを通じて同じ Instagram データセットを提供します。データセット ID、メソッド、入力を指定して `run_scraper` を使い、`search_scrapers` と `get_scraper_details` で ID やフィールドを確認できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ brightdata/ skills --skill instagramインストール後、Claude Code で/instagramを入力して読み込まれたか確認します。
同梱ファイルreferences/sdk.md
詳細
Bright Data - Instagram
4 種類のデータセットがあります:プロフィール、投稿、リール、コメント。利用する方法は 3 通りです。ユーザーが持っているものと取得したいものに応じて選んでください。SDK のコマンドは、2026-09-11 に brightdata-sdk 2.5.2 で検証済みです。CLI と MCP のコマンドは、@brightdata/cli 0.4.1 および @brightdata/mcp 4.1.0 に準拠しています。
| データセット | dataset_id | 方法 |
|---|---|---|
| プロフィール | gd_l1vikfch901nx3by4 | collect_by_url, discover_by_user_name |
| 投稿 | gd_lk5ns7kz21pck8jpis | collect_by_url, discover_by_url(プロフィール URL の場合:そのアカウントの最近の投稿) |
| リール | gd_lyclm20il4r5helnj | collect_by_url, discover_by_url, discover_by_url_all_reels |
| コメント | gd_ltppn085pokosxh13 | collect_by_url |
方法を選ぶ
| 持っているもの | 取得したいもの | 方法 |
|---|---|---|
| プロフィール URL | アカウントの最近の投稿 | CLI bdata pipelines run gd_lk5ns7kz21pck8jpis discover_by_url <url> --num_of_posts N または SDK client.search.instagram.posts(url, num_of_posts=N)。プロフィール URL に対して collect_by_url を使うと、It is not a post URL が返されます |
| プロフィール URL | アカウントの最近のリール | CLI bdata pipelines run gd_lyclm20il4r5helnj discover_by_url <url> --num_of_posts N または SDK client.search.instagram.reels(url, num_of_posts=N, timeout=420) |
| プロフィール URL | プロフィール | CLI bdata pipelines run gd_l1vikfch901nx3by4 collect_by_url <url> または SDK client.scrape.instagram.profiles(url) |
| ユーザー名、URL なし | プロフィール | CLI bdata pipelines run gd_l1vikfch901nx3by4 discover_by_user_name --user_name nasa または SDK client.search.instagram.profiles("nasa") |
| 投稿 URL | その投稿 | CLI bdata pipelines run gd_lk5ns7kz21pck8jpis collect_by_url <url> または SDK client.scrape.instagram.posts(url) |
| リール URL | そのリール | CLI bdata pipelines run gd_lyclm20il4r5helnj collect_by_url <url> または SDK client.scrape.instagram.reels(url) |
| 投稿またはリールの URL | そのコメント | CLI bdata pipelines run gd_ltppn085pokosxh13 collect_by_url <url> または SDK client.scrape.instagram.comments(url)。コメント 1 件につき 1 クレジット |
| ターミナルなし(ホスト型アシスタント) | 上記のいずれか | MCP の run_scraper に、上記のデータセット ID と方法を指定します(以下の MCP を参照) |
すべての方法で、API 上の非同期ジョブを実行します:開始、ポーリング、結果の返却。1 回の呼び出しに 1〜3 分かかる見込みです。レコード 1 件につき 1 クレジットで、毎月 5,000 クレジットが無料です。検出を行う呼び出しでは、必ず num_of_posts を指定してください。指定しない場合、収集および課金される投稿数に上限はありません。
セットアップの確認(最初に実行)
node <agent-onboarding skill folder>/scripts/check-auth.mjs --for instagram を実行してください。
終了コード 0 は準備完了を意味します。それ以外の終了コード、CLI がない場合、またはログインしていない場合は、agent-onboarding スキルで対応します。これらのデータセットではゾーンは不要で、キーだけが必要です。
SDK を使う場合:pip install brightdata-sdk。SDK は、まず BRIGHTDATA_API_TOKEN または BRIGHTDATA_API_KEY からトークンを読み込み、次に SDK 自体のインストールフォルダーから上位へ検索して見つかった .env ファイルから読み込み、最後に CLI に保存されたログイン情報を使用します。bdata login の後は、ほかに何も必要ありません。
CLI:ID を指定してデータセットを実行
bdata pipelines run gd_l1vikfch901nx3by4 collect_by_url "https://www.instagram.com/nasa/" --pretty
bdata pipelines run gd_lk5ns7kz21pck8jpis collect_by_url "https://www.instagram.com/p/Dc1W1uFj-CW/" --format csv -o posts.csv
bdata pipelines run gd_lyclm20il4r5helnj collect_by_url "https://www.instagram.com/reel/DcMXl1IPNtB/" --pretty
bdata pipelines run gd_ltppn085pokosxh13 collect_by_url "https://www.instagram.com/p/Dc1W1uFj-CW/" --pretty
bdata pipelines run gd_lk5ns7kz21pck8jpis discover_by_url "https://www.instagram.com/nasa/" --num_of_posts 5 --pretty
bdata pipelines info <dataset_id> <method> を実行すると、メソッドの入力フィールドが一覧表示されます。各フィールドは --<field> <value> フラグで指定します。--format json|csv|ndjson|jsonl、-o FILE、--timeout SECONDS(デフォルトは 600)。一般的な所要時間:プロフィール 50 秒、投稿 40 秒、リール 25 秒、コメント 10 秒。
SDK:アカウントの最近の投稿
from brightdata import SyncBrightDataClient
with SyncBrightDataClient(auto_create_zones=False) as client:
result = client.search.instagram.posts("https://www.instagram.com/nasa/", num_of_posts=5)
for post in result.data:
print(post["likes"], post["num_comments"], post["url"])
SDK の docstring に記載されていないルール:
- 必ず
auto_create_zones=Falseを渡してください。 有効のままにすると、クライアントは処理開始時に Web Unlocker と SERP のゾーンを作成しようとしますが、Instagram では使用されず、支払い方法が登録されていないアカウントでは 403 エラーになります(sdk-python#57)。 - 1 回の呼び出しに複数の URL を渡すと、1 つのジョブになります。 ループするのではなく、リストを渡してください。
- 戻り値の形式:
search.*の呼び出しは常にresult.dataにリストを返します。scrape.*の呼び出しは、URL が 1 つの場合は 1 件のレコードを dict として返し、複数の場合はリストとして返します。 - 日付の範囲:
start_date="08-01-2026", end_date="09-07-2026"の形式はMM-DD-YYYYです。post_type="Post"は投稿のみ、post_type="Reels"はリールのみを対象にします。docstring の"Reel"はエラー行を返し、リールは返しません(sdk-python#59)。 - リールの検出には
timeout=420が必要です。 デフォルトの 180 秒ではタイムアウトします。 - 対象期間に投稿がない場合も、0 件のレコードを伴う成功として処理されます:
errorにThere are no public posts in the profile for the specified periodを含む行として返されます。このメッセージで判定してください。アカウントが削除されている場合も同じerror_codeが使われます。 - アカウントが削除されている場合、行には
errorキーがあり、内容は一定ではありません。 たとえば、Sorry, this page isn't available.やCrawler error: Cannot read properties of nullなどです。同じ結果に含まれる他の行は問題ありません。 - タイムアウトの場合、
result.success == Falseかつresult.status == "timeout"になります。 - 共同投稿では、
user_postedに共同投稿者のハンドル名が含まれるため、nasaから取得した投稿にnasajohnsonと表示されることがあります。全員の一覧はcoauthor_producersにあります。 reels_all(url)は、そのアカウントがこれまでに投稿したリールごとに 1 クレジットかかります。 事前にプロフィールのposts_countを確認してください。コメントは 1 件につき 1 クレジットかかります。事前に投稿のnum_commentsを確認してください。- フィールドのリストをハードコードしないでください。 スキーマは予告なく変更されます。
client.datasets.instagram_posts.get_metadata().fieldsで読み取ってください。これはフィールド名をキーとする dict です。1 件の投稿には、44 個のフィールドのうち 34〜36 個が含まれます。 - 大規模な実行の場合:
posts_trigger、posts_status、posts_fetchを使用します。スナップショット ID は保持してください。スナップショットは 30 日間ダウンロードできます。
残り 7 つの SDK 呼び出しについては、それぞれ完全なコード例とともに references/sdk.md に記載されています。
MCP:ターミナル不要
Bright Data MCP サーバーは、デフォルトで有効になっているスクレイパーツールを使って同じデータセットにアクセスします。先頭の表に記載されているデータセット ID とメソッドを指定して run_scraper を呼び出し、[{"url": "https://www.instagram.com/nasa/"}] などの入力を渡します。投稿データセットの discover_by_url を使うと、アカウントの最近の投稿を取得できます。入力に num_of_posts と limit_per_input を渡してください。search_scrapers と get_scraper_details を使うと、ID やフィールドを調べられます。設定方法については brightdata-mcp スキルを参照してください。
引き継ぎ
- 対応していない URL、またはこれらのデータセットの対象外となる Instagram ページ:
scrape。 - 先にプロフィールまたは投稿の URL を見つける必要がある場合:
search。 - その他のプラットフォーム:
scrape。
ドキュメント
- Instagram Scraper API:https://docs.brightdata.com/products/scrapers/instagram/introduction
- 投稿、URL による検出(最近の投稿の呼び出し):https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/instagram-posts-discover-by-url
- 無料プラン:https://docs.brightdata.com/general/account/billing-and-pricing/free-tier