用 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

  1. 注册豹发GEO(免费)。
  2. 进入后台「组织设置 → API 密钥」,新建一个密钥。只读密钥可以使用全部查询工具和免费诊断;需要发起审计、生成方案时选“读写”。
  3. 把密钥填进下面的配置里。密钥只显示一次,请妥善保存。

配置示例

支持远程 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。