Heading Optimizer

Audits and rewrites the H1-H6 outline of a page. Headings serve two readers: scanning humans, and engines (including AI answer engines) that lift structure directly.

Inputs

• Required: URL(s) to audit, or pasted page content/outline
• Optional: target keyword; location/language from seo-project.yml

Data pulls

• webfetch each URL and extract every heading tag in document order (level + text).
• To see what structure currently wins: python scripts/dfs_client.py serp --keyword "<target keyword>" --limit 10 then webfetch 2-3 of the top-ranking pages and compare outlines.