seo-audit

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #machine-learning #deep-learning #linux #docker #nodejs #macos #cli #ios #mcp #openai #open-source

(★ 25)

SEO Audit Skill is an AI-powered SEO auditing tool based on Google Search guidelines and the Ahrefs SEO checklist. Runs in any skill-enabled CLI (Claude Code recommended). Covers 92 checks with results comparable to paid tools—using minimal tokens.

seo-audit Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SEO Audit Skill

> Evidence-based SEO diagnostic skill built from Google Search Central, Ahrefs SEO checklist, and Microsoft's AEO/GEO guidance.

[English](README.md) | [简体中文](README.zh-CN.md)

Reference sources:
- [Google Search Central](https://developers.google.com/search/docs)
- [Ahrefs SEO + AI Search Checklist](https://ahrefs.com/blog/seo-ai-search-checklist/)
- [Microsoft AEO & GEO Guide](https://about.ads.microsoft.com/content/dam/sites/msa-about/global/common/content-lib/pdf/from-discovery-to-influence-a-guide-to-aeo-and-geo.pdf)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-1.4.1-blue.svg)]()

## What's New in v1.4.1

- Classification upgraded to `Title + URL + Nav`
- Top-2 site-type output + confidence score (with medium/low confidence handling)
- Non-blocking low-confidence confirmation strategy (default continue)
- Article-page secondary discovery (`/insights`, `/docs`) added on top of primary content paths
- Report appendix now includes explainability fields (Top-1/Top-2, confidence, signals, fallback path)

## Quick Mode Selector

The skill supports an intelligent interaction flow and can run in two modes:

| Capability | Full Mode (Recommended) | Basic Mode |
|------|--------------------------|------------|
| Setup complexity | Requires API key | Zero setup |
| Checklist size | 92 checks | 84 checks |
| Core Web Vitals | Yes (LCP, FCP, CLS, INP) | Skipped |
| PageSpeed score | Yes (Mobile + Desktop) | Skipped |
| Best use case | Complete SEO audit | Fast content and structure review |
| Free quota | 25,000 requests/day | N/A |

Detailed guide: [USAGE.md](USAGE.md)

## Why This Skill Exists

Traditional SEO tools often require account setup, paid subscriptions, and heavy workflows. This skill keeps the audit process lightweight and transparent.

### Value

1. No lock-in: run directly in Claude Code, no external dashboard required.
2. Practical: one command starts a full or basic audit.
3. Transparent: checklist logic is open and based on public guidance.
4. Evolving: includes report export, and continues to improve with each release.

## Quick Start

### Install

Copy `SKILL.md` and `references/` into your Claude Code skills directory:

```bash
git clone https://github.com/wonfull888/seo-audit.git
cp -r seo-audit ~/.claude/skills/
```

### Run

```bash
# Auto-detect report language (recommended)
/seo-audit https://example.com

# Force English report
/seo-audit https://example.com --en

# Force Chinese report
/seo-audit https://example.com --zh
```

Language selection priority:
1. Explicit flag: `--en` / `--zh`
2. Auto-detection from user input language
3. Default fallback: English

### Configure PageSpeed API Key (Recommended)

Google PageSpeed Insights API includes a free quota of 25,000 requests/day.

```bash
export PAGE_SPEED_API_KEY="your_api_key_here"
```

If environment variable is missing, the skill will auto-try:
1. `./.env`
2. `~/.claude/skills/seo-audit/.env`

More details:
- [API_KEY_SETUP.md](API_KEY_SETUP.md)
- [QUOTA.md](QUOTA.md)

## Audit Workflow

```text
User provides URL
    -> 1. Check environment (API key)
    -> 2. Detect report language
    -> 3. Classify site type (Title + URL)
    -> 4. Select representative pages (home + key business + article)
    -> 5. Collect data (curl + WebFetch + optional PageSpeed API)
    -> 6. Analyze 4 dimensions (92 checks)
    -> 7. Generate and save full Markdown report
```

## Checklist Overview

| Dimension | Checks | Weight | Notes |
|------|------|------|------|
| Technical SEO | 29 | 32% | Crawlability, indexing, security, CWV |
| On-Page SEO | 27 | 29% | Title, metadata, structure, AI-search readiness |
| Content Quality & E-E-A-T | 33 | 36% | Content depth, trust, expertise, authority |
| Local SEO | 3 | 3% | LocalBusiness schema, map signals, NAP |
| **Total** | **92** | **100%** | |

## Scoring Scale

| Grade | Score | Status |
|------|------|------|
| A | 90-100 | Excellent |
| B | 80-89 | Good |
| C | 70-79 | Average |
| D | 60-69 | Weak |
| F | <60 | Poor |

## Reports

- Default example report (English): [assets/example-report.en.md](assets/example-report.en.md)
- Chinese example report: [assets/example-report.md](assets/example-report.md)

Every report includes:
- Executive Summary at the beginning
- Site type and crawled URLs
- Overall and dimension scores
- P0/P1/P2 action items
- Full 92-row checklist table
- Actionable recommendations
- Standard brand footer

Default report save path:
- `~/.claude/skills/seo-audit/reports/seo-audit-report-{domain}-{timestamp}.md`

## File Structure

## License

[MIT License](LICENSE)

## Acknowledgements

- Google Search Central
- Ahrefs SEO team
- Microsoft Ads and Search guidance team

---

**SEO Audit Skill** | [GitHub](https://github.com/wonfull888/seo-audit) | Developer: [x.com/wonfull888](https://x.com/wonfull888)

seo-audit

seo-audit Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

seo-audit

seo-audit Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README