Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-audit
saas-seo-audit
UnverifiedRun 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) anduser_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
-
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.
- Check target URL with
-
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).
- Fetch and parse target URL using
-
Schema.org Structured Data Audit:
- Check JSON-LD blocks for SaaS entities:
SoftwareApplication,Organization,WebSite,Product,Offer. - Enforce 2026 schema deprecation rules (flag retired
FAQPageorHowTorich results).
- Check JSON-LD blocks for SaaS entities:
-
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).
-
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> --jsonto compute the Lighthouse Agentic Browsing fraction (X/N).
- Run
-
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]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 470k | Updated | Claude CodeCodex | Verified | Install |
| 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: 470k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |