HTML/CSS 网站 SEO 审计…

当需要分析、修复、报告或实施 HTML/CSS 网站的 SEO 最佳实践（元标签、标题结构、图片、schema、移动端、技术 SEO）时使用。

适用场景

解决思路

1. 用 `python scripts/seo_analyzer.py <directory_or_file>` 启动全面 SEO 分析。
2. 让分析覆盖 title 标签（长度、存在性、唯一性）、meta description（长度、存在性）、标题结构（H1-H6 层级）、图片 alt 属性、Open Graph 标签、Twitter Card 标签、Schema.org 标记、HTML lang 属性、viewport 与 charset meta 标签、canonical URL、内容长度。
3. 选择输出：默认输出人类可读文本报告，含 issues、warnings、good practices；加 `--json` 输出机器可读 JSON。
4. 示例分析单文件：`python scripts/seo_analyzer.py index.html`。
5. 示例分析整个目录：`python scripts/seo_analyzer.py ./public`。
6. 示例获取 JSON 输出：`python scripts/seo_analyzer.py ./public --json`。
7. 审查结果时按三级分类处理：Critical Issues（🔴）为立即修复：缺失 title 标签、缺失 meta description、缺失 H1、图片无 alt 属性、缺失 HTML lang 属性。
8. Warnings（⚠️）为尽快修复以获最佳 SEO：title/description 长度不理想、多个 H1、缺失 Open Graph 或 Twitter Card 标签、缺失 viewport meta 标签、缺失 schema markup、标题层级问题。
9. Good Practices（✅）为已优化：元素格式正确、长度正确、必需标签存在。
10. Priority 1 修复缺失或差的 title 标签：在 `<head>` 添加唯一、描述性 title，如 `<title>Primary Keyword - Secondary Keyword | Brand Name</title>`，保持 50-60 字符，目标关键词放开头，每页唯一。
11. Priority 1 修复缺失 meta description：在 `<head>` 添加吸引点击的描述，包含目标关键词，150-160 字符。
12. Priority 1 修复缺失 H1 或多个 H1：确保每页恰好一个 H1，H1 描述主主题，并与 title 标签匹配或相关。
13. Priority 1 修复图片无 alt 文本：给所有图片添加描述性 alt，如 `<img src="image.jpg" alt="Descriptive text explaining image content">`。
14. Priority 1 修复缺失 HTML lang 属性：在 `<html>` 开始标签添加，如 `<html lang="en">`。
15. Priority 2 添加 viewport meta 标签：`<meta name="viewport" content="width=device-width, initial-scale=1.0">`。
16. Priority 2 添加 charset 声明：`<meta charset="UTF-8">`。
17. Priority 2 添加 Open Graph 标签：og:title、og:description、og:image、og:url、og:type。
18. Priority 2 添加 Twitter Card 标签：twitter:card、twitter:title、twitter:description、twitter:image。
19. Priority 2 添加 canonical URL：`<link rel="canonical" href="https://example.com/preferred-url">`。
20. Priority 3 实现 Schema markup：参考 `references/schema_markup_guide.md`，常见类型包括 Organization（首页）、Article/BlogPosting（博客文章）、LocalBusiness（本地商家）、Breadcrumb（导航）、FAQ（FAQ 页）、Product（电商）。
21. 用 JSON-LD 实现 schema，例如把 `{"@context":"https://schema.org","@type":"Article","headline":"Article Title","author":{"@type":"Person","name":"Author Name"},"datePublished":"2024-01-15","image":"https://example.com/image.jpg"}` 放入 `<script type="application/ld+json">`。
22. 修复问题后生成或更新 XML sitemap：`python scripts/generate_sitemap.py <directory> <base_url> [output_file]`。
23. 示例生成 sitemap：`python scripts/generate_sitemap.py ./public https://example.com`。
24. 示例指定输出位置：`python scripts/generate_sitemap.py ./public https://example.com ./public/sitemap.xml`。
25. 依赖 generate_sitemap.py 自动查找所有 HTML 文件、生成正确 URL、包含 lastmod 日期、估算 priority 和 changefreq 值、创建格式正确的 XML sitemap。
26. sitemap 生成后：上传 sitemap.xml 到网站根目录；在 robots.txt 中添加引用；提交到 Google Search Console 和 Bing Webmaster Tools。
27. 更新 robots.txt：使用 `assets/robots.txt` 模板并定制，包含 `User-agent: *`、`Allow: /`、`Disallow: /admin/`、`Disallow: /private/`、`Sitemap: https://yourdomain.com/sitemap.xml`，并放在网站根目录。
28. 验证和测试：本地再次运行 SEO analyzer 验证修复；检查所有 critical issues 已解决；确保未引入新问题。
29. 线上测试：部署改动到生产；用 Google Rich Results Test（https://search.google.com/test/rich-results）测试；用 https://validator.schema.org/ 验证 schema markup；用 https://search.google.com/test/mobile-friendly 检查移动友好性；在 Google Search Console 监控。
30. 持续优化：新增页面时更新 sitemap；保持 meta descriptions 新鲜和吸引人；确保新图片有 alt text；为新内容类型添加 schema markup；监控 Search Console 问题；定期更新内容。
31. Pattern 1 新网站设置：运行 `python scripts/seo_analyzer.py ./public`；给所有页面添加必要 meta 标签（title、description、viewport）；确保正确标题结构（每页一个 H1）；给所有图片加 alt text；在首页实现 organization schema；生成 sitemap `python scripts/generate_sitemap.py ./public https://yourdomain.com`；从模板创建 robots.txt；部署并提交 sitemap 到搜索引擎。
32. Pattern 2 现有网站审计：运行 `python scripts/seo_analyzer.py ./public`；识别并按优先级排序问题（critical 优先）；修复所有页面的 critical issues；添加缺失 Open Graph 和 Twitter Card 标签；为合适页面实现 schema markup；重新生成 sitemap；用 analyzer 验证修复；部署并监控。
33. Pattern 3 单页优化：分析特定文件 `python scripts/seo_analyzer.py page.html`；修复识别的问题；为目标关键词优化 title 和 meta description；确保正确标题层级；为页面类型添加合适 schema markup；用 analyzer 验证；如果是新页面则更新 sitemap。
34. Pattern 4 博客文章优化：确保唯一 title（50-60 字符）含目标关键词；写吸引人的 meta description（150-160 字符）；用单个 H1 作为文章标题；为章节实现正确 H2/H3 层级；给所有图片加 alt text；实现 Article 或 BlogPosting schema（见 `references/schema_markup_guide.md`）；添加 Open Graph 和 Twitter Card 标签用于社交分享；包含作者信息；添加 breadcrumb schema 用于导航。
35. 参考 `references/seo_checklist.md` 获取详细规范：title/meta description 指南、标题结构最佳实践、图片优化技巧、URL 结构建议、内部链接策略、页面速度优化、移动优化要求、语义 HTML 使用、完整技术 SEO checklist。
36. 参考 `references/schema_markup_guide.md` 实现 schema.org 结构化数据：JSON-LD 实现（推荐格式）、10+ 常见 schema 类型及示例、每种类型必需属性、最佳实践和常见错误、验证工具和资源。
37. 使用 `scripts/seo_analyzer.py` 做确定性、可重复的自动 SEO 分析，输出文本或 JSON。
38. 使用 `scripts/generate_sitemap.py` 生成 XML sitemap，自动爬取目录、估算 priority 和 changefreq、生成可提交的 sitemap。
39. 使用 `assets/robots.txt` 作为常见配置模板，按需定制并放在网站根目录。
40. 遵循用户优先原则：先优化用户体验，再优化搜索引擎；良好用户体验带来更好 SEO。
41. 确保每页有唯一 title、description 和 H1；重复内容伤 SEO。
42. 移动优先：Google 使用移动优先索引，始终包含 viewport meta 标签并确保移动响应式。
43. 可访问性等于 SEO：alt text、语义 HTML、正确标题有助于排名。
44. 质量优于数量：实质性有价值内容比薄内容排名好，追求全面页面。
45. 技术基础：先修复关键技术问题（缺失标签、结构损坏）再做高级优化。
46. 结构化数据：schema markup 帮助搜索引擎理解内容，可能带来 rich results。
47. 定期更新：SEO 是持续工作，保持内容新鲜、监控分析、适应算法变化。
48. 自然语言：为人类写作，避免关键词堆砌。
49. 验证：部署到生产前始终用测试工具验证改动。
50. 从 critical issues 开始：先修缺失 title 和 meta description，影响最大。
51. 保持一致：在所有页面应用优化，而非只主页。
52. 使用语义 HTML：使用 `<header>`、`<nav>`、`<main>`、`<article>`、`<aside>`、`<footer>`。
53. 优化图片：压缩图片、使用描述性文件名、始终包含 alt text。
54. 内部链接：用描述性锚文本链接到相关页面。
55. 页面速度重要：加载快的页面排名更好。
56. 移动端测试：大多数搜索来自移动端，确保优秀移动体验。
57. 监控 Search Console：用 Google Search Console 跟踪表现并发现问题。
58. 定期更新：新鲜内容表明网站活跃有价值。
59. Quick Reference Commands：`python scripts/seo_analyzer.py index.html`、`python scripts/seo_analyzer.py ./public`、`python scripts/generate_sitemap.py ./public https://example.com`、`python scripts/seo_analyzer.py ./public --json`。

适用边界 · 注意事项

• 不适用于非 HTML/CSS 网站，或完全由客户端 JavaScript 动态渲染、静态 HTML 中无实际内容的站点，除非先做预渲染/SSR。
• 不适用于与搜索引擎优化无关的纯代码重构或非 SEO 任务。
• 若必须依赖特定付费 SEO 平台或云厂商专属功能，本技能只覆盖本地脚本和免费验证工具，不能替代这些平台。