herascrape

herascrape-mcp

Model Context Protocol を介して AI エージェントに Instagram データを提供します。 Claude、Cursor、ChatGPT、VS Code、その他の MCP クライアントを herascrape-mcp に接続すれば、スクレイピングコードもブラウザーもログインも不要で、公開されている Instagram のプロフィール、コンテンツ、エンゲージメント、検索結果を直接読み取れます。

各エンドポイントは稼働中の API から生成された 1 つのツールであり、サーバーが提供する内容とツールリストが食い違うことはありません。読み取り専用で、カーソルページネーションに対応し、料金は一律 成功した呼び出し 1 回につき $0.0004 です（課金対象は 2xx のみ）。herascrape Instagram API を利用しています。

エージェントができること

• プロフィールとオーディエンス — ユーザー名またはユーザー ID から完全なプロフィールを取得します。ユーザーのフォロワーとフォロー中のアカウントをページ単位で取得し、「概要」やアカウントの詳細を確認できます。
• コンテンツ — ユーザーの投稿、リール、タグ付けされた投稿、公開中のストーリーズ、ハイライト、リポストを取得します。ID を指定して個々の投稿やリールも取得できます。
• エンゲージメント — 投稿へのコメントと返信を読み取り、投稿やコメントに「いいね」したユーザーを確認できます。
• 発見 — ハッシュタグの人気投稿、新着投稿、リールを取得します。場所ごとの人気メディアと新着メディア、トレンドの音声、および指定した音声トラックを使ったクリップも確認できます。
• 検索 — ユーザー、ハッシュタグ、音声、場所、および汎用の「トップ」検索を行えます。
• ユーティリティ — ショートコードまたは URL からメディア ID を取得し、投稿を oEmbed で表示し、現在の残高を確認できます。

オーディエンス調査、競合やキャンペーンの追跡、インフルエンサーの審査、トレンドやハッシュタグの分析、プロフィールや投稿の情報補完など、今 Instagram に実際に掲載されている内容が必要なタスクで、エージェントはこれらの機能を活用します。

インストール — ワンクリック

上のボタンを開くとクライアントの選択画面が表示され、エージェントを実行する環境に herascrape-mcp をインストールできます。ネイティブのワンクリックインストールに対応したクライアントは次のとおりです。

herascrape ダッシュボードから API キーを取得するか、ブラウザー内でサインインして認証してください。

インストール — 手動

リモート（推奨）— URL で接続し、ブラウザーで認証

リモート MCP に対応するホストは、ホストされているサーバーに接続し、ワンクリックで認証（OAuth）できます。キーをコピーする必要はありません。

• Claude Code： claude mcp add herascrape --transport http https://herascrape.com/mcp

• Cursor / Claude Desktop / ChatGPT：

  {
    "mcpServers": {
      "herascrape": { "url": "https://herascrape.com/mcp" }
    }
  }
  

ローカル（stdio のみのホスト）— API キーを使った npx

ローカル（stdio）サーバーのみを実行するホスト向けです（Node ≥ 18）。このブリッジは、ホスト型サーバーへのシンプルな stdio-to-HTTP プロキシです。API キーを x-api-key として転送し、実際のツール一覧と呼び出しを中継します。独自のツールは定義しません。ダッシュボードからキーを取得してください。

• Claude Code:

  claude mcp add herascrape --env HERASCRAPE_API_KEY=your_key -- npx -y herascrape-mcp
  

• Claude Desktop / Cursor（claude_desktop_config.json / .cursor/mcp.json）:

  {
    "mcpServers": {
      "herascrape": {
        "command": "npx",
        "args": ["-y", "herascrape-mcp"],
        "env": { "HERASCRAPE_API_KEY": "your_key" }
      }
    }
  }
  

設定

変数	デフォルト	用途
HERASCRAPE_API_KEY	—	x-api-key として送信します。ローカル（stdio）ブリッジで必須です。
HERASCRAPE_MCP_URL	https://herascrape.com/mcp	サーバー URL を上書きします（例：ステージング環境）。

ライセンス

MIT