SuperAPI AI 工具集

seo-technical

营销与增长

查看项目

更新于 10-16 05:48

技能介绍

用途:该技能用于执行技术 SEO 审计,数据来自 DataForSEO On-Page API,支持单页即时检查(instant_pages)与整站爬取(task_post + summary + pages)。

主要能力:

  • 单页模式:on_page_audit.py page --url <url>。
  • 整站模式:on_page_audit.py site --target <domain> --max-crawl-pages 100。官方说明约为每 100 页爬取 0.05-0.10 美元,耗时 2-5 分钟。
  • 评估类别包括:可索引性与爬取(4xx/5xx、超过 2 跳的重定向链、canonical 不匹配、robots.txt 与资源屏蔽、HTTPS 与混合内容);页面元数据(title 与 meta description 缺失或重复、长度建议 title 50-60 字符、description 140-160 字符、h1 缺失或重复、标题层级断层);速度与 Core Web Vitals(time_to_interactive、largest_contentful_paint、cumulative_layout_shift、资源错误);内容质量(plain_text_word_count 低于 300 视为薄内容、plain_text_rate、automated_readability_index);结构化数据(是否含 Schema、类型、是否缺少 organization/article/breadcrumb/product 等)。

必要用法:运行前必须执行凭证预检 ~/.claude/skills/seo/scripts/preflight.sh。退出码 0 表示凭证已配置;退出码 2 会输出设置向导,需停下并向用户展示,等待其按 login: 与 password: 格式提供凭证,然后写入 ~/.claude/skills/seo/.env 中的 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD,并执行 chmod 600。随后用 keyword_research.py volume "test" 验证。若出现 40104 需账号验证;其他鉴权错误应核对 API 密码。不得回显或提交凭证。

优先级规则:严重(5xx、关键页 no-index、canonical 损坏、混合内容、robots.txt 屏蔽);高(可索引页缺少 title/description、内部断链、重定向链、LCP 超过 4 秒);中(title/description 重复、大量缺 alt、关键页薄内容);低(标题层级断层、title 长度不佳、缺 Schema)。技术评分从 100 起扣:每个严重问题扣 15(上限 60),高扣 5(上限 30),中扣 1(上限 15),低扣 0.2(上限 5),最低为 0。返回 JSON 含 technical_score、crawl_summary、critical_issues、high_issues、medium_issues 等字段。

适用场景与限制:适合对站点做技术 SEO 体检并排序修复项。整站爬取有页数上限与费用,速度取决于站规模;具体计费与平台细节以官方资料为准,本资料未提供更多限制说明。