| name | heading-audit |
| description | Audit the heading structure of a page. Checks H1 uniqueness, level jumps, whether the title duplicates the H1 word for word, headings that carry no information, and subheading density. Use when asked about headings, H1, H2, title tags, or page structure. Aussi déclenché en français par "mes balises H1", "structure de titres", "j'ai deux H1", "hiérarchie des titres", "mon title et mon H1", "balises Hn", "est-ce que mes titres sont bons", "audit des balises". |
Heading Audit
Headings and internal links are the two levers that move a page without touching
anything else. This audit covers the headings half.
Input
A page URL.
Steps
- Call
heading_audit on the target URL. No auth needed, no quota consumed.
- Check
h1_count. Zero or two and above is the first thing to fix.
- Read
hierarchy_jumps. An H2 followed by an H4 breaks the outline.
- Check
title_h1_identical and title_h1_overlap. A title that repeats the H1
word for word wastes a free second angle on the target keyword.
- Read
empty_headings and descriptive_ratio. The test to apply: can someone
understand the page by reading only its headings?
- Check
words_per_h2. Past 400, the page reads as a wall.
Cross-reference before rewriting a title
Call content_brief on the page to get the queries it already ranks for. Rewrite the
title around a query the H1 does not already cover, not around a guess. If the page
has impressions on a question query, that phrasing belongs in an H2.
Output format
Verdict: healthy or issues_found.
Structure: H1 count, heading count, words per H2, descriptive ratio.
Outline as it reads today: the headings in document order, indented by level.
Then state plainly whether the page is understandable from that outline alone.
Title vs H1:
- Current title
- Current H1
- Overlap score
- If identical, propose a rewritten title covering a second angle
Priority list:
- Critical: missing or duplicated H1
- High: level jumps, no H2 on a long page
- Medium: headings that carry no information
- Low: subheading density
Rewrites are proposed as concrete text, not as advice to "improve the heading".
