Black SEO Analyzer

Black SEO Analyzer

一款功能强大的综合 SEO 分析工具，专为希望确保网站针对搜索引擎和 AI 系统进行优化的 SEO 专业人士和开发者打造。

未提供许可证时，可抓取的页面数量会受到限制，但其他功能均不受限制。如需购买许可证并解锁无限制的分析能力，请访问 Black SEO Analyzer 产品页面。

概述

Black SEO Analyzer 是一款功能强大的工具，可让您的网站在传统搜索结果和 AI 生成的回答中都保持可见。良好的技术 SEO 不只是提升 Google 排名，还要确保 AI 系统能在用户询问有关您的信息时找到并理解您的内容。

正确优化网站结构和元数据后，您的网站便能出现在搜索结果和 AI 对话中。Black SEO Analyzer 直击要点，准确指出阻碍网站发展的因素——不说企业套话，只提供可执行的数据，让您在用户询问 AI 您具体销售什么时不被落下。

真正拥有，而非订阅

与停止付费后就无法继续使用的订阅制工具不同，Black SEO Analyzer 提供真正的软件所有权。若我们停止该产品，您的购买还包含具有法律约束力的源代码访问保障，永久保护您的投资。

Black SEO Analyzer 许可证：一次性购买

• 永久拥有软件
• 所有未来更新
• 高效的命令行操作
• 源代码托管保障
• URL 和网站数量不限
• 包含所有高级功能

安装

请阅读 INSTALL.md 文件，了解安装说明。

Windows 用法

A comprehensive SEO analysis tool

Usage: black-seo-analyzer.exe [OPTIONS]

Options:
      --url-to-begin-crawl <URL_TO_BEGIN_CRAWL>
          URL of the sitemap to analyze
      --log-file <LOG_FILE>
          Path to log file
      --output-type <OUTPUT_TYPE>
          Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files]
      --concurrent-requests <CONCURRENT_REQUESTS>
          Optional Number of concurrent requests to make [default: 20]
      --rate-limit <RATE_LIMIT>
          Optional Rate limit in milliseconds [default: 50]
      --output-file <OUTPUT_FILE>
          Optional argument to specify the output file
      --spa
          Optional flag to indicate if the site is a Single-Page Application (SPA)
      --is-sitemap
          Optional flag to indicate if the initial page is a sitemap.xml
      --disable-external-links
          Optional flag to disable external link checking
      --locale <LOCALE>
          Optional locale for internationalization [default: en]
      --use-anthropic-analyzer
          Optional flag to enable Anthropic Claude API for SEO analysis
      --anthropic-api-key <ANTHROPIC_API_KEY>
          Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable)
      --anthropic-model <ANTHROPIC_MODEL>
          Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307]
      --anthropic-prompt-file <ANTHROPIC_PROMPT_FILE>
          Optional path to a file containing a custom Anthropic prompt
      --use-deepseek-analyzer
          Optional flag to enable DeepSeek API for SEO analysis
      --deepseek-api-key <DEEPSEEK_API_KEY>
          Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable)
      --deepseek-model <DEEPSEEK_MODEL>
          Optional DeepSeek model to use for analysis [default: deepseek-chat]
      --deepseek-prompt-file <DEEPSEEK_PROMPT_FILE>
          Optional path to a file containing a custom DeepSeek prompt
      --use-openai-analyzer
          Optional flag to enable OpenAI API for SEO analysis
      --openai-api-key <OPENAI_API_KEY>
          Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable)
      --openai-model <OPENAI_MODEL>
          Optional OpenAI model to use for analysis [default: gpt-4o]
      --openai-prompt-file <OPENAI_PROMPT_FILE>
          Optional path to a file containing a custom OpenAI prompt
      --use-gemini-analyzer
          Optional flag to enable Google Gemini API for SEO analysis
      --gemini-api-key <GEMINI_API_KEY>
          Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable)
      --gemini-model <GEMINI_MODEL>
          Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest]
      --gemini-prompt-file <GEMINI_PROMPT_FILE>
          Optional path to a file containing a custom Google Gemini prompt
      --user-agent <USER_AGENT>
          Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v25.6.61905"]
      --max-pages <MAX_PAGES>
          Optional maximum number of pages to crawl
      --html-templates-dir <HTML_TEMPLATES_DIR>
          Directory holding replacements for the built-in HTML report templates
  -h, --help
          Print help
  -V, --version
          Print version

Windows 用法示例

单个网站的基本 JSON 输出

black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type json --output-file example-report.json

带站点地图的网站

black-seo-analyzer.exe --url-to-begin-crawl https://example.com/sitemap.xml --is-sitemap --output-type json --output-file sitemap-report.json

单页应用

black-seo-analyzer.exe --url-to-begin-crawl https://spa-example.com --spa --output-type json --output-file spa-report.json

HTML 文件夹输出

black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type html-folder --output-file ./seo-reports

Linux/MacOS 用法

A comprehensive SEO analysis tool

Usage: black-seo-analyzer [OPTIONS]

Options:
      --url-to-begin-crawl <URL_TO_BEGIN_CRAWL>
          URL of the sitemap to analyze
      --log-file <LOG_FILE>
          Path to log file
      --output-type <OUTPUT_TYPE>
          Output format type [default: html-folder] [possible values: json, jsonl, xml, csv, csv-flat, html-folder, json-files]
      --concurrent-requests <CONCURRENT_REQUESTS>
          Optional Number of concurrent requests to make [default: 20]
      --rate-limit <RATE_LIMIT>
          Optional Rate limit in milliseconds [default: 50]
      --output-file <OUTPUT_FILE>
          Optional argument to specify the output file
      --spa
          Optional flag to indicate if the site is a Single-Page Application (SPA)
      --is-sitemap
          Optional flag to indicate if the initial page is a sitemap.xml
      --disable-external-links
          Optional flag to disable external link checking
      --locale <LOCALE>
          Optional locale for internationalization [default: en]
      --use-anthropic-analyzer
          Optional flag to enable Anthropic Claude API for SEO analysis
      --anthropic-api-key <ANTHROPIC_API_KEY>
          Optional Anthropic API key (can also be set via ANTHROPIC_API_KEY environment variable)
      --anthropic-model <ANTHROPIC_MODEL>
          Optional Anthropic model to use for analysis [default: claude-3-haiku-20240307]
      --anthropic-prompt-file <ANTHROPIC_PROMPT_FILE>
          Optional path to a file containing a custom Anthropic prompt
      --use-deepseek-analyzer
          Optional flag to enable DeepSeek API for SEO analysis
      --deepseek-api-key <DEEPSEEK_API_KEY>
          Optional DeepSeek API key (can also be set via DEEPSEEK_API_KEY environment variable)
      --deepseek-model <DEEPSEEK_MODEL>
          Optional DeepSeek model to use for analysis [default: deepseek-chat]
      --deepseek-prompt-file <DEEPSEEK_PROMPT_FILE>
          Optional path to a file containing a custom DeepSeek prompt
      --use-openai-analyzer
          Optional flag to enable OpenAI API for SEO analysis
      --openai-api-key <OPENAI_API_KEY>
          Optional OpenAI API key (can also be set via OPENAI_API_KEY environment variable)
      --openai-model <OPENAI_MODEL>
          Optional OpenAI model to use for analysis [default: gpt-4o]
      --openai-prompt-file <OPENAI_PROMPT_FILE>
          Optional path to a file containing a custom OpenAI prompt
      --use-gemini-analyzer
          Optional flag to enable Google Gemini API for SEO analysis
      --gemini-api-key <GEMINI_API_KEY>
          Optional Google Gemini API key (can also be set via GEMINI_API_KEY environment variable)
      --gemini-model <GEMINI_MODEL>
          Optional Google Gemini model to use for analysis [default: gemini-1.5-flash-latest]
      --gemini-prompt-file <GEMINI_PROMPT_FILE>
          Optional path to a file containing a custom Google Gemini prompt
      --user-agent <USER_AGENT>
          Optional User-Agent string for HTTP requests [default: "black-seo-analyzer v2025.1.100001"]
      --max-pages <MAX_PAGES>
          Optional maximum number of pages to crawl
      --html-templates-dir <HTML_TEMPLATES_DIR>
          Directory holding replacements for the built-in HTML report templates
  -h, --help
          Print help
  -V, --version
          Print version

Linux/MacOS 用法示例

注意：

• 如果二进制文件不可执行，您可能需要先运行 chmod +x ./black-seo-analyzer。
• 以下示例假设二进制文件位于当前目录。如果它位于其他目录，您需要提供二进制文件的完整路径；如果它位于 PATH 中，则可直接运行 black-seo-analyzer。

单个网站的基本 JSON 输出

./black-seo-analyzer --url-to-begin-crawl https://example.com --output-type json --output-file example-report.json

带站点地图的网站

./black-seo-analyzer.exe --url-to-begin-crawl https://example.com/sitemap.xml --is-sitemap --output-type json --output-file sitemap-report.json

单页应用

./black-seo-analyzer.exe --url-to-begin-crawl https://spa-example.com --spa --output-type json --output-file spa-report.json

HTML 文件夹输出

./black-seo-analyzer.exe --url-to-begin-crawl https://example.com --output-type html-folder --output-file ./seo-reports

完整功能列表

核心功能

• 命令行界面
• 图形用户界面
• 从指定 URL 开始抓取网站
• 使用站点地图抓取网站
• 支持静态网站（HTTP 请求）和通过无头浏览器运行的单页应用（SPA）
• 可配置并发请求上限
• 可配置页面数量上限
• 详细的日志系统
• 可配置日志文件位置

抓取能力

• 基于 HTTP 请求的爬虫
• 基于无头浏览器的爬虫
• 自动检测并提取链接、脚本、样式表和图像
• 站点地图解析与处理
• 用于抓取和分析的异步处理
• 内容哈希生成（SHA1），用于检测重复内容
• 可配置抓取延迟
• 遵循 robots.txt
• 用户代理自定义
• 域名提取工具

SEO 分析模块

• 内容分析
  • 字数统计
  • 关键词密度分析
  • 可读性分析（Flesch-Kincaid 分数、音节计数）
  • 重复内容检测
  • 标题结构分析（H1、H2 等）
  • 提取其他标签（<strong>、<em> 等）中的内容
• 元数据分析
  • 提取并验证标题标签
  • 提取并验证元描述
  • 提取元关键词
  • 验证视口元标签
  • 验证 robots 元标签
  • 验证规范 URL
  • 提取并分析 OpenGraph 数据（og:title、og:description、og:image 等）
  • 提取并分析 Twitter Card 数据（twitter:card、twitter:title 等）
• URL 结构分析
  • 验证协议（优先使用 HTTPS）
  • 分析路径（长度、字符使用情况、是否包含关键词）
  • 分析查询参数（识别参数及潜在问题）
  • 分析片段标识符
  • 验证 URL 长度
  • 检测常见 URL 模式（例如文件扩展名）
• 链接分析
  • 识别内部和外部链接
  • 分析锚文本（长度、描述性）
  • 异步检查链接状态（失效链接）
  • 异步检查重定向
  • 异步检查链接指向的大型文件
  • 分析链接属性（nofollow、target）
  • 规范化并分类 URL（内部/外部）
• 图像分析
  • 分析 alt 标签是否存在及其内容
  • 分析图像尺寸
  • 考虑文件大小
• 移动设备友好度评估
  • 分析视口元标签
  • 分析触控目标尺寸及间距
  • 分析响应式图像（srcset、sizes 属性）
  • 分析字体大小（移动设备上的可读性）
  • 分析媒体查询（断点覆盖范围）
• 性能分析
  • 分析资源加载情况（脚本、样式表、图像、字体）
  • 分析脚本加载方式（async、defer）
  • 分析样式表加载情况
  • 分析图像加载情况（loading="lazy"）
  • 分析字体加载情况（font-display）
  • 分析关键渲染路径
  • 分析资源提示（preload、prefetch、preconnect）
  • 分析缓存标头（Cache-Control、Expires）
  • 检测缓存破坏技术
  • 分析压缩情况（Content-Encoding）
  • 识别关键资源
  • 检测首屏内容的启发式方法
  • 记录 TTFB 和总加载时间
  • 从浏览器/标头中提取性能指标
• 安全分析
  • 检查 HTTPS 使用情况
  • 检测混合内容
  • 分析内容安全策略（CSP）标头
  • 分析表单安全性（敏感字段的 autocomplete 设置）
  • 分析外部资源完整性（SRI 检查）
  • 检查 SSL 证书有效期
• 结构化数据/Schema 标记验证
  • 提取并验证 JSON-LD
  • 提取并验证 Microdata
  • 提取并验证 RDFa
  • 根据已知类型验证 Schema 属性
  • 检测已弃用的 Schema 属性
• Web Vitals 指标分析
  • 分析与最大内容绘制（LCP）相关的情况
  • 分析与首次输入延迟（FID）/下一次绘制交互（INP）先行指标相关的情况
  • 分析与累积布局偏移（CLS）相关的情况
  • 分析与首次内容绘制（FCP）相关的情况
  • 分析与可交互时间（TTI）相关的情况
  • 分析与总阻塞时间（TBT）相关的情况
  • 识别阻塞资源、长任务和主线程工作
  • 分析图像尺寸、动态内容和字体加载的影响
  • 计算总体优化评分
  • 根据指标生成具体建议
• CSS 分析
  • 识别外部样式和内联样式
  • 分析样式表内容（潜在问题、复杂度）
  • 分析媒体查询（与响应式设计相关）
  • 执行基本的 CSS 相关无障碍检查
  • 执行基本的 CSS 相关性能检查
  • 检测可能重复的 CSS 规则
• JavaScript 分析
  • 识别外部脚本和内联脚本
  • 分析脚本属性（async、defer）
  • 分析脚本加载模式
  • 执行基本安全检查
  • 分析内联脚本内容的复杂度
  • 分析事件处理程序
  • 识别第三方脚本
  • 基本检查已弃用的 JS API
• 国际化分析
  • 分析语言声明（lang 属性）
  • 分析 hreflang 实现情况
  • 分析字符编码（优先使用 UTF-8）
  • 分析文本方向（dir 属性）
  • 基本检查特定区域设置的格式问题
  • 基本检查翻译完整性的启发式方法
  • 基本检查时区处理的启发式方法
• AI/LLM 分析
  • 集成 Anthropic API（需要 API 密钥）
  • 能够根据预定义提示词将页面内容（或部分内容）发送给 LLM 进行分析
  • AI 驱动的内容建议
  • 自动生成元描述
  • 标题标签优化建议
  • 标题结构建议
  • 内容扩展建议
  • 生成执行摘要

输出格式

• JSON 输出格式
• JSONL（JSON Lines）输出格式
• XML 输出格式
• CSV 输出格式
• HTML 报告格式
• 每个页面单独生成 JSON 文件
• 输出包含索引和单页报告的 HTML 文件夹

报告功能

• 各分析器生成的详细警告和建议
• 收集页面级元数据
• 收集页面内容详情（标题等）
• 收集页面资源（链接、脚本、样式、图像）
• 收集 Web Vitals 分析结果
• 性能指标报告（TTFB、加载时间）
• 基于模板生成 HTML 报告

国际化

• 支持多种语言的界面文本和报告标签
• 内置翻译（英语、西班牙语、中文）
• 可扩展的翻译系统
• 针对特定建议使用的语言区域设置

许可系统

• 功能受限的试用模式
• 功能完整的授权模式
• 许可证验证系统
• 不同的许可证等级会影响功能

技术详情

• 使用 Rust 和 C++ 构建
• 异步架构
• HTML 解析和 DOM 操作
• 集成无头 Chrome
• HTTP 客户端
• 序列化／反序列化
• 自定义 URL 序列化包装器
• 用于从 URL 创建安全文件名的工具
• 命令行参数解析
• 用于生成 HTML 报告的模板引擎

常见问题

Black SEO Analyzer 与其他 SEO 工具有何不同？
与采用浏览器界面和订阅模式的传统 SEO 工具不同，Black SEO Analyzer 可直接集成到您的开发工作流中。这种方式支持其他工具无法实现的自动化功能，而且您只需一次性购买，即可真正拥有该软件。

源代码保障如何运作？
购买后，您将获得一项具有法律约束力的承诺：如果我们停止产品、停止运营，或连续 12 个月以上未能提供更新，您将获得完整源代码。无论我们公司未来如何，这都能确保您可以无限期地继续使用该软件。

Black SEO Analyzer 可以抓取 JavaScript 密集型网站吗？
可以，我们集成的无头浏览器技术支持完整的 JavaScript 渲染功能。这确保了对使用 React、Angular、Vue.js 和其他 JavaScript 框架构建的现代 Web 应用进行准确分析。

如何获取更新？
我们会通过 GitHub 仓库提供更新，您可以随时下载。今后的所有更新均无需额外付费。永久拥有。