mcpField
I
instagram

instagram

github.com/brightdataデータ・データベース272131 回インストール2 週間前に更新
リポジトリ

instagram について

instagram スキルは、Bright Data の Instagram データセットを使ってプロフィール、投稿、リール、コメントを収集する手順をエージェント向けに示します。URL やユーザー名に応じて CLI、SDK、MCP の経路を選び、入力や課金、結果処理の注意点も説明します。

主な機能

  1. 014 種類の Instagram データセット
  2. 02CLI、SDK、MCP の利用経路
  3. 03プロフィールとコンテンツの検索
  4. 04入力と課金に関する注意点
  5. 05非同期ジョブの結果処理

活用シーン

  1. 01URL またはユーザー名からプロフィールを収集
  2. 02アカウントの最近の投稿やリールを取得
  3. 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_l1vikfch901nx3by4collect_by_url, discover_by_user_name
投稿gd_lk5ns7kz21pck8jpiscollect_by_url, discover_by_url(プロフィール URL の場合:そのアカウントの最近の投稿)
リールgd_lyclm20il4r5helnjcollect_by_url, discover_by_url, discover_by_url_all_reels
コメントgd_ltppn085pokosxh13collect_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。

ドキュメント

コメント