InstaVision

instavision-mcp

InstaVision — 为 AI Agent 发现 Instagram 细分领域。

InstaVision 会根据你用通俗语言描述的条件，找到 Instagram 创作者和潜在客户。向你的 Agent 提出请求（“在尼日利亚找 10 位经营付费学院、公开列出邮箱的外汇导师”），它会估算费用、启动搜索， 并返回经过验证的匹配结果：每个账号都证实符合所有条件，并附上 能证明这一点的个人资料引文。搜索会显示在你的 InstaVision 控制面板中，并使用你账户的积分；积分只会用于已验证的匹配结果： 可能匹配的结果、被拒绝的个人资料以及没有找到结果的搜索均免费。

有两种连接方式：

• 远程： 能向 HTTP MCP 服务发送标头的客户端（Claude Code、Cursor、Codex）可直接连接到 https://instavision.co/api/mcp/mcp。 无需安装。
• 此软件包： npx instavision-mcp 是一个轻量级本地桥接程序，供 使用本地（stdio）服务的客户端（例如 Claude Desktop）使用。它会将 MCP 流量（包括服务的说明）转发到同一个托管服务。 桥接程序本身不会在磁盘上保存任何内容；你的密钥保存在客户端的 配置中。

设置指南和限制：instavision.co/mcp

1. 获取 API 密钥

登录 InstaVision （你会进入 Settings → API keys），然后创建密钥（密钥只会显示一次，请复制保存）。 密钥以 iv_sk_ 开头。不要在命令行中输入真实密钥：它会 保留在 shell 历史记录中。

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。密钥不会显示，也不会保存到 shell 历史记录中；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"]。

然后让你的 Agent“估算一次包含 10 个匹配结果的 InstaVision 搜索”，以确认 连接成功。

无需密钥

即使没有 INSTAVISION_API_KEY，桥接程序也会启动：它会在没有密钥的情况下连接， 并在 stderr 中显示提示。随后，你的客户端可以列出工具并估算 搜索费用；需要账户的调用（启动搜索、读取结果、查看你已看过的账号列表、导出 PDF）会失败， 并提示前往 API 密钥页面。

你的 Agent 可以做什么

估算搜索费用 · 根据纯文本描述启动搜索（消耗积分）· 检查搜索状态 · 获取经过验证的匹配结果及其证据 · 导出 PDF · 管理你已看过的账号。

环境变量（本软件包）

变量	必需	描述
INSTAVISION_API_KEY	否	在 Settings → API keys 获取你的密钥。没有密钥时，桥接程序会在不使用密钥的情况下连接（见上文）。
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 keys 页面撤销密钥。

InstaVision 是一款独立产品，与 Instagram 或 Meta 无关联，也未获其认可。

许可证

MIT