用 MCP 接入豹发GEO
让你的 AI 助手直接查询品牌在 DeepSeek、豆包、通义千问、文心一言、Kimi、元宝、ChatGPT、Gemini、Perplexity 等 AI 回答里的表现,并拿到可以照着做的优化建议。
能做什么
- 免费诊断任意官网:几个主流 AI 回答客户会问的问题时,会不会提到这个品牌(不需要套餐)。
- 看品牌的 AI 可见度、声量份额、各引擎明细,以及 AI 实际引用了哪些网页、实际搜了什么。
- 读取 GEO 审计、优化建议、关键词排名和每周洞察;发起页面审计、生成页面改写方案。
接入信息
- 地址:
https://www.baofageo.com/api/mcp - 传输方式:Streamable HTTP(无状态,JSON 响应)
- 鉴权:请求头
Authorization: Bearer <API Key>,或标准 OAuth 2.1(支持动态客户端注册)
获取 API Key
- 注册豹发GEO(免费)。
- 进入后台「组织设置 → API 密钥」,新建一个密钥。只读密钥可以使用全部查询工具和免费诊断;需要发起审计、生成方案时选“读写”。
- 把密钥填进下面的配置里。密钥只显示一次,请妥善保存。
配置示例
支持远程 MCP 的客户端(Cursor、扣子、魔搭、Cherry Studio 等):
{
"mcpServers": {
"baofageo": {
"type": "streamable-http",
"url": "https://www.baofageo.com/api/mcp",
"headers": {
"Authorization": "Bearer <你的 API Key>"
}
}
}
}Claude Code:
claude mcp add --transport http baofageo https://www.baofageo.com/api/mcp --header "Authorization: Bearer <你的 API Key>"只支持本地命令的客户端,可以通过 mcp-remote 转接:
{
"mcpServers": {
"baofageo": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://www.baofageo.com/api/mcp",
"--header",
"Authorization:Bearer ${BAOFAGEO_API_KEY}"
],
"env": {
"BAOFAGEO_API_KEY": "<你的 API Key>"
}
}
}
}Claude、ChatGPT 等支持 OAuth 的客户端也可以只填地址,按提示登录豹发GEO 授权,不需要手动复制密钥。
第一次使用
还没有创建品牌时,可以直接对 AI 助手说“用豹发GEO 免费诊断一下 example.com”。它会调用 run_free_diagnosis,大约一分钟后用 get_free_diagnosis 拿到结果。每个连接每天可免费诊断 3 次。
在国内平台中接入
各平台都用同一个地址和同一个 API Key。请求头写 Authorization: Bearer <API Key>;平台的“API Key / Service Token”栏只能填值、不带 Bearer 时,直接填密钥,或者用请求头 X-API-Key: <API Key>,两种写法都能识别。传输方式选 Streamable HTTP。
- 扣子(coze.cn):资源库 → 新建插件 → 插件类型选 MCP,填上面的地址,在 Header 列表里加 Authorization。也可以把 REST API 导入成普通插件:导入方式选 URL,填
https://www.baofageo.com/api/v1/openapi-3.0.json(OpenAPI 3.0 版本),授权方式选 Service token,位置 Header,参数名 Authorization。 - 腾讯元器 / 腾讯云智能体开发平台:插件 → 接入 MCP 插件,填名称、描述和地址,在高级设置里加请求头 Authorization。导入 API 插件同样可以用上面的 OpenAPI 3.0 地址,授权方式选 API Key。
- 阿里云百炼:MCP 管理 → 创建 MCP 服务,选择通过 http 连接远程服务,填写:
{ "mcpServers": { "baofageo": { "type": "streamableHttp", "url": "https://www.baofageo.com/api/mcp", "headers": { "Authorization": "Bearer <你的 API Key>" } } } } - 百度千帆 AppBuilder:在工作流里添加 MCP Server 节点,填地址,鉴权填 Authorization 请求头。
- 华为云 AgentArts:自定义接入 MCP,传输方式选 Streamable HTTP,鉴权选 API Key、位置请求头、名称 Authorization,值填
Bearer <API Key>。 - TRAE:在装有 TRAE 的电脑上打开一键安装链接,在弹出的配置里把 <YOUR_API_KEY> 换成你的密钥后确认;也可以在 设置 → MCP → 手动添加 里粘贴上面的远程配置。
- 通义灵码、Cherry Studio、LobeHub 等客户端:添加远程 MCP(Streamable HTTP),填地址和 Authorization 请求头;只支持本地命令的版本用上面的 mcp-remote 配置。
工具列表
| 工具 | 说明 | 密钥 |
|---|---|---|
whoami识别当前连接 | 当前 MCP 连接的信息:以谁的身份操作、可访问哪些组织,以及可调用哪些工具。无需任何权限,因此当请求失败且原因不明时,始终可以放心地首先调用它。 | 只读 |
list_models列出 AI 引擎 | 本部署实例已知的 AI 引擎/模型,以及其中实际正在跟踪的模型。在任意分析数据工具的 `model` 筛选参数中使用返回的 ID。 | 只读 |
list_brands列出品牌 | 当前连接跟踪的所有品牌。请从这里开始:其他品牌相关工具都需要使用此列表中的 ID。 | 只读 |
get_brand获取单个品牌 | 单个品牌的配置:域名、别名、跟踪的 AI 引擎以及采样频率。 | 只读 |
list_competitors列出竞品 | 针对某品牌跟踪的竞品,以及用于匹配提及的域名和别名。声量份额即以这些竞品为参照进行衡量。 | 只读 |
get_billing获取套餐和用量 | 工作区的套餐、各项限额以及每项的已用量。只读——没有任何工具可以更改订阅。 | 只读 |
list_prompts列出跟踪问题 | 代表品牌向 AI 引擎提出的跟踪问题。`enabled` 决定跟踪问题是否仍在采样。这是唯一可能很长的列表,因此支持分页。 | 只读 |
list_prompt_tags列出跟踪问题标签 | 品牌跟踪问题上正在使用的标签,以及带有每个标签的跟踪问题数。标签是派生出来的:只要仍有跟踪问题带有某个标签,该标签就存在。 | 只读 |
create_prompts创建跟踪问题 | 一次调用最多为品牌添加 100 个跟踪问题。全部成功或全部失败:若该批次会超出组织的套餐限额,则一个也不会创建。 | 读写 |
update_prompt更新跟踪问题 | 修改跟踪问题的文本、标签或是否采样。设置 `enabled: false` 即可让跟踪问题不再消耗运行次数——已记录的所有回答都会保留。 | 读写 |
get_analytics获取品牌分析数据 | 一次调用获取品牌在某个时间窗口内的全部数据:可见度及其每日趋势、相对于被跟踪竞品的声量份额、按 AI 引擎划分的明细,以及引用总数。被问到某个品牌表现如何时,应首先查看此数据。各项比率为 0–1 的小数,而非百分比。 | 只读 |
get_prompt_performance获取各跟踪问题表现 | 时间窗口内每个跟踪问题的表现——哪些问题会让品牌出现、哪些不会。仅包含已启用的跟踪问题;已停用的跟踪问题不会被采样,因此没有数据可报告。 | 只读 |
get_citations获取引用来源 | AI 引擎在回答与该品牌相关的问题时引用的页面,按域名和 URL 分别列出,并分类为品牌自有、竞品或第三方编辑内容。这是 AEO 内容规划的核心:其中的第三方编辑页面正是 AI 引擎获取答案的来源。 | 只读 |
get_query_fanout获取 AI 引擎执行的搜索 | AI 引擎在作答时实际执行的联网搜索(查询扩展)及其频次。这些才是需要优化的措辞——它们往往与跟踪问题本身的表述不同。 | 只读 |
get_opportunities获取最新优化机会报告 | 品牌最近一份已存储的优化机会报告:应撰写哪些内容、应修复哪些问题,以及系统发现的风险。`status` 表示是否有足够的数据生成报告。 | 只读 |
get_sentiment获取 AI 对品牌的情感评价 | 最近若干天里 AI 回答提到品牌时的评价:情感分(0–100,正面 100、中性或褒贬参半 50、负面 0 的平均,65 以上偏正面、50 以下偏负面)、正面/中性/褒贬参半/负面次数、竞品的情感分、按 AI 引擎的明细,以及好评、褒贬参半、批评三类回答原文摘录。被问到 AI 怎么评价某个品牌时使用。 | 只读 |
list_runs列出跟踪问题的回答记录 | 单个跟踪问题已记录回答的元数据,按时间倒序排列。回答正文需通过 get_run 获取,以使此列表足够精简、便于分页浏览。 | 只读 |
get_run获取单条完整回答 | 单条已记录的回答:模型回复的正文,以及它引用的每个页面。当你需要了解模型*如何*描述该品牌,而不仅仅是是否提及时,请查看此内容。 | 只读 |
get_weekly_insights获取每周洞察 | 最近 12 周的每周洞察:当周的关键指标,以及大模型写的解读(发生了什么变化、可能的原因、下周该做什么)。适合回答“最近怎么样、该做什么”。 | 只读 |
get_recommendations获取优化建议 | 品牌的优化建议清单,来自 GEO 审计、关键词排名和每周洞察。`active` 是待处理和处理中的建议,按优先级排序(数字越小越优先);`closed` 是最近完成或忽略的。`canBrief` 为 true 的建议可以用 request_page_brief 为其页面生成改写方案。 | 只读 |
update_recommendation更新优化建议状态 | 把一条优化建议标为已完成(done)、忽略(dismiss)或重新打开(reopen)。标为已完成会同时记一条页面变更,用于之后对比改动前后的效果,所以只在改动真的上线之后再标。 | 读写 |
get_geo_audits获取 GEO 审计结果 | 品牌各页面最近一次 GEO 审计:总分、分档、各维度得分、可引用性得分、站点检查项和改进建议,以及与上一次审计相比的分数变化。`pageUrls` 是已发现、可以送去审计的页面。 | 只读 |
request_geo_audit发起 GEO 审计 | 对品牌自己域名下的一个页面发起 GEO 审计(检查 AI 引擎能否读懂、引用该页面)。异步执行,通常一两分钟完成,之后用 get_geo_audits 查看结果。同一页面十分钟内重复发起会返回正在进行的那次;每个品牌每天最多 30 次。 | 读写 |
get_page_briefs获取页面优化方案 | 最近生成的页面优化方案(最多 20 份):针对某个页面,结合 AI 引擎实际引用的页面、跟踪问题和审计结果,给出的改写建议。`trackedUrls` 是品牌正在跟踪的页面。 | 只读 |
request_page_brief生成页面优化方案 | 为品牌自己的一个页面生成优化方案。会占用套餐的每月方案额度,额度用完会报错。异步执行,通常几分钟完成,之后用 get_page_briefs 查看。同一页面十五分钟内重复发起会返回正在生成的那份。 | 读写 |
get_rank_tracking获取关键词排名 | 品牌跟踪的搜索关键词及最近一次排名:名次、命中的网址、前排结果,以及搜索结果页是否出现 AI 概览、AI 概览是否提到或引用了品牌。`previousPosition` 是上一次检查的名次,用来看涨跌。 | 只读 |
run_free_diagnosis免费诊断网站的 AI 可见度 | 输入任意官网网址,免费检查国内外主流 AI 引擎在回答客户会问的问题时,会不会提到这个品牌。不需要先创建品牌,也不占套餐额度,适合第一次使用时先看看效果。异步执行,大约一分钟,之后用 get_free_diagnosis 查看。每个连接每天最多 3 次;当天别人诊断过的同一网站会直接复用结果。 | 只读 |
get_free_diagnosis查看免费诊断结果 | 查看 run_free_diagnosis 发起的诊断。`status` 为 pending / running 时请稍等再查(`stage` 表示进行到哪一步);为 done 时返回 `teaser`(概要)和 `full`(完整结果:每个问题、每个引擎的回答里是否提到品牌、提到了哪些竞品、引用了哪些网站,以及改进建议)。 | 只读 |
限额与计费
- 查询类工具不额外收费;创建跟踪问题、生成页面方案按套餐额度计。
- 每个品牌每天最多发起 30 次 GEO 审计;每个连接每天最多免费诊断 3 次。
- 每个 API Key 有每分钟调用上限,超出会返回 429,请按 Retry-After 稍后重试。
帮助
接入遇到问题,可以先让 AI 助手调用 whoami 查看当前身份和权限;仍有问题请联系 support@baofageo.com。