Seo Technical

seo-technical

Family: seo Status: Stable

Purpose

The technical spine of SEO. Runs scriptable on-page/technical checks on a URL (or local HTML) and interprets them across 9 dimensions, deferring real field metrics to seo-google and deep structured-data work to seo-schema.

Current standards it encodes: **Core Web Vitals targets LCP --human # or --file page.html ``` It checks title/meta, h1, canonical, meta-robots noindex, viewport, lang, structured-data presence, image alt coverage, mixed content, and — when it can fetch — security headers and the robots.txt AI-crawler policy.

1. Interpret across the 9 dimensions: crawlability (robots/sitemap),

indexability (meta robots/canonical/noindex), security (HTTPS/HSTS/CSP/mixed content), URL structure, mobile (viewport/tap targets), CWV, structured data, JS rendering (is content visible without JS?), IndexNow/AI-crawler policy.

1. Core Web Vitals: the script emits the targets and flags that synthetic

tools can't measure field CWV — if the user has Google access, pull real CrUX/PSI data via seo-google; otherwise report observable risks only.

1. Structured data: if missing/weak, hand to seo-schema.
2. Render per-dimension findings grouped Critical / High / Medium / Info, each

with a specific fix.

Capability routing

This skill follows the plugin's capability-tier cascade (references/CAPABILITY-TIERS.md) and always returns a usable audit:

1. Tier 1 — Google PSI / CrUX (free key, via seo-google). When a Google key

is set, pull real field Core Web Vitals (LCP/CLS/INP) to harden the CWV dimension; a connected Firecrawl MCP can additionally JS-render shells for the "visible without JS?" check.

1. Tier 2 — built-in (the default). Otherwise tech_audit.py runs the full

9-category lab audit offline (--file / --no-network) and emits the CWV targets — a complete, prioritized technical report on its own, no key, no network. This is the product.

1. Tier 4 — guided. If nothing is connected, deliver the lab audit and name the

field-CWV gap, pointing to a free Google PSI/CrUX key via seo-google.

```capability-routing capability: cwv-field tier1: Google PSI / CrUX (free key) via seo-google tier1signal: CRUXAPIKEY | GOOGLEAPIKEY tier2: techaudit.py (9-category lab audit + LCP<2.5 / CLS<0.1 / INP<200 targets, no key) tier2yields: prioritized per-dimension technical findings with concrete fixes, zero spend tier3: none tier3signal: none tier4: manual technical-SEO checklist; add a free Google PSI/CrUX key via seo-google for field CWV needs_tier1: field CWV (LCP/CLS/INP from CrUX), real Lighthouse performance score

Always end by stating which tier ran and what field data a higher tier would add.

## Outputs

- Per-dimension findings with prioritized fixes (script JSON or `--human` text)
- Cross-references to `seo-google` (field CWV) and `seo-schema` (structured data)
- An explicit AI-crawler policy recommendation for robots.txt

## Dependencies

- `scripts/seo/tech_audit.py` (required) — Python 3.10+, standard library only
- `seo-google` (optional — real CWV field data), `seo-schema` (deep structured data)

## Notes

The technical foundation; most other SEO findings assume this layer is healthy.
The script degrades gracefully offline (use `--file`).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ZachArticulateV](https://github.com/ZachArticulateV)
- **Source:** [ZachArticulateV/designer-pro-and-seo](https://github.com/ZachArticulateV/designer-pro-and-seo)
- **License:** MIT

Install and usage instructions live in the source repository linked above.