用途
对网站执行一次聚焦的技术审计,覆盖 SEO、GEO(AI 回答中的引用)与 CRO,找出少数真正限制流量、AI 引用或转化的技术问题,给出证据,并交付一份说明“先修什么”的 HTML 报告。它不是清单式罗列:无法改变排名、引用或转化的检查项不进入结论。文档同时提醒,多数 SEO 问题其实是权威度问题而非技术问题,站点技术层面干净时应如实说明并保持报告简短。
主要能力
- 原始 HTML 爬取:读取 robots.txt 与站点地图,广度优先抓取内部链接(原始 HTML,模拟 AI 爬虫),并补充抓取链接无法到达的 sitemap 与 llms.txt URL,输出 summary.json、pages.jsonl、links.csv、sitemap.json。
- 站点级检查:主机与协议变体、各搜索引擎与 AI 代理的 robots.txt 判定、CDN/WAF 按 user agent 拦截、尾斜杠与参数变体、软 404、llms.txt 文本内容、技术栈与分析工具识别、PageSpeed 字段数据。
- JavaScript 渲染对比:按模板各取一个 URL(首页、money page、博客文章、分类/枢纽页、程序化页),比较原始 HTML 与无头 Chrome 的 DOM。
- Search Console 分析:索引状态、站点地图、漏斗(站点地图 URL、已索引、有展示、至少一个查询进入前三)、关键词蚕食、战略页面查询对齐。
- 其他引擎收录:通过浏览器工具核查 Bing、Brave、DuckDuckGo 的收录,以及 staging 与重复主机;并让 AI 助手引用 money page 的 H1 以验证可读性。
- 一页一关键词:为首页、money page、枢纽页及 GSC 前 20 页面建立关键词映射,对无目标、错配或薄弱的页面提出重写标题建议。
- 内链分析:孤儿页、深度、伪链接、指向重定向或错误的链接、money page 获得的上下文链接,并建议最多 10 条内链。
- CRO、速度与结构化数据:在移动宽度下对首页与 money page 做 CRO 检查;速度仅依据字段数据报告;按模板给出结构化数据建议(始终低优先级)。
- 优先级与报告:只保留失败项,按影响分配优先级,合并同根因问题,选出投入产出比最高的前三项,生成 audit.json 并渲染为 report.html。
使用方式
核心审计无需鉴权,依赖 Python 3 标准库。推荐 Google Search Console MCP、浏览器工具、Google Chrome/Chromium;可选 PAGESPEED_API_KEY、Screaming Frog 或 LibreCrawl、Bing Webmaster Tools。脚本位于 scripts/,以 python3 <skill-dir>/scripts/<name>.py 运行,输出统一放入运行文件夹。
主要步骤对应命令:
python3 scripts/crawl.py https://example.com --out <run>/ --max-pages 1000
python3 scripts/site_checks.py https://example.com --out <run>/site.json --urls <money page> <blog post> <other template> --psi
python3 scripts/render_check.py <url> <url> ... --out <run>/render.json
python3 scripts/render_report.py <run>/audit.json --out <run>/report.html
运行前会执行共享的任务预检与工具约定,读取 .seo-context.md(规范域名、money page 及目标关键词、集群、市场、工具清单)与同站既往审计;随后一次性询问(可跳过)规范域名与市场、money page 与目标关键词、报告语言与保存目录、是否使用 Screaming Frog 或内置爬虫。
适用场景
适用于需要诊断站点技术层面是否拖累搜索排名、AI 引用与转化,并希望获得可执行修复优先级的网站运营、SEO 与增长工作。对大型站点可分区块爬取或改用专用爬虫;爬取不完整时必须声明,不得将有缺口的爬取当作完整结果。
限制与注意事项
- 没有 GSC 时,只能执行基于爬取的检查,索引覆盖、蚕食与查询对齐需列为限制项;没有浏览器工具时,引擎收录标记为未知。
- site: 查询可能被忽略或出现 CAPTCHA,不得破解 CAPTCHA,应标记为未知;不信任结果计数。
- 部分 GSC MCP 批量检查上限为 10 个 URL;站点地图 API 的 indexed 字段为已废弃字段,不能当作已索引页面数报告。
- PageSpeed 无密钥配额常被耗尽,返回 429 时需在浏览器前台打开分析页读取真实用户数据,并区分 “This URL” 与 “Origin” 数据。
- 未经明确批准,不得更改 robots.txt、CDN 设置、重定向或 CMS 内容。
- 安装 LibreCrawl 需用户同意;输出只能写入运行文件夹,不得写入技能文件夹。
相关技能
seo-roast(单页内容与意图深度评审)、gsc-analysis(流量下滑、衰减、速赢、CTR 缺口)、internal-linking(完整内链方案与获批修改)、geo-audit-report(衡量 ChatGPT、Perplexity、Gemini 中的提及与引用)。