SuperAPI AI 工具集

seo-technical

营销与增长

查看项目

更新于 10-20 09:32

技能介绍

该技能面向技术 SEO 审计,按 9 个类别组织检查项,并可选结合共享数据缓存、第三方数据与 Google 官方接口获取真实证据。

用途 用于对站点或单个 URL 做技术 SEO 体检,定位抓取、索引与渲染层面的问题,形成带评分和优先级的整改清单。

共享数据缓存 开始前检查 .seo-cache/ 中是否有可复用的上下文:site-meta.json(域名、业务类型、行业、抓取上下文)、audit-scores.json(此前完整审计的优先级)、pages/{url-slug}/page-analysis.json(页面级上下文)。仅使用明确有效的字段并注明来源时间;缓存缺失、损坏或不相关则重新采集;用户要求刷新或重跑时忽略缓存读取并覆盖写入。

主要能力(9 个类别)

  1. 抓取能力:robots.txt 是否存在且有效、是否误挡重要资源;XML 站点地图是否存在、是否在 robots.txt 中引用、格式是否有效;noindex 是否属有意设置;重要页面是否在首页 3 次点击内;关键内容是否依赖 JS 执行;大型站点(>1 万页)的抓取预算效率。同时涉及 AI 爬虫管理,并区分不同爬虫 token 的作用范围。
  2. 索引能力:canonical 是否自引用、是否与 noindex 冲突;重复内容(近似重复、参数 URL、www 与非 www);薄内容;分页方式;多语言多地区的 hreflang;索引膨胀。
  3. 安全:HTTPS 强制、证书有效性、混合内容;安全响应头(CSP、HSTS、X-Frame-Options、X-Content-Type-Options、Referrer-Policy);高安全站点的 HSTS preload。
  4. URL 结构:URL 是否简洁描述性、使用连字符、内容页不带查询参数;目录层级是否反映站点架构;重定向是否存在链(最多 1 跳)、永久迁移是否用 301;URL 长度超过 100 字符的标记;结尾斜杠是否一致。
  5. 移动端优化:viewport 与响应式 CSS;触控目标至少 48x48px 且间距 8px;基础字号不小于 16px;无横向滚动;移动优先索引现状说明。
  6. Core Web Vitals:LCP 目标 <2.5s、INP 目标 <200ms、CLS 目标 <0.1,按真实用户数据第 75 百分位评估;可用 PageSpeed Insights API 或 CrUX 数据。
  7. 结构化数据:检测 JSON-LD(首选)、Microdata、RDFa,并按 Google 支持类型校验。
  8. JavaScript 渲染:判断内容是否在初始 HTML 中可见、CSR 与 SSR 区分、SPA 框架可能带来的索引风险、动态渲染配置核对;并包含关于 canonical 冲突、JS 移除 noindex、非 200 状态码不渲染 JS、时间敏感结构化数据应服务端输出的注意事项。
  9. IndexNow 协议:是否支持 IndexNow(面向 Bing、Yandex、Naver 等非 Google 引擎),并建议实现以加快索引。

输出 给出技术评分(XX/100)、各分类的状态(pass/warn/fail)与分数,并按“立即修复的关键问题、1 周内的高优先级、1 个月内的中优先级、待办的低优先级”分级列出问题。

可选集成 若可用 DataForSEO MCP 工具,可调用 on_page_instant_pages、on_page_lighthouse、domain_analytics_technologies_domain_technologies 做真实页面分析与技术栈识别;若配置了 Google API 凭据,可运行 python scripts/pagespeed_check.py <url> --json、python scripts/crux_history.py <url> --json、python scripts/gsc_inspect.py <url> --json 获取真实数据。

错误处理 URL 不可达时报告连接错误与状态码并建议核查 URL、DNS 与公开可访问性;未发现 robots.txt 时记录并建议创建,其余类别继续审计;HTTPS 未配置时列为关键问题;CrUX 数据不可用时说明情况,建议以 Lighthouse 实验室数据作为替代并在流量提升后复测。

限制与收尾 部分检查依赖外部数据源或凭据,缺失时相应结论受限;工作流产出可复用发现时,按 shared-data-cache.md 的 schema 与命名规则写入 .seo-cache/ 简要 JSON 摘要(至少含 cache_type、analyzed_at、来源 URL/域名、关键发现、问题、建议、工具限制),并在 .gitignore 中补充 .seo-cache/。