SEO Audit Report

Run comprehensive SEO audits on any website and generate actionable reports. Use when the user asks to audit a website's SEO, check technical SEO issues, ana...

Security Scan

The skill's code, instructions, and requirements align with an SEO auditing tool: it crawls target URLs, analyzes on-page and technical SEO, and writes reports locally; it does not request unrelated credentials or install external code.

Purpose & Capability

Name/description match the contained script and checklist. The included Python crawler/parser and scoring functions are exactly what you'd expect for an SEO audit tool; no unrelated cloud credentials, binaries, or config paths are requested.

Instruction Scope

SKILL.md directs running scripts/seo_audit.py with URL arguments and saving reports to local files. The runtime instructions stay within the audit purpose. Note: the script performs HTTP requests and recursive crawling (depth option), which means it can scan any reachable URL you provide — avoid pointing it at private/internal endpoints unless you intend to.

Install Mechanism

No install spec; this is instruction-only plus a Python script that relies on stdlib only. Nothing is downloaded from third-party URLs or added to disk by an installer beyond the provided script.

Credentials

The skill requests no environment variables or credentials. The code uses only standard HTTP requests to target sites and does not reference other env vars or secret names.

Persistence & Privilege

always is false and the skill does not request elevated/system-wide persistence. It's an on-demand, user-invoked tool that writes reports locally per SKILL.md commands.

Assessment

This skill appears coherent and implements a local SEO crawler and reporter. Before installing, remember: (1) it will make HTTP requests to any URL you give it and can crawl multiple pages — do not audit private/internal sites unless you want that traffic generated; (2) review the remainder of the script if you require absolute assurance there is no hidden telemetry (the provided code shows only stdlib network calls and local report generation); (3) run it in a sandbox or isolated environment if you are uncertain about network access or want to limit outbound requests.

Run full SEO audits from your agent and get actionable, scored reports.

Quick Start

python3 scripts/seo_audit.py --url https://example.com

Commands

Full Audit

python3 scripts/seo_audit.py --url https://example.com --depth 3

Crawls up to --depth pages from the starting URL.

Quick Check (single page)

python3 scripts/seo_audit.py --url https://example.com/page --quick

Generate Report

python3 scripts/seo_audit.py --url https://example.com --output report.md

What Gets Audited

Technical SEO

• HTTPS enforcement and redirect chains
• Robots.txt presence and configuration
• Sitemap.xml detection and validation
• Canonical tag usage
• Mobile viewport meta tag
• Page load indicators (response time, content size)
• HTTP status codes across crawled pages

On-Page SEO

• Title tag (presence, length, keyword usage)
• Meta description (presence, length, uniqueness)
• Heading hierarchy (H1-H6 structure)
• Image alt text coverage
• Internal/external link ratio
• Content length analysis
• Open Graph and Twitter Card tags

Content Quality Signals

• Word count per page
• Heading-to-content ratio
• Duplicate title/description detection
• Thin content pages (<300 words)

Link Health

• Broken internal links (4xx/5xx)
• Orphan pages (no internal links pointing to them)
• External link count and diversity

Scoring

Each audit category is scored 0-100:

Score	Rating	Meaning
90-100	Excellent	No significant issues
70-89	Good	Minor improvements possible
50-69	Fair	Notable issues to address
0-49	Poor	Critical issues found

Overall score is a weighted average:

• Technical: 35%
• On-Page: 35%
• Content: 15%
• Links: 15%

Report Format

Reports are markdown with:

• Executive summary with overall score
• Category breakdowns with individual scores
• Prioritized issue list (Critical → Low)
• Specific fix recommendations per issue
• Comparison benchmarks

Advanced

See references/seo-checklist.md for the complete 50+ point checklist used in audits.