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.

FileKindSize
SKILL.mdskill md3.8 KB
---
name: saas-seo-audit
description: "Run full-site SaaS SEO audit across crawlability, metadata, schema, CWV, and E-E-A-T."
argument-hint: "[url]"
user-invocable: true
---

<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->

## 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:

```markdown
# 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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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