Skip to content

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

saas-seo-technical

Unverified

Audit 9-category technical SaaS SEO — SSR/ISR, robots.txt AI bots, canonicals, and sitemaps.

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.

Technical SEO Audit for SaaS

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.

Audits technical SEO fundamentals for modern cloud applications, single-page apps (SPAs), and Next.js 14+ App Router architectures.


The 9 Technical Categories

  1. Crawlability & Bot Governance:

    • robots.txt: Exists, valid syntax, reachable at root.
    • Distinct AI crawler rules: Distinguish training crawlers (GPTBot, ClaudeBot, Bytespider, Google-Extended, Applebot-Extended, CCBot, Amazonbot) from search citability crawlers (OAI-SearchBot, Claude-SearchBot, PerplexityBot), and declare Content-Signal preferences (ai-train, search, ai-input).
    • RFC 8288 Link headers & DNS-AID: Return Link headers on homepage (api-catalog, service-desc, service-doc, describedby) and publish _agents SVCB/HTTPS/TXT DNS records where applicable.
    • 2MB HTML Cap: Ensure initial uncompressed HTML is strictly < 2MB (Googlebot limit; avoid bloated inline base64 or CSS).
  2. Indexability & Meta Directives:

    • Canonical tags: Self-referential, absolute URLs, no contradictory noindex directives.
    • Meta robots: Enforce index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1.
  3. Rendering & JavaScript Architecture:

    • Verify critical content and JSON-LD are delivered in initial server-rendered HTML (Next.js SSR/SSG).
    • Ensure crawlers without full headless JS capabilities do not encounter empty <div id="__next"> shells.
  4. URL Hierarchy & Slugs:

    • Clean, lowercase, hyphenated URL paths.
    • Trailing slash consistency. Avoid unmanaged query parameter bloat.
  5. XML Sitemaps:

    • Valid XML sitemap or Next.js app/sitemap.ts dynamic generator.
    • Sitemaps listed in robots.txt. Large sites (>50k URLs) properly partitioned via sitemap index.
  6. Core Web Vitals & Performance:

    • Largest Contentful Paint (LCP) < 2.5s.
    • Cumulative Layout Shift (CLS) < 0.1.
    • Interaction to Next Paint (INP) < 200ms.
    • Time to First Byte (TTFB) < 800ms.
  7. Mobile Responsiveness & Viewport:

    • Valid <meta name="viewport" content="width=device-width, initial-scale=1">.
    • Touch targets >= 48px, readable typography, no horizontal scroll.
  8. Security & Transport:

    • Enforce HTTPS with strict TLS 1.3/1.2.
    • HSTS (Strict-Transport-Security), X-Content-Type-Options: nosniff, and secure CSP.
  9. Fast Indexation & Discovery (IndexNow):

    • Instant notification of published/updated URLs via IndexNow API for Bing and Yandex.

Tool Execution

python scripts/seo/parse_html.py <url> --json
python scripts/seo/sitemap_discovery.py <url> --json
python scripts/seo/pagespeed_check.py <url>
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: 468kUpdated 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: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated 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