Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-audit

saas-seo-audit

Unverified

Run full-site SaaS SEO audit across crawlability, metadata, schema, CWV, and E-E-A-T.

Running this workflow on this client

Run commands from the project root (use Git Bash on Windows if bash points to an unavailable WSL distro). Shared studio files live in .claude/; follow .agents/PORTABLE-RUNTIME.md and .claude/docs/config-resolution.md for client tools, delegation, and approval rules.

Run bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation and use its output below.

Resolved above — use as-is; --review overrides review_mode for this run.

SaaS Platform Full SEO Audit

Locale & User Profile: Match locale (pt-BR → natural Brazilian Portuguese questions/options, overriding English examples; en → English) and user_profile (founder → plain business language with (Recomendado) first, zero tech jargon; developer → technical). Keep code/tests in English.

Conducts an end-to-end, multi-vector SEO audit of a SaaS web application or staging server (http://localhost:3000).


1. Audit Pipeline

  1. URL Validation & Security Pre-Flight:

    • Check target URL with python scripts/seo/url_safety.py. Ensure SSRF protection and DNS pinning are engaged.
    • If auditing local development environments, set CLAUDE_SEO_LOCAL_TARGETS=localhost:3000.
  2. Technical & Crawlability Evaluation:

    • Fetch and parse target URL using python scripts/seo/parse_html.py <url> --json.
    • Verify robots.txt and XML sitemaps using python scripts/seo/sitemap_discovery.py <url> --json.
    • Check for Googlebot 2MB fetch cap violations (oversized inline CSS/JS or base64 images).
  3. Schema.org Structured Data Audit:

    • Check JSON-LD blocks for SaaS entities: SoftwareApplication, Organization, WebSite, Product, Offer.
    • Enforce 2026 schema deprecation rules (flag retired FAQPage or HowTo rich results).
  4. AI Search (GEO) & Citability:

    • Check for citable self-contained answer blocks (130-170 words answering query in first 40-60 words).
    • Evaluate front-loaded content density (44% of citations emerge from the top 30% of page).
  5. Agentic Browsing Readiness:

    • Run python scripts/seo/agentic_check.py <url> --json.
    • Audit llms.txt, Markdown endpoints (Accept: text/markdown), ai-catalog.json, and WebMCP markup.
    • Run python scripts/seo/lighthouse_agentic.py <url> --json to compute the Lighthouse Agentic Browsing fraction (X/N).
  6. Search Experience (SXO) & Conversion Alignment:

    • Detect page-type mismatches (e.g. informational blog posts ranking for transactional tool queries).
    • Audit time-to-value (TTV) and signup friction.

2. Output Format: Prioritized SaaS Action Plan

Structure the audit findings report into clear severity tiers:

# SaaS SEO Health Report: [Target URL]

| Metric | Score / Status | Benchmark |
|---|---|---|
| Technical Crawlability | PASS / WARN | Clean robots.txt, 2MB cap respected |
| Schema.org JSON-LD | PASS / FAIL | Valid SoftwareApplication + Organization |
| Core Web Vitals (Lab) | Score (0-100) | LCP < 2.5s, CLS < 0.1, INP < 200ms |
| AI Search Citability (GEO) | High / Moderate | Self-contained 130-170w answer blocks |
| Lighthouse Agentic Browsing | X / N passed | Axe accessibility + llms.txt + WebMCP |

## P0 — Critical (Immediate Traffic / Crawl Loss Risk)
- [Issue description, evidence, exact Next.js code fix, verification step]

## P1 — High Impact (Search Visibility & GEO Citability)
- [Issue description, evidence, exact Next.js code fix, verification step]

## P2 — Medium Impact (Agent Readiness & SXO)
- [Issue description, evidence, recommendation]
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall