Communitygithub.com

AndresOrozcoDev/website

使用SEOmator CLI对网站进行SEO、技术、内容、安全性、JavaScript渲染及AI就绪性审计。返回针对LLM优化的报告,覆盖251条规则、20个类别,提供健康评分。适用于分析网站、调试SEO问题或检查站点健康状况。

website 是什么?

该技能使AI代理能够利用SEOmator CLI对网站进行全面审计,涵盖SEO、性能、安全性、JavaScript渲染、内容质量及AI/GEO就绪性等20个类别共251条规则。审计结果以LLM优化格式输出(例如XML),相比JSON可减少50-70%的token消耗,便于代理高效处理。支持单页快速审计、多页面爬取(最多100页)、强制刷新缓存以及按类别筛选审计范围。审计报告提供0-100分的总体健康评分(A-F等级),并按严重程度列出问题及修复建议。该技能适用于Claude Code、Cursor、Codex等AI代理,在分析网站SEO健康、调试技术问题、检查可访问性或评估AI就绪性时尤为有用。安装依赖后,通过`seomator audit`命令即可启动审计,并可配合`--no-cwv`跳过核心网页指标以加速。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SEO 审计技能

使用 SEOmator CLI 对网站进行 SEO、技术、内容、性能、安全、JavaScript 渲染及 AI 就绪性审计。

SEOmator 提供全面的网站审计,通过分析网站结构和内容,覆盖 251 条规则,横跨 20 个类别。

它会提供一个问题列表,包含严重级别、受影响的 URL 和可操作的修复建议。

链接

本技能的功能

该技能使 AI 代理能够根据 251 条规则在 20 个类别中审计网站,包括:

  • 核心 SEO(19 条规则):规范 URL、索引指令、标题唯一性、规范冲突/循环
  • 性能(22 条规则):LCP、CLS、FCP、TTFB、INP、压缩、缓存、精简、HTTP/2
  • 链接(19 条规则):损坏的链接、重定向链、锚文本、孤立页面、localhost/片段链接
  • 图片(14 条规则):替代文本、尺寸、延迟加载、现代格式、替代文本长度、背景图片
  • 安全性(16 条规则):HTTPS、HSTS、CSP、外部链接安全、泄露的秘密、SSL 过期/协议
  • 技术性 SEO(13 条规则):robots.txt、sitemap.xml、URL 结构、404 页面、软 404、错误代码
  • 可抓取性(18 条规则):Sitemap 冲突、可索引性信号、规范链、分页问题
  • 结构化数据(13 条规则):Schema.org 标记、文章、组织、FAQ、产品、面包屑导航
  • JavaScript 渲染(13 条规则):已渲染 DOM 检查、原始与渲染不匹配、SSR 检测
  • 可访问性(12 条规则):ARIA 标签、颜色对比度、表单标签、地标、触摸目标
  • 内容(17 条规则):字数、可读性、关键词密度、重复检测、像素宽度
  • 社交(9 条规则):Open Graph 标签、Twitter 卡片、分享按钮、个人资料链接
  • E-E-A-T(14 条规则):作者署名、引用、信任信号、关于/联系页面、YMYL 检测
  • URL 结构(14 条规则):关键词别名、停用词、大写、下划线、会话 ID、跟踪参数
  • 重定向(8 条规则):重定向循环、类型(301/302)、元刷新、JavaScript 重定向、损坏的重定向
  • 移动端(5 条规则):字体大小、水平滚动、侵入式插页、视口问题
  • 国际化(10 条规则):lang 属性、hreflang 验证(返回链接、冲突、不匹配)
  • HTML 验证(9 条规则):DOCTYPE、字符集、头部结构、lorem ipsum、多个标题/描述
  • AI/GEO 就绪性(5 条规则):语义化 HTML、AI 机器人访问、llms.txt、Schema 漂移
  • 法律合规(1 条规则):Cookie 同意

审计会抓取网站,根据审计规则分析每个页面,并返回一份综合报告,包含:

  • 总体健康评分(0-100),附带字母等级(A-F)
  • 按类别细分的通过/警告/失败计数
  • 按规则分组的具体问题及受影响的 URL
  • 可操作的修复建议

何时使用

当您需要以下操作时,使用此技能:

  • 分析网站的 SEO 健康
  • 调试技术性 SEO 问题
  • 检查损坏的链接和重定向链
  • 验证元标签、规范 URL 和结构化数据
  • 审计安全标头、SSL 和 HTTPS
  • 检查可访问性合规性
  • 分析 JavaScript 渲染和 SSR 兼容性
  • 评估 AI/GEO 就绪性(语义化 HTML、llms.txt、机器人访问)
  • 检测页面间的重复内容
  • 验证 hreflang 和国际化的设置
  • 检查 HTML 文档结构和验证
  • 以多种格式生成网站审计报告
  • 比较变更前后的网站健康度

前提条件

此技能需要安装 SEOmator CLI。

安装

npm install -g @seomator/seo-audit

验证安装

检查 seomator 是否已安装且系统就绪:

seomator self doctor

这会检查:

  • Node.js 版本(推荐 18+)
  • npm 可用性
  • 用于核心网页指标和 JS 渲染的 Chrome/Chromium
  • 对 ~/.seomator 的写入权限
  • 本地配置文件是否存在

设置

运行 seomator init 会在当前目录创建一个 seomator.toml 配置文件。

seomator init                    # 交互式设置
seomator init -y                 # 使用默认值
seomator init --preset blog      # 博客优化配置
seomator init --preset ecommerce # 电商配置
seomator init --preset ci        # 最小化 CI 配置

如果目录中没有 seomator.toml 文件,请在运行审计之前使用 seomator init 创建一个。

使用方法

AI 代理最佳实践

您应该始终优先使用 --format llm - 它提供了专为 AI 代理优化的 token 高效 XML 输出(比 JSON 小 50-70%)。

审计时:

  1. 优先选择在线网站,而不是本地开发服务器,以获得准确的性能和渲染数据
  2. 当不需要核心网页指标和 JS 渲染检查时,使用 --no-cwv 以加快审计速度
  3. 在实施多个修复时,将修复任务分解为并发的子任务
  4. 在实施修复后运行类型检查/格式化(如 tsc、eslint、prettier 等)

网站发现

如果用户未提供要审计的网站:

  1. 检查本地开发服务器配置(package.json 脚本、.env 文件)
  2. 查找 Vercel/Netlify 项目链接
  3. 检查环境变量中的部署 URL
  4. 让用户提供要审计的 URL

如果您同时拥有本地和在线网站,建议审计在线站点以获得准确结果。

基本工作流程

# 快速单页审计,使用 LLM 输出
seomator audit https://example.com --format llm --no-cwv

# 多页面抓取(最多 50 页)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv

# 完整审计,包含核心网页指标 + JS 渲染分析
seomator audit https://example.com --crawl -m 20 --format llm

高级选项

强制全新抓取(忽略缓存):

seomator audit https://example.com --refresh --format llm

恢复中断的抓取:

seomator audit https://example.com --resume --format llm

仅审计特定类别:

seomator audit https://example.com -c core,security,js --format llm --no-cwv

保存 HTML 报告以共享:

seomator audit https://example.com --format html -o report.html

用于调试的详细输出:

seomator audit https://example.com --format llm -v

命令参考

审计命令选项

选项别名描述默认值
--format <fmt>-f输出格式:console, json, html, markdown, llmconsole
--max-pages <n>-m最大抓取页面数10
--crawl启用多页面抓取false
--categories <列表>-c要审计的类别(逗号分隔)全部
--refresh-r忽略缓存,重新获取false
--resume恢复中断的抓取false
--no-cwv跳过核心网页指标 + JS 渲染false
--verbose-v显示进度false
--output <路径>-o输出文件路径
--config <路径>配置文件路径
--save保存到 ~/.seomatorfalse

其他命令

seomator init              # 创建配置文件
seomator self doctor       # 检查系统设置
seomator config --list     # 显示所有配置值
seomator report --list     # 列出过去的报告
seomator db stats          # 显示数据库统计信息

输出格式

格式标志最佳用途
console--format console人类终端输出(默认)
json--format jsonCI/CD、程序化处理
html--format html独立报告、共享
markdown--format markdown文档、GitHub
llm--format llmAI 代理(推荐)

--format llm 输出是一种紧凑的 XML 格式,针对 token 效率进行了优化:

  • 比 JSON 输出小 50-70%
  • 问题按严重性排序(关键优先)
  • 每个问题附带修复建议
  • 干净的 stdout,便于通过管道传输到 AI 工具

示例

示例 1:使用 LLM 输出进行快速审计

# 用户问:“检查 example.com 的 SEO 问题”
seomator audit https://example.com --format llm --no-cwv

示例 2:对大型网站进行深度抓取

# 用户问:“进行深入审计,最多 100 页”
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv

示例 3:变更后重新审计

# 用户问:“重新审计网站,忽略缓存结果”
seomator audit https://example.com --refresh --format llm --no-cwv

示例 4:生成可共享的报告

# 用户问:“创建一个可共享的 HTML 报告”
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html

示例 5:聚焦特定领域

# 用户问:“只检查我的 JavaScript 渲染和重定向”
seomator audit https://example.com -c js,redirect --format llm

评估结果

分数范围

分数等级含义
90-100A优秀 - 仅需微小优化
80-89B良好 - 处理警告
70-79C需要改进 - 需要优先修复
50-69D差 - 存在多个关键问题
0-49F严重 - 需要解决主要问题

优先级顺序(按类别权重)

按以下顺序修复问题以获得最大影响:

  1. 核心(12%)- 元标签、规范、H1、索引
  2. 性能(12%)- 核心网页指标 + 优化
  3. 链接(8%)- 内部链接结构
  4. 图片(8%)- 性能 + 可访问性
  5. 安全性(8%)- 信任信号、SSL
  6. 技术性 SEO(7%)- 抓取基础
  7. 可抓取性(5%)- 可索引性、分页
  8. 结构化数据(5%)- 富媒体摘要
  9. JavaScript 渲染(5%)- 已渲染 DOM、SSR
  10. 内容(5%)- 文本质量 + 重复
  11. 可访问性(4%)- WCAG 合规性
  12. 社交(3%)- 社交分享
  13. E-E-A-T(3%)- 信任、专业知识
  14. URL 结构(3%)- URL 卫生
  15. 重定向(3%)- 重定向链
  16. 移动端(2%)- 视口、字体
  17. 国际化(2%)- Hreflang
  18. HTML 验证(2%)- 文档结构
  19. AI/GEO 就绪性(2%)- 语义化 HTML、AI 机器人
  20. 法律合规(1%)- Cookie 同意

按严重程度修复

  1. 失败(status: "fail")- 必须立即修复
  2. 警告(status: "warn")- 应尽快修复
  3. 通过(status: "pass")- 无需操作

输出总结

实施修复后,向用户提供所有更改的摘要。

在规划范围时,将任务组织起来,使其可以作为子代理并发运行,以加速实施。

故障排除

seomator 命令未找到

如果看到此错误,表示 seomator 未安装或不在 PATH 中。

解决方法:

npm install -g @seomator/seo-audit

核心网页指标未测量

如果缺少 CWV 指标,可能是 Chrome/Chromium 不可用。

解决方法:

  1. 安装 Chrome、Chromium 或 Edge
  2. 运行 seomator self doctor 验证浏览器检测
  3. 如果不需要,使用 --no-cwv 跳过 CWV

抓取超时或性能缓慢

对于大型网站,审计可能需要几分钟。

解决方法:

  • 使用 --verbose 查看进度
  • 使用 -m 20 限制页面数以获得更快结果
  • 使用 --no-cwv 跳过基于浏览器的测量

无效 URL

确保 URL 包含协议:

# 错误
seomator audit example.com

# 正确
seomator audit https://example.com

工作原理

  1. 获取:下载页面 HTML 并测量响应时间
  2. 解析:提取 DOM、元标签、链接、图片、结构化数据
  3. 丰富:每次审计获取一次 robots.txt 和 sitemap
  4. 渲染(如果启用 CWV):通过 Playwright 捕获已渲染 DOM 以进行 JS 渲染分析
  5. 抓取(如果启用):发现并获取链接的页面
  6. 分析:对每个页面运行 251 条审计规则
  7. 评分:计算类别和总体加权得分
  8. 报告:以请求的格式生成输出

结果存储在 ~/.seomator/ 中,以后可通过 seomator report 检索。

资源

  • 完整规则参考:参见 docs/SEO-AUDIT-RULES.md 了解所有 251 条规则
  • 存储架构:参见 docs/STORAGE-ARCHITECTURE.md 了解数据库细节
  • CLI 帮助:seomator --help 和 seomator <command> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

相关技能