内容
# AI 品牌监测 MCP
> **AI 搜索品牌可见性 MCP，用于 AI 代理 — 30 秒内 OAuth，无需 API 密钥。** 跟踪您的品牌在 Perplexity、ChatGPT、Claude 和 Gemini 搜索结果中的表现，直接在 Claude、Cursor、Codex、Windsurf、ChatGPT 和任何与 MCP 兼容的 AI 客户端中。
[](https://www.npmjs.com/package/ai-brand-monitor-mcp)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://apify.com/khadinakbar/ai-search-brand-monitor)
[](#%E9%80%89%E6%93%87A--%E4%BF%9D%E4%BA%98MCP-OAuth-%E6%8E%A8%E8%8D%B7)
[](#claudeai-%E7%BD%91%E9%A1%B5-%E7%89%84%E5%90%8C%E6%89%8B%E6%9C%BA%E4%B8%80%E8%AE%87%E8%AE%BF%E9%97%AE%E8%AE%BF%E9%97%AE)
[](#cursor)
[](#windsurf)
[](#vs-code)
---
## 这是什么
一个 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，为任何与 MCP 兼容的 AI 代理提供了一种单一、可靠的方式来衡量品牌在四个 AI 搜索平台上的可见性：
- 🔍 **Perplexity** — 原生 Sonar 搜索 + 引文
- 💬 **ChatGPT** — gpt-4o-search-preview，带有实时网络搜索
- 🧠 **Claude** — Claude Sonnet 4.5，带有原生 Anthropic web_search 工具
- ✨ **Gemini** — Gemini 2.5 Flash，带有 Google Search 基础
### 每次调用返回的内容
对于每个 `品牌 × 查询 × 平台` 组合：
- 📊 **提及率** 和 **位置分数** （1 = AI 带领您的品牌，10 = 未提及）
- 📎 **引文检测** — AI 是否链接到您的域名？
- 😊 **情感** — 积极、中立或消极的表述
- 🥊 **竞争对手共同提及** — 哪些竞争对手出现在同一响应中？
- 🎯 **GEO 分数** （0–100）和运行摘要中的纯英文建议
由具有 OpenRouter 路由 API、每个平台的原生网络搜索和每个检查 0.08 美元的扁平费率的 [Apify 演员](https://apify.com/khadinakbar/ai-search-brand-monitor) 支持。
### 为什么在 AI 代理中使用它？
传统的品牌监测工具位于单独的仪表板中。而这个工具位于 **代理内部**：Claude、Cursor、Codex 或任何其他 MCP 客户端可以计划 GEO 策略、审计品牌、差异两个品牌或检查每周趋势 — 并在同一回合中实际拉取数据。
---
## 安装的两种方式
| | 选项 A：**云 MCP（OAuth）** | 选项 B：自托管（npm） |
|--|--|--|
| 安装时间 | ~30 秒 | 2–3 分钟 |
| 您需要 | Apify 账户（OAuth 弹出窗口登录） | Node 18+ 和 Apify API 令牌 |
| 运行位置 | Apify 云 | 您的机器 |
| 最适合 | 大多数用户 — Claude、Cursor、Windsurf、VS Code、Codex | 自托管基础设施、隔离网络、 高级覆盖 |
| 配置 | 一个 URL | 命令 + 令牌环境变量 |
**不确定选择哪一个？** 选择选项 A。这就是为什么它排在首位。
### 客户端覆盖概览（选项 A）
| 客户端 | 界面 | 安装路径 |
|--------|---------|--------------|
| [Claude.ai](#claudeai-%E7%BD%91%E9%A1%B5-%E7%89%84%E5%90%8C%E6%89%8B%E6%9C%BA%E4%B8%80%E8%AE%BF%E9%97%AE%E8%AE%BF%E9%97%AE) | 网页 · 桌面 · Cowork · iOS · Android | 设置 → 连接器 → 添加自定义连接器 |
| [ChatGPT](#chatgpt-%E7%BD%91%E9%A1%B5-%E4%B8%8A%E4%B8%8D%E5%90%8C%E7%89%84%E4%B8%8D%E5%90%8C%E5%B9%B4%E4%BC%98%E4%BC%8F%E6%88%91%E9%99%86) | 网页 · 桌面 | 设置 → 连接器 → 创建（Pro/Team/Enterprise/Edu） |
| [Cursor](#cursor) | 桌面 | 一键式深层链接或 `~/.cursor/mcp.json` |
| [Claude 代码](#claude-%E4%BB%A3%E7%A0%81) | 命令行界面 | `claude mcp add --transport http ...` |
| [VS 代码](#vs-code) | 桌面 | `.vscode/mcp.json` |
| [Windsurf](#windsurf) | 桌面 | `~/.codeium/windsurf/mcp_config.json` |
| [OpenAI Codex 命令行界面](#openai-codex-%E5%91%98%E4%BB%A3%E7%A0%81) | 命令行界面 | `~/.codex/config.toml` |
---
## 选项 A — 云 MCP（OAuth，推荐）
### 🔗 您需要的唯一 URL
```
https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor
```
将其粘贴到任何与 MCP 兼容的客户端中。首次调用时，会打开一个浏览器选项卡，您登录 Apify，然后工具就会生效。无需令牌，无需 npm 安装。一个设置涵盖 Claude 网页、Claude 桌面版、Cowork、移动应用、ChatGPT 网页、Cursor、Windsurf、VS Code、Claude Code、Codex 命令行界面以及任何其他 Streamable-HTTP MCP 客户端。
> 不熟悉 Apify？ 账户免费，并包含 **5 美元积分** — 足以进行约 60 次品牌查询检查，然后您再付一分钱。
### Claude.ai（网页版、Cowork、移动版、桌面版 — 全部在一个设置中）
1. 打开 **Claude → 个人资料图标 → 设置 → 连接器**。
2. 滚动到底部并点击 **“添加自定义连接器”**。
3. 粘贴：
```
https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor
```
4. 点击 **连接**。浏览器选项卡打开以进行 Apify OAuth。批准它。
5. 您已完成 — 连接器适用于 Claude 网页、桌面版、Cowork 和移动应用，设置简单。
适用于免费、专业、最大、团队和企业计划（免费计划限制为 1 个自定义连接器）。
### ChatGPT（网页版 — 专业版、团队版、企业版、教育版）
1. 打开 **ChatGPT → 设置 → 连接器** （如果您在高级设置中看不到它，请先切换 **开发者模式** ）。
2. 点击 **创建** / **添加自定义连接器**。
3. 填写：
- **名称：** `AI 品牌监测器`
- **描述：** `跟踪品牌在 Perplexity、ChatGPT、Claude 和 Gemini 上的可见性。`
- **MCP 服务器 URL：** `https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor`
- **身份验证：** OAuth（推荐）或带有您的 Apify API 令牌的 Bearer
4. 保存。首次调用会打开 Apify OAuth 弹出窗口。
不在免费计划上可用。
### Claude 桌面版
打开 `~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）或 `%APPDATA%\Claude\claude_desktop_config.json` （Windows）。添加：
```json
{
"mcpServers": {
"ai-brand-monitor": {
"url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
}
}
}
```
重启 Claude 桌面版。首次调用会打开 OAuth 弹出窗口。
### Cursor
要么：
- **一键式：** 点击 Apify Store 列表中的 Cursor deeplink，或
- **手动：** 添加到 `~/.cursor/mcp.json`：
```json
{
"mcpServers": {
"ai-brand-monitor": {
"url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
}
}
}
```
### Claude 代码
```bash
claude mcp add --transport http ai-brand-monitor \
https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor
```
### VS 代码
在工作区中创建 `.vscode/mcp.json`：
```json
{
"servers": {
"ai-brand-monitor": {
"type": "http",
"url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
}
}
}
```
### Windsurf
编辑 `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"ai-brand-monitor": {
"serverUrl": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
}
}
}
```
### OpenAI Codex 命令行界面
编辑 `~/.codex/config.toml`:
```toml
[mcp_servers.ai-brand-monitor]
url = "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
```
---
## 选项 B — 自托管（npm）
### 先决条件
- Node.js 18+
- [Apify API 令牌](https://console.apify.com/account/integrations) （免费，包含 5 美元积分）
### 通过 npx 安装（无需全局安装）
```jsonc
// Claude 桌面版或任何 JSON 配置
{
"mcpServers": {
"ai-brand-monitor": {
"command": "npx",
"args": ["-y", "ai-brand-monitor-mcp"],
"env": {
"APIFY_TOKEN": "apify_api_xxx"
}
}
}
}
```
### 可选环境变量
| 变量 | 默认值 | 目的 |
|---|---|---|
| `APIFY_TOKEN` | — | **必填。** 您的 Apify API 令牌。 |
| `APIFY_ACTOR_ID` | `khadinakbar/ai-search-brand-monitor` | 重写为运行分叉的演员。 |
| `DEFAULT_MAX_QUERIES` | `3` | 当代理未指定 `maxQueriesPerPlatform` 时使用。 |
| `MAX_QUERIES_CEILING` | `10` | `maxQueriesPerPlatform` 的上限。保护积分。 |
| `APIFY_WAIT_SECS` | `300` | 在超时之前等待演员运行的时间。 |
### 手动安装（克隆 + 构建）
```bash
git clone https://github.com/khadinakbarlabs/ai-brand-monitor-mcp.git
cd ai-brand-monitor-mcp
npm install
npm run build
node dist/index.js
```
---
## 工具
### `audit_brand_visibility`
使用标准查询模板运行全面 GEO 审计 — 适用于基线、每周监控以及内容测量前后。
| 参数 | 必需 | 描述 |
|---|---|---|
| `brandName` | ✅ | 要跟踪的品牌（例如 `"Ahrefs"`） |
| `brandDomain` | | 用于引文检测（例如 `"ahrefs.com"`） |
| `brandAliases` | | 替代名称 / 缩写 |
| `industry` | | 使模板查询特定于类别 |
| `competitors` | | 最多 10 个竞争对手品牌，用于共同提及跟踪 |
| `platforms` | | `perplexity`、`chatgpt`、`claude`、`gemini` 的子集 |
| `queryTemplates` | | `best_tools`、`alternatives`、`recommendations`、`reviews`、`comparisons` 的子集 |
| `maxQueriesPerPlatform` | | 1–20，默认 3 |
示例提示（在任何启用 MCP 的代理中）：
> “为 Ahrefs 运行品牌可见性审计，针对 Semrush 和 Moz 在 SEO 类别中。每平台拉取 5 个查询。”
### `check_brand_in_queries`
在所有四个平台上提交 1-10 个 **自定义** 问题 — 当用户有特定的提示要测试时效果最佳。
| 参数 | 必需 | 描述 |
|---|---|---|
| `brandName` | ✅ | 要跟踪的品牌 |
| `customQueries` | ✅ | 1-10 个问题（字符串） |
| `brandDomain` | | 用于引文检测 |
| `brandAliases` | | 替代名称 / 缩写 |
| `competitors` | | 最多 10 个竞争对手品牌 |
| `platforms` | | 平台子集 |
示例提示：
> “请 Perplexity、ChatGPT 和 Claude 回答 '什么是本地业务 SEO 最佳工具？'，并告诉我 Ahrefs 被提及的频率。”
---
## 输出形状
每次工具调用都会返回：
- `run` — Apify 运行元数据（runId、datasetId、apifyRunUrl），以便在 Apify 控制台中打开完整的数据集
- `count` — 每检查记录数
- `items[]` — 每个 `brand × query × platform` 的记录，包含提及上下文、情感、引文、竞争对手提及
- `summary` — 聚合 `geo_score` （0–100）、 `overall_mention_rate` 、 `platform_scores` 和纯英文 `recommendations`
- `truncated` — 如果数据集被上限， 则为布尔标志
字段是扁平且稳定的，因此代理可以可靠地跨运行提取值。
---
## 定价
Apify 演员按事件付费：
- `actor-start`：每次运行 **$0.00005** （每 GB RAM）
- `brand-query-checked`：**$0.08** 每次 `brand × query × platform` 事件
典型的审计（1 个品牌，3 个查询模板 × 每个 2 个查询 × 4 个平台 = 24 次检查）费用约为 **~$1.92**。所有四个 AI 平台都包含在内 — 无需单独的 OpenAI / Anthropic / Perplexity / Google 密钥。
您的前 **5 美元** Apify 积分可覆盖大约 60 次检查。
---
## 隐私和安全
- MCP 服务器永远不会看到 AI 平台 API 密钥 — 所有路由都在 Apify 上服务器端完成。
- 您的 Apify 令牌保留在 MCP 客户端配置或 Apify OAuth 会话中；服务器进程永远不会记录或保留它。
- 除非代理显式地将它们推送到其他地方，否则每次检查的记录都不会离开 Apify 的数据集存储。
---
## 常见问题
**问：这与直接调用 Perplexity / ChatGPT 有何不同？**
答：这会在一次调用中在所有四个 AI 平台上运行相同的提示，统一评分品牌提及，检测引文，并生成综合 GEO 分数。手动运行相同操作意味着四个单独的 API 注册、四个计费设置、四个不同的响应解析器，以及您必须自己计算的分数。
**问：为什么 Claude 有实时网络搜索？我以为 Claude 只使用其训练数据。**
答：底层 Apify 演员在服务器端启用 Claude 的原生 Anthropic `web_search_20250305` 工具，因此 Claude 返回现实的 2026 引文，而不是过时的训练数据。Gemini（原生 Google Search 基础）和 ChatGPT（原生 gpt-4o-search-preview）也是如此。
**问：我可以监控多个品牌吗？**
答：目前一次工具调用一个品牌。为多个品牌运行工具或每周运行一次以跟踪趋势。
**问：我应该多久运行一次？**
答：每周是最佳时机。在每次主要内容推送、产品发布或 PR 活动后运行，以衡量对 AI 搜索可见性的影响。
**问：我的 Apify 令牌是否存储在任何服务器上？**
答：选项 A（云 MCP）：您的令牌位于您自己的 Apify 会话中，由 Apify 的 OAuth 管理。选项 B（自托管）：令牌仅位于您的本地 MCP 客户端配置中。
---
## 贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md)。欢迎为：
- 带有安装代码段的附加 MCP 客户端
- 输出字段投影（应包含/排除 `items[]` 中的内容）
- 用于底层 Apify 演员的新查询模板类别
---
## 许可证
MIT — 参见 [LICENSE](LICENSE)。
由 [Khadin Akbar](https://github.com/khadinakbarlabs) 在生产 [ai-search-brand-monitor](https://apify.com/khadinakbar/ai-search-brand-monitor) Apify 演员之上构建。
