# Chrome Seo Analyzer

**Repository Path**: EricGuosx/chrome-seo-analyzer

## Basic Information

- **Project Name**: Chrome Seo Analyzer
- **Description**: 一个功能强大的 Chrome 浏览器扩展，用于实时 SEO（搜索引擎优化）分析、网站健康度检测和页面审计。一键扫描即可获取关键指标，帮助开发者和营销人员优化网站排名。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SEO, APP

## README

# SEO Analyzer Chrome 插件

<div align="center">
  <img src="images/logo/128-128.png" alt="SEO Analyzer Logo" width="128" height="128">
</div>

一个基于 Google 官方 SEO 指南的 Chrome 浏览器插件，用于分析当前页面的 SEO 状况，提供结构化的检测结果与优化建议。

## 功能特性

- 📊 **实时 SEO 分析**：分析当前页面的 SEO 状况，包括页面基础信息、技术 SEO、语义化结构、内容质量和链接分析
- ⭐ **Lighthouse 风格 UI**：直观的评分系统和美观的界面设计
- 🔍 **详细检测项**：基于 Google 官方 SEO 指南的全面检测
- 📈 **智能评分**：采用类似 Ahrefs/Screaming Frog 的评分算法
- 📋 **报告导出**：支持导出 JSON 和 HTML 格式的分析报告
- 📄 **报告复制**：一键复制分析报告到剪贴板
- 🔧 **可配置规则**：通过 rules.js 文件自定义检测规则

## 技术架构

- **Manifest V3**：使用 Chrome 扩展最新的 Manifest V3 标准
- **原生 JavaScript**：纯原生 JS 实现，无外部依赖
- **Web APIs**：使用 DOM API、Fetch API、Performance API 等原生 Web API
- **Chrome Extension APIs**：使用 tabs、scripting、storage 等 Chrome 扩展 API
- **规则引擎**：可配置的 SEO 检测规则引擎

## 安装方法

1. 克隆或下载本项目到本地
2. 打开 Chrome 浏览器，进入 `chrome://extensions/`
3. 开启右上角的「开发者模式」
4. 点击「加载已解压的扩展程序」，选择本项目目录
5. 插件会自动加载到浏览器中

## 使用方法

1. 在 Chrome 浏览器中打开任意网页
2. 点击浏览器右上角的 SEO Analyzer 插件图标
3. 在弹出的面板中点击「开始分析」按钮
4. 等待分析完成后，查看详细的 SEO 评分和检测结果
5. 可以使用「复制报告」、「导出 JSON」或「导出 HTML」按钮保存分析结果

## 检测项说明

### 1. 页面基础信息
- 页面标题（长度、相关性）
- 页面描述（长度、相关性）
- Robots 元标签
- Canonical 链接
- Hreflang 标签

### 2. 技术 SEO
- 页面加载速度（DOMContentLoaded 时间）
- 移动友好性（viewport meta 标签）
- 页面可索引性
- CLS 风险（布局偏移风险）

### 3. 语义化结构
- H1 标签使用
- 标题层级结构
- 语义化标签使用
- Div 滥用检测

### 4. 内容质量
- 内容长度
- 关键词使用
- 内容可读性

### 5. 链接分析
- 内部链接数量
- 外部链接数量
- 链接质量（无效链接检测）
- Rel 属性使用

## 评分标准

- **优秀**：90-100 分
- **良好**：75-89 分
- **一般**：60-74 分
- **较差**：40-59 分
- **极差**：0-39 分

## 项目结构

```
chrome-seo-analyzer/
├── manifest.json          # 插件配置文件
├── content-script.js      # 核心 SEO 检测逻辑
├── rules.js               # 可配置规则引擎
├── popup.html             # 弹出窗口 HTML
├── popup.css              # 弹出窗口样式
├── popup.js               # 弹出窗口交互逻辑
├── README.md              # 项目说明文档
├── SEO_GUIDELINE_CORRESPONDENCE.md  # SEO 指南对应关系
└── scoring-algorithm.md   # 评分算法说明
```

## 自定义规则

可以通过修改 `rules.js` 文件来自定义 SEO 检测规则：

- 调整类别权重
- 修改检测项的测试逻辑
- 添加新的检测项
- 调整评分标准

## 浏览器兼容性

- Chrome 88+（支持 Manifest V3）

## 开发指南

1. 克隆项目到本地
2. 按照「安装方法」加载扩展
3. 修改代码后，在 `chrome://extensions/` 页面点击「刷新」按钮更新扩展
4. 在控制台查看调试信息

## 基于 Google 官方 SEO 指南

本插件的检测规则基于 Google 官方 SEO 指南，确保分析结果与 Google 的要求保持一致。详细的对应关系请参考 `SEO_GUIDELINE_CORRESPONDENCE.md` 文件。

## 评分算法

评分算法采用类似 Ahrefs/Screaming Frog 的设计，综合考虑多个 SEO 因素，详细说明请参考 `scoring-algorithm.md` 文件。

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个插件！

## 许可证

MIT License

## 作者信息

- **作者**：Eric.Guo
- **邮箱**：18337177020@163.com

## 更新日志

### v1.2.0
- 添加插件 Logo 图标
- 优化表格显示，解决链接质量表格展示不全问题
- 改进 CLS 风险表格，添加图片预览功能
- 增强表格样式，支持悬停显示完整内容
- 优化导出 HTML 报告的表格布局

### v1.1.0
- 增强错误 DOM 元素的检测和展示
- 添加作者信息

### v1.0.0
- 初始版本发布
- 实现基本 SEO 分析功能
- 添加 Lighthouse 风格 UI
- 支持导出 JSON 和 HTML 报告
- 集成可配置规则引擎