SuperAPI AI 工具集

geo-analysis

营销与增长

查看项目

更新于 10-16 03:06

技能介绍

用途:对某一域名运行完整的 GEO/SEO 客户分析,产出可交付的 PDF 报告,内容包括 AI 可见性(品牌是否被 ChatGPT、Google AI 推荐)、市场深度研究和竞品格局。本技能是 Enception 客户分析 API 的轻量封装,共三个操作:start、status、report,另有可选的品牌名修正。

前提:需要 ENCEPTION_ANALYSIS_API_KEY,以 x-api-key 请求头发送。可在 enception.ai 注册后在 Account → API Key 生成免费额度密钥(每月 2 次分析免费,更高额度需联系团队);速率限制 10 请求/分钟。

用法:start 通过 POST /api/external/client-analysis/start 发起,必填 website_url、primary_region、core_goals,默认 primary_region=us、core_goals=traffic、output_language=en、competitors=[];接口会把 URL 归一化为裸域名并拒绝 IP,返回 { id, message },需保存 id。output_language 优先按明确要求,其次按对话语言,再按域名 TLD(.cn→zh,否则 en)。竞品格式为 [{"name":"X","domain":"x.com"}],最多 5 个;多域名需逐个发起并收集 id。status 通过 POST .../status 传 { "id": "<id>" } 查询,返回 pending/failed/succeeded 及 progress_percent、pdf_url;完整运行约 20–45 分钟,瓶颈是市场研究步骤,应间隔数分钟轮询;失败或长期停滞须如实告知用户,不得编造结果。report 通过 GET .../report/<id> 获取,公开、无需鉴权,可按 id 分享,成功后可用。下载后应确认确为真实 PDF,再把文件或公开 URL 交给用户。

品牌名修正:当报告显示零/低 AI 可见性但品牌实际被推荐时,通常是因 AI 只用融合域名字符串识别品牌(如 pudurobotics 而引擎说 Pudu Robotics)。向 POST .../update-brand 传 id、brand_name、alternative_names,会基于已存答案重算可见性(不重新查询,较快),再重新获取报告;返回 success、mention_rate、overall_score、average_position、analysis_regenerated。新分析会自动解析品牌名,此路径仅用于修正已有报告。

限制:依赖 Enception 付费外部 API,需自备密钥;报告生成耗时较长;其余参数与费用细节以官方文档为准,资料未提供更多说明。