# 社媒数据 MCP 服务器

SocialToAI 是一个托管的社媒数据 MCP 服务：在你的 AI 客户端里填一个地址，它就能读 18 个平台上公开可见的帖子、评论、账号和热榜。本机不用装任何东西，也不用提供平台账号或 Cookie。服务列出 16 个工具；多数调用 2 积分，失败不扣。ChatGPT 和 Claude 应用登录授权就能连；其余客户端把 API Key 放在请求头里。

- 页面：https://socialtoai.com/zh/mcp/
- 最近更新：2026-10-18

## 地址

- MCP (Streamable HTTP): `https://mcp.socialtoai.com/mcp`

- 请求头: `Authorization: Bearer <YOUR_API_KEY>`

- 传输方式：Streamable HTTP

- 认证：ChatGPT 和 Claude 应用用 OAuth 登录；其余客户端用请求头里的 API Key

- 工具：16

- 平台：18

- 广告库：2

## 选你的客户端

### Claude Code

1. 在控制台创建一把 Key，导出为环境变量 SOCIALTOAI_KEY。
2. 在终端里运行这条命令。
3. 打开 Claude Code 直接提问。随时输入 /mcp 查看连接状态。

终端：

```
export SOCIALTOAI_KEY="<YOUR_API_KEY>"

claude mcp add --transport http socialtoai \
  https://mcp.socialtoai.com/mcp \
  --header "Authorization: Bearer $SOCIALTOAI_KEY"

# check the connection
claude mcp list
```

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### Claude app

1. 在 Claude 网页版或桌面版打开 Customize → Connectors → Add custom connector。
2. 名称填 SocialToAI，粘贴地址后添加。高级设置留空。
3. 点 Connect，用邮箱验证码登录 SocialToAI，再点“允许”。
4. 在对话里打开这个连接器，直接提问。

Customize → Connectors → Add custom connector：

- 名称（Name）：`SocialToAI`
- 远程 MCP 服务器地址（URL）：`https://mcp.socialtoai.com/mcp`

- 不用复制 Key：连接会出现在控制台的 API Keys 里，名字是 Claude，可以给它设每日上限或撤销。
- Claude 免费版只能添加一个自定义连接器。

> 不用贴 Key：用邮箱验证码登录后点“允许”即可。第一次来的话，登录这一步就会建好账户。

### ChatGPT

1. 在 ChatGPT 的设置里打开开发者模式，然后为自定义 MCP 服务器新建一个应用。
2. 名称填 SocialToAI，粘贴地址，认证方式选 OAuth，创建。
3. 用邮箱验证码登录 SocialToAI，再点“允许”。
4. 在对话里选中它，直接提问。

ChatGPT 设置 → Apps → Create：

- 名称（Name）：`SocialToAI`
- MCP 服务器地址（URL）：`https://mcp.socialtoai.com/mcp`
- 认证方式（Authentication）：`OAuth`

- 需打开开发者模式。哪些套餐能开由 ChatGPT 决定，并且会调整，请以你账户的设置页为准。
- 不用复制 Key：连接会出现在控制台的 API Keys 里，名字是 ChatGPT，可以给它设每日上限或撤销。

> 不用贴 Key：用邮箱验证码登录后点“允许”即可。第一次来的话，登录这一步就会建好账户。

### Cursor

1. 在控制台创建一把 Key，设为环境变量 SOCIALTOAI_KEY。
2. 把这段配置加到 ~/.cursor/mcp.json；只在某个项目里用，就放到项目的 .cursor/mcp.json。
3. 打开 Cursor 设置里的 MCP，确认 socialtoai 和它的工具已列出，然后在对话里提问。

~/.cursor/mcp.json：

```
{
  "mcpServers": {
    "socialtoai": {
      "url": "https://mcp.socialtoai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SOCIALTOAI_KEY}"
      }
    }
  }
}
```

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### Codex

1. 在控制台创建一把 Key，导出为环境变量 SOCIALTOAI_KEY。
2. 把这几行加到 ~/.codex/config.toml。
3. 打开 Codex 直接提问。Codex 从环境变量读取 Key，配置文件里不写 Key。

~/.codex/config.toml：

```
[mcp_servers.socialtoai]
url = "https://mcp.socialtoai.com/mcp"
bearer_token_env_var = "SOCIALTOAI_KEY"
```

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### Trae

1. 在控制台创建一把 Key。
2. 在 Trae 里打开 MCP 面板，选择手动添加，粘贴这段配置。
3. 把 <YOUR_API_KEY> 换成你的 Key，确认后在对话里提问。

MCP → 添加 → 手动配置：

```
{
  "mcpServers": {
    "socialtoai": {
      "url": "https://mcp.socialtoai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### Cherry Studio

1. 在控制台创建一把 Key。
2. 在 Cherry Studio 打开“设置 → MCP 服务器”，按这些值添加一个服务器。
3. 把 <YOUR_API_KEY> 换成你的 Key，保存并启用，然后提问。

设置 → MCP 服务器 → 添加：

- 名称：`SocialToAI`
- 类型：`Streamable HTTP`
- URL：`https://mcp.socialtoai.com/mcp`
- 请求头：`Authorization=Bearer <YOUR_API_KEY>`

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### Dify

1. 在控制台创建一把 Key。
2. 在 Dify 打开“工具 → MCP”，添加一个 HTTP 服务并填入这些值；请求头在高级设置里。
3. 把 <YOUR_API_KEY> 换成你的 Key 并保存，之后就能把这些工具加进 Agent 或工作流。

工具 → MCP → 添加 MCP 服务（HTTP）：

- 服务端点 URL：`https://mcp.socialtoai.com/mcp`
- 名称：`SocialToAI`
- 服务器标识符：`socialtoai`
- 请求头：`Authorization: Bearer <YOUR_API_KEY>`

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

### n8n

1. 在控制台创建一把 Key。
2. 给 AI Agent 加一个 MCP Client Tool 节点，填入这些值。
3. 把 Key 存进 Bearer Auth 凭证里，不要写在节点上，然后运行工作流。

MCP Client Tool 节点：

- Endpoint：`https://mcp.socialtoai.com/mcp`
- Server Transport：`HTTP Streamable`
- Authentication：`Bearer Auth`
- Bearer Token：`<YOUR_API_KEY>`

> 把 <YOUR_API_KEY> 换成你的 Key。Key 只在创建时显示一次。

## 工具（16 个）

| 工具 | 做什么 | 每次调用 |
| --- | --- | --- |
| `search` | 按关键词找内容或账号 | 2–12 积分 |
| `trending` | 现在什么在火 | 2–12 积分 |
| `detail` | 一条内容的正文和数据 | 1–12 积分 |
| `comments` | 一条内容下的评论 | 2–12 积分 |
| `user_profile` | 一个账号的简介和数据 | 1–12 积分 |
| `user_posts` | 一个账号发过的内容 | 2–12 积分 |
| `find` | 描述一个任务或贴一个链接，返回该用哪个调用、参数怎么填、多少积分。 | 免费 |
| `call` | 调用 find 给出的平台独有接口。 | 按接口计 |
| `capabilities` | 每个平台支持什么，每次调用多少积分。 | 免费 |
| `brand_buzz` | 各平台上大家怎么评价一个品牌或产品：态度占比、提到最多的事、互动最高的帖子，每条都带来源链接。 | 运行前报价 |
| `comment_insights` | 帖子评论区在说什么：话题及占比、提问、想买、投诉，并附原话。 | 运行前报价 |
| `find_creators` | 一个平台上某个细分领域的达人：体量、近期作品、契合度与依据。 | 运行前报价 |
| `account_watch` | 一批账号最近发了什么，哪条明显比平时好。 | 运行前报价 |
| `creator_card` | 一个达人在各平台的账号：粉丝、作品、互动，以及每个账号确属同一人的证据等级。 | 运行前报价 |
| `research` | Run one of these by its name, on our side | 运行前报价 |
| `account` | 余额、今日花费和上限。 | 免费 |

[每个工具的描述和参数](https://socialtoai.com/zh/docs/mcp/tools.md)

- [品牌口碑](https://socialtoai.com/zh/tools/brand-buzz.md)
- [评论分析](https://socialtoai.com/zh/tools/comment-insights.md)
- [账号监测](https://socialtoai.com/zh/tools/account-watch.md)
- [找达人](https://socialtoai.com/zh/tools/find-creators.md)
- [达人档案](https://socialtoai.com/zh/tools/creator-card.md)
- [批量链接数据](https://socialtoai.com/zh/tools/batch-stats.md)
- [爆款发现](https://socialtoai.com/zh/tools/viral-finder.md)

## 常见问题

**哪些 AI 客户端能用？**

任何能通过 HTTP 添加远程 MCP 服务器的客户端都可以。在 ChatGPT 和 Claude 网页版、桌面版里粘贴地址，点 Connect，登录后点“允许”；其余客户端把 API Key 放在请求头里。

**我的 AI 看得到我的 Key 吗？**

Key（或登录后拿到的令牌）保存在客户端里，随每次请求发出；它不在交给模型的内容里，我们的任何返回也不会回显它。我们只保存哈希，不写进日志。

**问一个问题多少钱？**

一个问题要调用几次，由你的 AI 决定。多数调用 2 积分（范围 1–24），每次返回都写明扣了多少、还剩多少，你的 AI 可以直接告诉你花了多少。

**调用失败会怎样？**

不扣费。返回里会说明原因和该怎么改，你的 AI 可以自己修正。结果不确定时，我们不会自动重试。

**有频率限制吗？**

每把 Key 每秒 1 次，首次购买后每秒 5 次。超出时会返回需要等待的时间，不扣费。
