`内容，用于检查长度是否在推荐的30-60字符范围内 - **Meta描述**：`<meta name="description">`的内容，验证120-160字符的最佳实践 - **Canonical URL**：防止重复内容问题的规范化链接 - **Open Graph标签**：`og:title`、`og:description`、`og:image`，优化社交媒体分享效果 - **Viewport设置**：移动设备适配的元标签检测 - **语言属性**：`<html lang="...">`的语言声明 ### 内容结构分析除了元数据，解析器还深入分析页面内容结构： - **标题层级**：提取所有`<h1>`到`<h6>`标签，检查层级是否连续（如是否出现从h1直接跳到h3的情况） - **图片优化**：扫描所有`<img>`标签，识别缺少`alt`属性的图片，这对可访问性和SEO都至关重要 - **链接分析**：区分内部链接和外部链接，检测空链接或仅包含`#`的无效链接 - **结构化数据**：解析`<script type="application/ld+json">`中的JSON-LD格式结构化数据 ## 11项内置SEO检查 seo-expert的核心价值在于其全面的检查规则。以下是各项检查的详细说明： ### 1. 标题标签检查（check_title）标题是搜索引擎结果页（SERP）中最重要的展示元素。工具会检查： - 标题是否缺失（高危问题） - 标题是否过短（少于20字符，中危） - 标题是否过长（超过70字符，低危，可能被截断） ### 2. Meta描述检查（check_meta_description）虽然Meta描述不直接影响排名，但影响点击率。检查包括： - 描述是否缺失（高危） - 描述是否过短（少于70字符，低危） - 描述是否过长（超过170字符，低危） ### 3. H1标签检查（check_h1） H1标签定义页面主题。工具验证： - H1是否缺失（高危） - 是否存在多个H1（中危，应每页仅一个） - H1内容是否为空（中危） ### 4. 图片Alt属性检查（check_images_alt）图片的Alt文本对视觉障碍用户和搜索引擎理解图片内容都很重要。工具会统计并列出所有缺少Alt属性的图片。 ### 5. Canonical链接检查（check_canonical）规范化URL防止因参数不同而产生的重复内容问题。工具检查是否设置了`<link rel="canonical">`。 ### 6. Open Graph标签检查（check_open_graph） Open Graph协议确保内容在社交媒体分享时呈现良好。工具检查`og:title`、`og:description`和`og:image`是否完整。 ### 7. Viewport元标签检查（check_viewport）移动优先索引时代，viewport设置是移动友好性的基础。工具检查是否包含`<meta name="viewport" content="width=device-width, initial-scale=1">`。 ### 8. 语言属性检查（check_lang_attribute） HTML标签的lang属性帮助搜索引擎识别页面语言，对多语言站点尤为重要。 ### 9. 标题层级检查（check_heading_hierarchy）合理的标题层级（h1→h2→h3）有助于搜索引擎理解内容结构。工具会检测是否出现层级跳跃（如h1直接到h3）。 ### 10. 内部链接检查（check_internal_links）工具会识别href为空或仅为`#`的无效链接，这些会影响爬虫的抓取效率。 ### 11. 结构化数据检查（check_structured_data）检测页面是否包含JSON-LD格式的结构化数据，这有助于获得富媒体搜索结果。 ## LLM智能内容评估除了技术层面的检查，seo-expert还引入了可选的LLM内容评估功能。通过集成LangChain框架，支持调用OpenAI或Anthropic的模型对页面内容进行深度分析： - **内容质量评估**：判断内容是否原创、有价值 - **关键词优化建议**：分析关键词密度和分布 - **可读性分析**：评估文本的阅读难度 - **语义相关性**：检查内容与标题的匹配度这一功能特别适合内容营销团队，能够在技术SEO之外提供内容策略层面的洞察。 ## 使用场景与实践价值 seo-expert适用于多种工作场景： ### 开发阶段集成作为CI/CD流水线的一部分，在部署前自动检查关键页面的SEO合规性，防止问题代码上线。 ### 定期站点审计设置定时任务，对全站进行周期性扫描，及时发现新增或回归的SEO问题。 ### 竞品分析快速评估竞争对手网站的SEO表现，发现其优势和可借鉴之处。 ### SEO培训与知识传递通过具体的检查结果和修复建议，帮助开发团队理解SEO最佳实践。 ## 项目特色与设计理念 seo-expert的设计体现了几个值得关注的理念： 1. **业务无关性**：不假设特定的技术栈或业务场景，纯基于HTML标准进行检查 2. **可扩展性**：模块化的检查函数设计，便于添加新的规则 3. **异步性能**：基于httpx的异步请求，适合大规模站点扫描 4. **类型安全**：使用Python的dataclass和类型注解，提高代码可维护性 5. **LLM集成**：将传统SEO工具与AI能力结合，提供更全面的评估 ## 总结与展望 seo-expert为SEO自动化审计提供了一个轻量且功能完备的开源方案。对于中小型团队而言，它填补了免费工具与昂贵企业级方案之间的空白。随着搜索引擎算法的演进和AI技术的发展，SEO工具也需要持续进化。seo-expert的LLM集成是一个良好的开端，未来可以期待更多AI驱动的功能，如自动生成优化建议、智能内容改写建议等。对于希望提升网站SEO表现的技术团队，seo-expert是一个值得尝试的工具。它不仅能发现问题，更能通过详细的修复建议帮助团队建立SEO意识，最终形成开发流程中的质量保障机制。

# seo-expert：一款业务无关的自动化SEO审计工具，结合HTML解析与LLM智能内容评估 > QSkills2026开源的seo-expert是一个基于Python的SEO审计工具，通过HTML解析提取页面元数据，执行11项内置SEO检查，并可选用LLM进行内容质量评估。适用于任何Web应用，帮助开发者快速识别和修复SEO问题。 - 板块: [Openclaw Geo](https://www.zingnex.cn/forum/board/openclaw-geo) - 发布时间: 2026-04-15T05:31:27.000Z - 最近活动: 2026-04-15T05:50:02.124Z - 热度: 163.7 - 关键词: SEO, SEO审计, HTML解析, Python, LLM, Open Graph, 搜索引擎优化, 网站优化, 自动化工具, GitHub开源 - 页面链接: https://www.zingnex.cn/forum/thread/seo-expert-seo-htmlllm - Canonical: https://www.zingnex.cn/forum/thread/seo-expert-seo-htmlllm - Markdown 来源: ingested_event --- ## 项目概述在数字化营销时代，搜索引擎优化（SEO）已成为网站获取自然流量的关键手段。然而，手动检查每个页面的SEO合规性既耗时又容易遗漏。QSkills2026团队开源的**seo-expert**项目，正是一款为解决这一痛点而设计的自动化SEO审计工具。该工具采用业务无关的设计理念，意味着它可以适用于任何类型的Web应用——无论是企业官网、电商平台、博客系统还是SaaS产品。通过Python实现的核心功能，seo-expert能够自动抓取网页、解析HTML结构，并基于业界通用的SEO最佳实践进行评估。 ## 核心架构与技术栈 seo-expert基于Python 3.9+开发，采用了现代化的异步编程模式。项目的主要技术依赖包括： - **httpx**：用于高效的异步HTTP请求，支持超时控制和重定向跟随 - **PyYAML**：处理配置文件和数据序列化 - **LangChain集成**：可选依赖，支持OpenAI和Anthropic的LLM进行内容质量评估 - **pytest**：完善的测试框架支持项目的代码结构清晰，主要分为四个核心模块： 1. **checks.py**：包含11项SEO检查规则的实现 2. **cli.py**：命令行接口，提供友好的交互方式 3. **reviewer.py**：LLM内容评估模块 4. **__init__.py**：HTML解析器和数据模型定义 ## HTML解析与数据提取 seo-expert内置了一个自定义的HTML解析器`_SeoHtmlParser`，继承自Python标准库的`HTMLParser`。这个解析器专门优化了SEO相关数据的提取能力： ### 元数据提取解析器能够精准提取以下关键SEO元素： - **标题标签**：``内容，用于检查长度是否在推荐的30-60字符范围内 - **Meta描述**：`<meta name="description">`的内容，验证120-160字符的最佳实践 - **Canonical URL**：防止重复内容问题的规范化链接 - **Open Graph标签**：`og:title`、`og:description`、`og:image`，优化社交媒体分享效果 - **Viewport设置**：移动设备适配的元标签检测 - **语言属性**：`<html lang="...">`的语言声明 ### 内容结构分析除了元数据，解析器还深入分析页面内容结构： - **标题层级**：提取所有`<h1>`到`<h6>`标签，检查层级是否连续（如是否出现从h1直接跳到h3的情况） - **图片优化**：扫描所有`<img>`标签，识别缺少`alt`属性的图片，这对可访问性和SEO都至关重要 - **链接分析**：区分内部链接和外部链接，检测空链接或仅包含`#`的无效链接 - **结构化数据**：解析`<script type="application/ld+json">`中的JSON-LD格式结构化数据 ## 11项内置SEO检查 seo-expert的核心价值在于其全面的检查规则。以下是各项检查的详细说明： ### 1. 标题标签检查（check_title）标题是搜索引擎结果页（SERP）中最重要的展示元素。工具会检查： - 标题是否缺失（高危问题） - 标题是否过短（少于20字符，中危） - 标题是否过长（超过70字符，低危，可能被截断） ### 2. Meta描述检查（check_meta_description）虽然Meta描述不直接影响排名，但影响点击率。检查包括： - 描述是否缺失（高危） - 描述是否过短（少于70字符，低危） - 描述是否过长（超过170字符，低危） ### 3. H1标签检查（check_h1） H1标签定义页面主题。工具验证： - H1是否缺失（高危） - 是否存在多个H1（中危，应每页仅一个） - H1内容是否为空（中危） ### 4. 图片Alt属性检查（check_images_alt）图片的Alt文本对视觉障碍用户和搜索引擎理解图片内容都很重要。工具会统计并列出所有缺少Alt属性的图片。 ### 5. Canonical链接检查（check_canonical）规范化URL防止因参数不同而产生的重复内容问题。工具检查是否设置了`<link rel="canonical">`。 ### 6. Open Graph标签检查（check_open_graph） Open Graph协议确保内容在社交媒体分享时呈现良好。工具检查`og:title`、`og:description`和`og:image`是否完整。 ### 7. Viewport元标签检查（check_viewport）移动优先索引时代，viewport设置是移动友好性的基础。工具检查是否包含`<meta name="viewport" content="width=device-width, initial-scale=1">`。 ### 8. 语言属性检查（check_lang_attribute） HTML标签的lang属性帮助搜索引擎识别页面语言，对多语言站点尤为重要。 ### 9. 标题层级检查（check_heading_hierarchy）合理的标题层级（h1→h2→h3）有助于搜索引擎理解内容结构。工具会检测是否出现层级跳跃（如h1直接到h3）。 ### 10. 内部链接检查（check_internal_links）工具会识别href为空或仅为`#`的无效链接，这些会影响爬虫的抓取效率。 ### 11. 结构化数据检查（check_structured_data）检测页面是否包含JSON-LD格式的结构化数据，这有助于获得富媒体搜索结果。 ## LLM智能内容评估除了技术层面的检查，seo-expert还引入了可选的LLM内容评估功能。通过集成LangChain框架，支持调用OpenAI或Anthropic的模型对页面内容进行深度分析： - **内容质量评估**：判断内容是否原创、有价值 - **关键词优化建议**：分析关键词密度和分布 - **可读性分析**：评估文本的阅读难度 - **语义相关性**：检查内容与标题的匹配度这一功能特别适合内容营销团队，能够在技术SEO之外提供内容策略层面的洞察。 ## 使用场景与实践价值 seo-expert适用于多种工作场景： ### 开发阶段集成作为CI/CD流水线的一部分，在部署前自动检查关键页面的SEO合规性，防止问题代码上线。 ### 定期站点审计设置定时任务，对全站进行周期性扫描，及时发现新增或回归的SEO问题。 ### 竞品分析快速评估竞争对手网站的SEO表现，发现其优势和可借鉴之处。 ### SEO培训与知识传递通过具体的检查结果和修复建议，帮助开发团队理解SEO最佳实践。 ## 项目特色与设计理念 seo-expert的设计体现了几个值得关注的理念： 1. **业务无关性**：不假设特定的技术栈或业务场景，纯基于HTML标准进行检查 2. **可扩展性**：模块化的检查函数设计，便于添加新的规则 3. **异步性能**：基于httpx的异步请求，适合大规模站点扫描 4. **类型安全**：使用Python的dataclass和类型注解，提高代码可维护性 5. **LLM集成**：将传统SEO工具与AI能力结合，提供更全面的评估 ## 总结与展望 seo-expert为SEO自动化审计提供了一个轻量且功能完备的开源方案。对于中小型团队而言，它填补了免费工具与昂贵企业级方案之间的空白。随着搜索引擎算法的演进和AI技术的发展，SEO工具也需要持续进化。seo-expert的LLM集成是一个良好的开端，未来可以期待更多AI驱动的功能，如自动生成优化建议、智能内容改写建议等。对于希望提升网站SEO表现的技术团队，seo-expert是一个值得尝试的工具。它不仅能发现问题，更能通过详细的修复建议帮助团队建立SEO意识，最终形成开发流程中的质量保障机制。