mcpField
G
geo-analysis

geo-analysis

github.com/openclaudia营销与增长722125 次安装1 周前更新
代码仓库

关于 geo-analysis

geo-analysis 是面向营销团队的域名 GEO/SEO 分析技能，可生成涵盖 AI 可见度、市场研究和竞争格局的 PDF 报告。它通过 Enception API 运行分析，并支持修正品牌名称以重新计算可见度。

主要功能

  1. 01分析 AI 品牌可见度
  2. 02研究市场与竞争者
  3. 03生成 PDF 报告
  4. 04修正品牌名称并重算可见度

适用场景

  1. 01评估品牌在 ChatGPT 和 Google AI 中的推荐情况
  2. 02为客户准备域名市场分析报告
  3. 03补充品牌别名以修正可见度结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill geo-analysis

安装后在 Claude Code 中输入/geo-analysis确认已加载。

详细介绍

GEO 分析

对域名运行完整的 GEO/SEO 分析，并获取可直接提供给客户的 PDF 报告：AI 可见度（ChatGPT / Google AI 是否会推荐该品牌）、深入的市场研究和竞争对手格局。

基于 Enception 客户分析 API 的轻量封装。包含三项操作：启动、状态、报告（以及可选的品牌名称更正）。

披露：由 Enception AI 贡献，会调用 Enception 的付费外部 API。文档：https://www.enception.ai/doc/api-client-analysis

要求

  • ENCEPTION_ANALYSIS_API_KEY — 作为 x-api-key 标头发送。自助获取：在 https://www.enception.ai 注册，然后在 Account → API Key 下生成免费套餐密钥（每月免费分析 2 次；如需更高限额，请联系团队）。速率限制：每分钟 10 个请求。

1. 启动

POST https://www.enception.ai/api/external/client-analysis/start

必填项：website_url、primary_region、core_goals。合理的默认值：primary_region=us、core_goals=traffic、output_language=en、competitors=[]。API 会将 URL 规范化为纯域名，并拒绝 IP 地址。返回 { id, message } —— 保存 id。

首先根据明确的请求选择 output_language，其次使用用户的对话语言，最后根据域名顶级域名选择（.cn → zh；否则为 en）。

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'

仅在用户明确指定时才覆盖 primary_region / core_goals / competitors。core_goals 为自由文本（例如 traffic、ranking）。竞争对手格式：[{"name":"X","domain":"x.com"}, ...]（最多 5 个）。对于多个域名，每个域名分别发送一次 POST，并收集各自的 id。

2. 状态

向 https://www.enception.ai/api/external/client-analysis/status 发送 POST 请求，请求正文为 { "id": "<id>" }，并使用相同的 x-api-key 标头。返回 { status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? }。

一次完整运行需要约 20–45 分钟——瓶颈在于深入市场研究步骤。请以较长间隔轮询（按分钟，而非秒）。succeeded 表示报告已准备好，可以获取。如果运行失败或无限期停滞，请如实告知用户，不要编造结果。

3. 报告

GET https://www.enception.ai/api/external/client-analysis/report/<id> ——公开访问，无需身份验证；可通过 id 分享。状态为 succeeded 后即可使用（也支持部分完成的运行）。

curl -s -o geo-analysis-example.pdf \
  "https://www.enception.ai/api/external/client-analysis/report/<id>"

确认这是真正的 PDF（file geo-analysis-example.pdf），然后将文件和/或公开 URL 提供给用户。

4. 修复“零可见度”（品牌名称更正）

向 https://www.enception.ai/api/external/client-analysis/update-brand 发送 POST 请求，请求正文为 { "id", "brand_name"?, "alternative_names": [...] }，并使用 x-api-key 标头。

如果报告显示 AI 可见度为零或较低，但 ChatGPT/Google 确实会推荐该品牌，几乎总是因为该品牌只以拼接域名标签为人所知（例如 pudurobotics），而 AI 引擎会说“Pudu Robotics”。提供真实名称和别名后，该路由会根据已存储的回答重新计算可见度（无需重新查询，速度很快），然后重新获取报告。

curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'

返回 { success, mention_rate, overall_score, average_position, analysis_regenerated }。新分析会自动确定品牌名称；此操作是针对现有报告的手动更正方式。

评论

支持 Markdown