seo-llm-website-checker: One-stop Website SEO and LLM Readiness Detection Tool

A single-file Python CLI tool that performs about 30 checks on websites, covering both traditional SEO optimization and new requirements of the LLM era. It can quickly assess website health without needing a browser.

With the popularity of large language models like ChatGPT and Claude, the way users access information is undergoing profound changes. Traditional search engine optimization (SEO) remains important, but websites also need to consider LLM-readiness—whether large models can effectively understand, cite, and recommend your website content.

The seo-llm-website-checker open-sourced by developer x2q is a practical tool addressing this dual need. It is a single-file Python CLI program that does not rely on complex browser environments; it can perform about 30 in-depth checks on target websites using only HTTP requests and HTML parsing.

The tool's design embodies several noteworthy ideas:

Single-file Architecture: The entire functionality is encapsulated in one Python file, making it easy to deploy and integrate into CI/CD workflows. No complex dependency stacks are required—only the common libraries requests and beautifulsoup4 are needed to run.

Headless Browser-free: Unlike many modern auditing tools that require heavy solutions like Selenium or Puppeteer, this tool坚持 lightweight HTTP checks. This means faster execution speed and lower resource consumption, especially suitable for batch checks or scheduled task scenarios.

Dual Focus Dimensions: The tool clearly distinguishes between traditional SEO checks and emerging LLM readiness checks, helping website owners meet the needs of both search engines and AI systems simultaneously.

The tool covers key aspects of website technical optimization in the SEO dimension:

• HTTPS Enforcement: Check if HTTP automatically redirects to HTTPS and HSTS security header configuration
• Domain Normalization: Verify whether the redirection direction between www and the naked domain is consistent with the canonical tag
• robots.txt Compliance: Check if the file is accessible, formatted correctly, and includes a Sitemap declaration

• Title and Description: Verify if the <title> length (15-65 characters) and meta description (50-160 characters) meet search engine recommended standards
• Canonical Tag: Ensure the use of an absolute HTTPS URL that matches the current page URL
• Semantic Markup: Check for a single H1 tag, html lang attribute, and viewport meta tag
• Image Optimization: Verify if all img tags include alt attributes and if width/height are declared to prevent layout shifts

• Open Graph Protocol: Check the completeness of tags like og:title, og:description, and og:image
• Twitter Cards: Prioritize support for the summary_large_image type
• JSON-LD Structured Data: Parse and verify if it contains practical types like Organization, WebSite, and LocalBusiness
• hreflang Internationalization: Check the reciprocity of language tags and x-default declaration

• sitemap.xml Validation: Check XML validity, URL encoding standards, and existence of lastmod
• Internal Link Sampling: Randomly sample internal links to verify accessibility