InstaVision MCP Server已验证已精选

什么是 InstaVision MCP Server？

InstaVision MCP Server 让 AI 智能体按细分领域、城市、粉丝数区间或相似账号查找 Instagram 创作者和潜在客户。智能体会选择一个 playbook，估算所需额度（credits），在你的 InstaVision 账户上启动任务，并读取或导出结果。

InstaVision 是一项托管的发现服务。任务会显示在你的 InstaVision 控制台中，并消耗账户额度。远程端点为 https://instavision.co/api/mcp/mcp。开源的 instavision-mcp npm 包（MIT）是一个轻量的本地桥接，供只能运行 stdio 服务器的客户端使用。它把 MCP 流量转发到同一个托管服务器，不在磁盘上保存任何内容。InstaVision 是独立产品，与 Instagram 或 Meta 无关联，也未获其认可。

如何使用 InstaVision MCP Server？

大多数客户端需要 API Key。登录 InstaVision，打开 Settings → API keys 并创建 Key。Key 只显示一次，以 iv_sk_ 开头。不要在命令行中直接输入真实的 Key，因为它会留在 shell 历史中。claude.ai 可以通过 OAuth 连接，无需 Key。

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 中并按回车，然后粘贴你的 Key 再按回车。Key 不会显示，也不会保存到 shell 历史。Claude Code 会把它存入 ~/.claude.json，并让该服务器在所有项目中可用。

claude.ai

打开 Settings → Connectors，选择 Add custom connector。名称填 InstaVision，粘贴 https://instavision.co/api/connect/mcp。登录在浏览器中完成：在 Claude 提示时登录 InstaVision 并批准访问。

Claude Desktop

Claude Desktop 使用 npx 桥接，需要 Node.js。进入 Settings → Developer → Edit Config，加入以下配置并填入你的 Key，然后重启 Claude Desktop：

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

在 Windows 上，如果 npx 无法启动，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "instavision-mcp"]。

Cursor

在 ~/.cursor/mcp.json 中配置，并在 Cursor 启动的环境里设置 INSTAVISION_API_KEY：

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

VS Code

在 .vscode/mcp.json 中。VS Code 只会询问一次 Key 并保存：

{
  "inputs": [
    { "type": "promptString", "id": "instavision-api-key", "description": "InstaVision API key", "password": true }
  ],
  "servers": {
    "instavision": {
      "type": "http",
      "url": "https://instavision.co/api/mcp/mcp",
      "headers": { "Authorization": "Bearer ${input:instavision-api-key}" }
    }
  }
}

Codex

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

让智能体“list InstaVision playbooks”，即可确认已连接。

InstaVision MCP Server 的主要功能

• 自然语言需求。智能体把请求转成一个 playbook 和一个消费上限。
• 免费估算成本。estimate_credits 返回最低和最高额度，不会启动任何任务。
• 消费限制。每次启动都带有你同意的上限，最多 500 额度。账户已有 5 个搜索在运行时，智能体不能再启动新任务；任意 24 小时内智能体启动的任务最多消耗 2,000 额度。
• 不重复。已交付给你的账号会在后续任务中跳过，除非设置 excludeSeen=false。
• 结果包含账号、名称、粉丝数、邮箱、AI 分类和资格标记。
• 支持导出 PDF，通过一小时后过期的签名链接下载。
• 个人资料文本作为数据返回，绝不作为指令。

InstaVision MCP Server 工具

共十一个工具，按用途分组：

• 规划：list_playbooks 和 estimate_credits 都无需 API Key。
• 运行：launch_discovery 会消耗额度并返回 runId。轮询 get_run_status，再分页读取 get_run_results。export_run_pdf 把结果渲染为 PDF。
• 账户与套餐：get_balance 显示额度和套餐。change_plan 把你升级到更大的月度套餐，只有在你确认后、已开启智能体付款且在月度限额内时，才会从已保存的银行卡扣款。
• 去重池：get_seen_accounts、add_seen_accounts（导入黑名单）和具有破坏性的 reset_seen_accounts。

InstaVision MCP Server 的使用场景

• 网红候选名单：“找出奥斯汀粉丝数在 5k 到 50k、有公开邮箱的健身教练。”
• 细分领域线索名单：“找出尼日利亚的外汇导师账号，粉丝 2k 到 50k，上限 100 额度。”
• 本地商家拓客：“找出 5 家没有网站、但列出公开邮箱的美国屋顶承包商。”
• 从几个示例账号出发，扩展到相似账号。
• 客户交付物：“把上一次任务导出为 PDF。”

InstaVision MCP Server 常见问题排查

• 调用失败并提示前往 API keys 页面：桥接或客户端在没有 Key 的情况下连接。列出 playbook 和估算额度可以使用，但启动任务、读取结果、已见账号列表和 PDF 导出都需要 Key。
• Cursor 或 Codex 无法认证：它们从自己启动时的环境中读取 INSTAVISION_API_KEY。在那里设置后重启。
• Windows 上 npx 无法启动：使用上文的 cmd /c npx 写法。
• 桥接拒绝自定义 URL：除非设置 INSTAVISION_ALLOW_CUSTOM_URL=1，否则 INSTAVISION_MCP_URL 必须位于 https://instavision.co/ 下。