InstaVision

instavision-mcp

InstaVision — AI エージェント向けの Instagram ニッチ発見ツール。

InstaVisionは、 平易な言葉で説明した Instagram のクリエイターや見込み顧客を見つけます。エージェントに 「ナイジェリアで、有料アカデミーを運営し、公開メールアドレスを掲載している外国為替メンターを10件探して」と尋ねると、費用を見積もり、検索を開始して、条件をすべて満たすことが確認されたアカウントを、条件を裏付けるプロフィールの引用とともに返します。検索は InstaVision のダッシュボードに表示され、アカウントのクレジットが使用されます。クレジットが消費されるのは確認済みの候補のみです。候補の可能性があるアカウント、不採用のプロフィール、該当アカウントが見つからなかった検索は無料です。

接続方法は2つあります。

• リモート： HTTP MCP サーバーにヘッダーを送信できるクライアント（Claude Code、Cursor、Codex）は、https://instavision.co/api/mcp/mcpに直接接続します。 インストールは不要です。
• このパッケージ： npx instavision-mcpは、Claude Desktopなど、ローカル（stdio）サーバーを実行するクライアント向けの軽量なローカルブリッジです。サーバーの指示を含むMCP トラフィックを、同じホストサーバーに転送します。ブリッジ自体はディスクに何も保存しません。キーはクライアントの設定に保存されます。

セットアップガイドと制限事項：instavision.co/mcp

1. API キーを取得する

InstaVision にサインイン すると、Settings → API keys が表示されます。キーを作成してください（キーが表示されるのは一度だけなので、コピーしてください）。 キーはiv_sk_で始まります。実際のキーをコマンドラインに入力しないでください。シェルの履歴に残ってしまいます。

2. クライアントを接続する

Claude Code

read -rs INSTAVISION_API_KEY && claude mcp add --scope user --transport http instavision https://instavision.co/api/mcp/mcp --header "Authorization: Bearer $INSTAVISION_API_KEY"

ターミナル（bash または zsh）に貼り付けて、Enter キーを押します。続いてキーの入力待ちになるので、キーを貼り付けてEnterキーを押します。キーは表示されず、シェルの履歴にも保存されません。Claude Code はキーを~/.claude.jsonに保存し、すべてのプロジェクトでサーバーを利用できるようにします。

Cursor — ~/.cursor/mcp.json

{"mcpServers":{"instavision":{"url":"https://instavision.co/api/mcp/mcp","headers":{"Authorization":"Bearer ${env:INSTAVISION_API_KEY}"}}}}

Codex

codex mcp add instavision --url https://instavision.co/api/mcp/mcp --bearer-token-env-var INSTAVISION_API_KEY

Cursor と Codex はINSTAVISION_API_KEY環境変数からキーを読み取るため、これらのクライアントの起動元となる環境で設定しておく必要があります。

Claude Desktop（このパッケージを使用）— claude_desktop_config.json

Settings → Developer → Edit Config を開き、以下のブロックのiv_sk_...を自分のキーに置き換えて追加し、Claude Desktop を再起動します。MCP サーバーをローカルで実行するクライアントであれば、同じcommand、args、envを使用できます。

{
  "mcpServers": {
    "instavision": {
      "command": "npx",
      "args": ["-y", "instavision-mcp"],
      "env": { "INSTAVISION_API_KEY": "iv_sk_..." }
    }
  }
}

Windows： npxの起動に失敗する場合は、"command": "cmd"と "args": ["/c", "npx", "-y", "instavision-mcp"]を使用してください。

次に、エージェントに「InstaVision で10件検索する場合の見積もりを出して」と尋ね、接続を確認します。

キーを使わない場合

ブリッジはINSTAVISION_API_KEYを設定せずに起動することもできます。キーなしで接続し、stderr にヒントを表示します。クライアントはツールの一覧表示や検索費用の見積もりができます。アカウントが必要な操作（検索の開始、結果の読み取り、閲覧済みアカウントの一覧表示、PDF エクスポート）は、API キーのページへの案内を表示して失敗します。

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

検索の見積もり · 平易なテキストの説明から検索を開始（クレジットを消費） · 検索のステータスを確認 · 証拠付きの確認済み候補を取得 · PDF をエクスポート · 閲覧済みアカウントを管理。

環境変数（このパッケージ）

変数	必須	説明
INSTAVISION_API_KEY	いいえ	設定 → API キーで取得したキーです。設定しない場合、ブリッジはキーなしで接続します（上記を参照）。
INSTAVISION_MCP_URL	いいえ	エンドポイントを上書きします（デフォルトは https://instavision.co/api/mcp/mcp）。INSTAVISION_ALLOW_CUSTOM_URL=1を設定しない限り、https://instavision.co/…である必要があります。
INSTAVISION_ALLOW_CUSTOM_URL	いいえ	1を設定すると、別のhttpsホスト、または開発用のhttp://localhost／http://127.0.0.1を使用できます。その場合、ブリッジはホスト名を示す警告を表示し、キーが設定されていれば、そのホストにキーを送信します。

ブリッジはキーをAuthorization: Bearerヘッダーとしてのみそのエンドポイントに送信し、送信前にエンドポイントを確認します。APIキーのページでキーを無効化できます。

InstaVisionは独立した製品であり、InstagramまたはMetaとは提携も推奨もされていません。

ライセンス

MIT