| name | seo-audit |
| description | Use when auditing SEO with axon map, scrape, search, rendered checks, metadata review, sitemap/site analysis, SERP comparison, or scraped-page findings. |
Axon SEO Audit
Use this to turn a website into a specific, prioritized SEO audit.
Onboarding Interview
Infer the site, target keywords, and output format from context. If the site is clear, proceed immediately.
Ask at most 1-3 concise questions only if blocked, such as the site URL, required target keywords, or whether a specific page/competitor set matters.
Axon Collection Plan
- Run
axon map --json to understand URL structure. Treat this as discovery,
not proof of sitemap health, orphan pages, broken links, canonical tags, or
alt coverage.
- Run targeted
axon scrape --json on homepage, product/service pages,
pricing, docs, blog, about, and high-value landing pages.
- Inspect raw/rendered HTML when metadata, canonical tags, structured data, or
image alt attributes matter. Mark unavailable metadata as "not observed," not
"missing."
- Run
axon endpoints <url> --include-bundles true --capture-network when JavaScript bundles, API endpoints, or rendered network behavior could affect indexing or page health.
- Search target keywords when provided; scrape top ranking pages for comparison.
- Use
axon <url> --scope site --render-mode chrome --automation-script ... --wait true for repeatable rendered capture before escalating to browser/link probing for broken links, console/network failures, or rendered-only SEO evidence.
- Axon has no robots.txt enforcement flag — bound public-site capture with
--max-pages, --max-depth, and --budget PATH=N, and honor the site's terms.
Parallel Work
If appropriate, use sub-agents or equivalent parallel task runners:
- Site Structure: URL patterns, sitemap health, internal linking, orphan/broken pages.
- On-Page SEO: titles, meta descriptions, H1/H2 hierarchy, content quality.
- Keyword And SERP: target keywords, ranking pages, competitor page patterns.
- Technical Issues: broken links, duplicate content signals, missing metadata.
Final Deliverable
# SEO Audit: [Site]
## Executive Summary
[Top risks and opportunities]
## Site Structure
[Pages found, URL quality, sitemap/internal-link notes]
## On-Page SEO
[Per-page title, meta, headings, content, linking notes]
## Keyword Opportunities
[Target keywords, missing pages, content gaps]
## Competitor/SERP Comparison
[Who outranks the site and why]
## Prioritized Recommendations
[High/medium/low impact fixes with exact changes]
## Sources
[URLs scraped and what was checked]
## Rerun Inputs
workflow: seo-audit
site: [url]
keywords: [list]
output: [markdown/json]
Quality Bar
- Make recommendations specific, not generic.
- Show the page or source behind each issue.
- Distinguish technical findings from content strategy guesses.
