Social Intel MCP

面向 AI 代理的 Instagram 网红发现工具。通过 x402 以 USDC 按调用付费 — 无需 API 密钥、无需订阅、无需注册。

socialintel.dev 是一个数据层，旨在为 AI 代理运行网红外联、品牌研究和创作者情报工作流。本仓库提供了一个 MCP 服务器，通过模型上下文协议 (Model Context Protocol) 公开相同数据，因此任何兼容 MCP 的客户端（Claude、Cursor、VS Code、Cline 等）都可以原生调用它。

📋 目录

• 🚀 快速入门 — 托管端点

• 🔌 MCP 客户端

• 🛠️ 工具

• 💰 支付流程 (x402)

• 🎯 使用场景

• 🎛️ 配置

• 🧪 免费演示模式

• 🌐 多种传输方式

• 🔒 隐私与遥测

• 🗺️ 相关资源

• 📄 许可证

Related MCP server: aipaygen-mcp

🚀 快速入门 — 托管端点

推荐。 将任何支持 HTTP/SSE 或流式传输的 MCP 客户端直接指向我们的托管服务器：

https://socialintel.dev/mcp

无需安装，无需 pip，无需 Docker。您的代理的 x402 客户端会在每次 tools/call 时处理支付。

如果您的客户端需要 stdio 包装器（旧版本的 Claude Desktop，某些 CLI 客户端），请参阅 MCP 客户端 部分，了解将 stdio 代理到 HTTPS 的 uvx / pip install 设置。

🔌 MCP 客户端

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "socialintel": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/socialintel/socialintel-mcp",
        "socialintel-mcp"
      ],
      "env": {
        "SOCIAL_INTEL_API_URL": "https://socialintel.dev"
      }
    }
  }
}

重启 Claude Desktop。search_leads 将出现在工具列表中。

Cursor

偏好设置 (Preferences) → MCP → 添加服务器：

{
  "socialintel": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
  }
}

VS Code (配合 GitHub Copilot 或 Continue)

在工作区中的 .vscode/mcp.json：

{
  "servers": {
    "socialintel": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
    }
  }
}

Cline (VS Code 扩展)

Cline 会自动从 cline_mcp_settings.json 检测 MCP 服务器。添加与上述 Claude Desktop 相同的服务器块。

Cherry Studio / Zed / 任何兼容 MCP 的客户端

使用 stdio 命令：

uvx --from git+https://github.com/socialintel/socialintel-mcp socialintel-mcp

或者，如果客户端支持远程 MCP，将其指向托管的 HTTP 端点：https://socialintel.dev/mcp

直接 pip 安装

pip install git+https://github.com/socialintel/socialintel-mcp
SOCIAL_INTEL_API_URL=https://socialintel.dev socialintel-mcp

🛠️ 工具

search_leads

按人口统计、位置、关键词或商业类别搜索 Instagram 网红。

每个结果包含：

{
  "username": "yoga_with_adriene",
  "full_name": "Adriene Mishler",
  "followers": 10500000,
  "category": "Fitness",
  "bio": "Yoga teacher & filmmaker from Austin TX",
  "public_email": "contact@adriene.com",
  "is_verified": true,
  "is_business": true,
  "gender": "woman"
}

public_email 在可用时填充 — 商业认证账号填充率较高，个人创作者账号较低（这是 Instagram 平台的现状，而非我们应用的筛选器）。

💰 支付流程 (x402)

代理支付遵循 x402 协议：402 Payment Required 响应携带已签名的支付要求；客户端签署 USDC 转账并重试；服务器验证并结算通过中介，然后返回结果。

1. 代理调用 search_leads(category="Fitness", country="US")。

2. 服务器回复 HTTP 402，包含 extensions.bazaar 元数据，并接受 Base (USDC) 和 Solana (USDC) 的区块。

3. 如果客户端运行 x402 客户端库（x402-httpx, agentcash, TypeScript x402 包等），它会在任一链上签署转账并重试。

4. 我们的服务器通过 CDP 中介（主要 — 同时在 agentic.market 上编目我们）或 PayAI 中介（备用）进行验证和结算。结果在重试调用时返回。

定价 — 每调用透明计费，无最低消费：

公式：$0.50 + max(0, limit − 20) × $0.01。

使用 demo=true 的免费演示完全跳过支付；请参阅 免费演示模式。

🎯 使用场景

品牌外联的微型网红发现

search_leads(
    category="Beauty",
    country="US",
    min_followers=15000,
    max_followers=200000,
    limit=50,
)

返回 50 位美国美妆微型网红，并在可用时提供公开商务邮箱。

本地创作者搜寻（城市级）

search_leads(
    city="Los Angeles",
    category="Food & Beverage",
    min_followers=10000,
    limit=20,
)

拥有 1 万以上粉丝的洛杉矶美食创作者。

关键词 + 人口统计融合

search_leads(
    query="personal trainer",
    gender="female",
    country="United Kingdom",
    min_followers=50000,
    max_followers=500000,
)

英国的女性私人教练，中到大型粉丝层级。

付费前的免费探索

search_leads(category="Travel", country="Germany", demo=True)

返回 3 个预览结果，无需支付 — 非常适合在消费前验证筛选器。

🎛️ 配置

🧪 免费演示模式

在任何 search_leads 调用中传递 demo=true。您最多可获得 3 个预览结果，无需支付。响应包含一个指向付费 URL 的 upgrade_message，以便您的代理在验证筛选器后切换到付费模式。

演示模式限制为每个 IP 每小时 5 次请求。它从我们的缓存中读取，而不是实时数据源，因此内容反映的是最近的查询，而不是实时的平台状态。

🌐 多种传输方式

• stdio (默认) — uvx --from git+... socialintel-mcp

• HTTPS / 流式传输 — 直接连接到 https://socialintel.dev/mcp

• SSE — 托管端点也为偏好此方式的客户端提供服务器发送事件 (Server-Sent Events)

托管端点是最简单的路径 — 无需安装，工具定义完全相同。

🔒 隐私与遥测

当设置了 POSTHOG_API_KEY 时，此服务器会在每次工具调用时发出一个匿名事件：

• mcp_search_leads — 仅包含筛选器形状（查询、国家、类别、性别、粉丝范围、限制、演示标志）和结果行数。不包含个人资料用户名、电子邮件或付款人地址。

事件默认关闭（没有密钥意味着不捕获）。如果您启用遥测，可以将其指向您自己的 PostHog 项目 — 将 POSTHOG_API_KEY 设置为您自己的密钥，事件将发送到您的实例，而不是我们的。

支付级遥测（x402 结算、交易哈希、收入）由 socialintel.dev 在服务器端捕获，而非此 MCP 包装器。

🗺️ 相关资源

• 网站: socialintel.dev

• API 文档: socialintel.dev/docs

• OpenAPI 规范: socialintel.dev/openapi.json

• x402 协议: x402.org

• agentcash (x402 CLI/SDK): github.com/merit-systems/agentcash

• Base 网络 (USDC): basescan.org

• CDP Bazaar 发现: agentic.market

• 模型上下文协议: modelcontextprotocol.io

📄 许可证

MIT — 见 LICENSE。

🐛 问题

错误报告、功能请求、代理集成问题： github.com/socialintel/socialintel-mcp/issues