SuperAPI AI 工具集

seo-report

营销与增长

查看项目

更新于 10-16 05:44

技能介绍

用途:seo-report 读取 /seo audit 生成的审计 JSON(该审计基于 DataForSEO API 实时数据),输出 markdown 报告,本身不发起额外 API 调用,属于纯格式化步骤。

主要能力:从 ~/.claude/skills/seo/output/<domain>-audit.json 读取数据,生成 ~/.claude/skills/seo/output/<domain>-report.md。报告结构包含标题与生成日期、执行摘要、综合评分(满分 100)及关键词/技术/竞争对手/内容/权威度分项评分、关键指标两列表格、本周前三项行动(含原因与影响程度)、按优先级排列的问题清单(优先级/问题/建议)、热门关键词机会、竞争格局,以及说明数据来自 DataForSEO API、反映指定地区 Google 自然搜索结果的方法论段落。

使用方式:运行前必须先执行凭据预检 ~/.claude/skills/seo/scripts/preflight.sh。退出码为 0 时凭据已配置,静默继续;退出码为 2 时会输出 DataForSEO 设置向导,需停止操作并将向导原样展示给用户,等待其按 login: 与 password: 格式提供凭据。收到后解析这两个字段并写入 ~/.claude/skills/seo/.env(DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD),随后执行 chmod 600 ~/.claude/skills/seo/.env,并运行验证调用 ~/.claude/skills/seo/scripts/keyword_research.py volume "test"。若返回真实 JSON 即验证成功,可继续原请求;若出现状态码 40104,提示用户在 https://app.dataforseo.com/ 验证账户后回复 continue 重试;若为其他鉴权错误,提示检查 https://app.dataforseo.com/api-access 中的 API 密码(而非账号登录密码)。凭据不得回显、不得写入工具输出、不得提交。

适用场景:需要把已完成的 DataForSEO 审计整理成客户可直接阅读的 markdown 交付物时使用。

限制:报告语气直接自信、以数字而非形容词说明、建议须为具体动作;依赖既有审计 JSON,缺少该文件则无法生成报告;具体支持的域名数量、地区与价格等信息暂未提供。