# seo-tools

SEO rule engine + tooling for the Ghost blogs (EN: theexclusionzone.com).

- `seo_rules.py` — shared rule engine (pure functions, no I/O). Single source of truth
  for thresholds + checks. Consumed by the auditor, the validator, and (vendored) by
  ResearchOwl's blog pipeline.
- `seo_audit.py` — Tool A: site-wide auditor (reads all published posts via `ghst-en`).
- `seo_validate.py` — Tool C: single-post pre-publish validator (`seo-check` wraps this).
- `seo_exceptions.py` — documented, consciously-accepted waivers (auditor reporting filter).
- `seo_mirror.py` — OG/Twitter mirroring helper.
- `phase2_*.py/json` — one-off batch helpers (kept for provenance).

No secrets live here. Ghost access is via the `ghst-en` wrapper (`~/.local/bin`), which
fetches a staff token on demand from the pod and never writes it to disk.