# Site Auditor

> Audit website SEO, links, and accessibility using CF Browser Rendering

- Skill: `claude-world/site-auditor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claude-world/site-auditor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claude-world/site-auditor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: claude-world (https://skillmd.com/u/claude-world)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/claude-world/site-auditor

---


# Site Auditor

Comprehensive website audit for SEO, broken links, and accessibility.

## Prerequisites

CF Browser MCP server must be configured in `.mcp.json` (see [quick start](../../README.md#quick-start)).

## Workflow

### Step 1: Crawl Site

```
browser_crawl(url, limit=50)
→ browser_crawl_status(job_id, wait=True)
→ Get list of all discovered pages
```

### Step 2: Quick Analysis from Crawl Data

The crawl results already include per-page `metadata` with title, OG tags, and HTTP status.
Parse these first — this covers 80% of SEO checks with zero extra API calls:
- `metadata.title` → check for missing/duplicate titles
- `metadata.og:title`, `og:description`, `og:image` → check OG completeness
- `metadata.status` → identify 4xx/5xx error pages
- `metadata.url` → detect redirect chains (final URL != original)

### Step 3: Deep Scrape (only pages with issues)

For pages where crawl metadata is insufficient, use `browser_scrape` to extract:
- `h1`, `h2`, `h3` headings (hierarchy check)
- `img` tags (check alt attributes)
- `link[rel="canonical"]` canonical URL
- `meta[name="robots"]` directives
- `meta[name="description"]` (if not in crawl metadata)

Batch scrape in groups of 5 to respect rate limits.

### Step 4: Check Links

Using `browser_links` on 3-5 key pages (homepage, major sections):
- Categorize: internal, external, resource
- Cross-reference with crawl results to find orphan pages
- Identify links pointing to 4xx/5xx pages found in Step 2

### Step 5: Generate Report

Output a markdown report with sections:

#### SEO Issues
- Missing or duplicate `<title>` tags
- Missing or duplicate meta descriptions
- Missing h1 or multiple h1 tags
- Missing canonical URLs
- Missing OpenGraph tags

#### Link Health
- Broken internal links (404s)
- Broken external links
- Redirect chains (>2 hops)
- Orphan pages

#### Accessibility
- Images without alt text
- Missing form labels
- Missing lang attribute

#### Structure
- Sitemap coverage
- Page depth analysis
- URL structure issues

Each issue includes:
- **Severity**: Critical / Warning / Info
- **Page**: URL where issue was found
- **Fix**: Specific action to take

## Output

Markdown report saved to `audit-report-{domain}-{date}.md` in the current directory.

## Examples

```
"Audit my website for SEO issues"
→ Crawl + analyze + generate full report

"Check for broken links on docs.example.com"
→ Crawl + link check only

"Review OpenGraph tags across the site"
→ Crawl + extract OG tags + report missing ones
```