SuperAPI AI 工具集

gsc-seo-optimizer

营销与增长

查看项目

更新于 10-16 08:35

技能介绍

用途:把用户自己的 Google Search Console(GSC)搜索证据转化为一小批有依据的优化建议,默认只做只读诊断,分析请求本身不授权发布或付费,执行改动需用户明确授权。

主要能力:先确认 GSC 资源(域属性或 URL 前缀)、目标市场、搜索类型与周期,再校验数据源一致性。支持三条数据路径:本地 CSV/ZIP 导出(用 scripts/import_gsc.py,仅需 Python 标准库);已授权的 Google API(可选 scripts/gsc_fetch.py,依赖 scripts/requirements-api.txt);以及已连接工具或已授权浏览器集成。默认对比最近 28 个完整 GSC 日与前一个不重叠 28 日,稀疏站点可用 90 天、新版本可用 7 天窗口,日期按太平洋时间计。分析时会区分品牌与非品牌词、区分排名缺口、摘要/意图不匹配、查询覆盖缺失与确认的技术问题,并输出每个页面的 URL、范围、点击/展示/CTR/排名、支撑查询、诊断、动作、业务相关性、置信度与复查间隔,通常仅 1–5 个页面,有时可为 0。

使用方式:先建立范围与数据路径,再按 references/data-quality.md 校验数据,按 references/roi-rubric.md 排序机会,按 references/report-template.md 保存基线;执行编辑前先查看项目自身说明与内容存储模式,限制在已批准页面内,备份 CMS 行,完成后校验渲染后的标题、描述、canonical、robots、schema、链接与可见内容,并运行项目相应检查,仅在授权后部署。

适用场景与限制:适合流量变化、页面/查询机会、索引编制等问题的诊断与优先级排序。不得把展示量当作索引结论,索引用 URL Inspection 或明确 UI 证据;不要把分开导出的页面与查询表拼接推断关系;不得由 CTR 单独判断意图不匹配,也不得仅凭两页面同时出现判定蚕食;不要做大规模年份更新、关键词堆砌或替换有效转化文案。

本地验证:在技能目录运行 python3 -m unittest discover -s tests -v,测试用合成数据检查解析、范围、日期窗口、分页与只读请求构造,API 响应为模拟,不证明实时授权或主机兼容性。需 Python 3.9 或更高版本。具体 API 认证与 URL Inspection 细节见 references/data-access.md。该技能改编自 Tracetify Skills,MIT 许可。