🚀 SEO Insight

一款开箱即用的现代化网站 SEO 监测与体检工具，支持 CLI 命令行一键启动，内置交互式 Web 看板，直观呈现全站 SEO 健康度与细节数据。

🌟 核心特性

• ⚡ 开箱即用：零复杂配置，一行命令即刻启动 Web 可视化仪表盘。
• 🔍 全方位 SEO 审计：
  • 基础元数据：Title、Description、Keywords、Canonical 规范标签等。
  • 社交媒体分享卡片：OpenGraph (Facebook/LinkedIn) 及 Twitter Cards 实时预览与验证。
  • 内容与语义结构：Heading 标题层级 (H1-H6) 树形分析、图片 Alt 属性、关键词密度。
  • 技术性 SEO：Robots.txt、Sitemap.xml 探测、Favicon/Manifest、结构化数据 (JSON-LD) 验证。
  • 健康度与死链探测：HTTP 状态码检测、页面重定向链、页面内链/外链状态。
• 📊 可视化 Web 看板：
  • 综合健康度得分与雷达图。
  • 严重等级分类（错误 🔴 / 警告 🟡 / 提示 🟢）。
  • 逐项代码高亮与精准修复建议指南。
  • 社交分享实时模拟预览器。
• 📄 多格式报告导出：支持导出 HTML、JSON、Markdown 等格式。

📦 快速开始

使用 npx 直接运行（推荐）

# 启动 Web 交互界面
npx seo-insight

# 或直接对指定站点执行快速扫描并在浏览器打开
npx seo-insight audit https://example.com --open

全局安装

npm install -g seo-insight
# 或
pnpm add -g seo-insight

# 运行
seo-insight

🛠️ CLI 常用命令

seo-insight [command] [options]

# 启动 Web Dashboard（默认端口 3000）
seo-insight start --port 3000

# 纯命令行模式审计单个页面
seo-insight audit https://example.com

# 深度爬取整个站点
seo-insight crawl https://example.com --depth 2 --max-pages 50

# 导出审计报告
seo-insight audit https://example.com --output ./report.json --format json

📖 规范与文档

本项目遵循 OpenSpec 规范体系：

• 📋 项目总览与产品需求规范
• 🏗️ 系统架构与分层设计规范
• 🧪 SEO 检测规则与评分体系规范
• 🔌 CLI 与 API 接口契约规范
• 🤖 AI 协作与开发指引 (AGENTS.md)

📄 开源许可

MIT License