Heading Analyzer
Home/Tools/Technical SEO/Heading Analyzer
⚙ Technical SEO

Heading Structure Analyzer

v1.0 documentation

Analyzes H1-H6 heading hierarchy for SEO best practices. Checks for missing levels, keyword usage, hierarchy violations, and heading depth.

URL inputFile inputXLSX export
heading_analyzer.py154 lines6 paramsPython 3.8+
Quick start
1

Install

terminal
pip install -r requirements.txt
2

Run

terminal
python heading_analyzer.py --url https://example.com/page --target-keyword "cloud hosting"
terminal
python heading_analyzer.py --files page1.html page2.html --output headings.xlsx
3

Export

Add --output report.xlsx to save results as a spreadsheet.

Parameters
FlagDescription
--urlURL to analyze
--fileLocal HTML file
--filesMultiple HTML files. Multiple values allowed
--urlsMultiple URLs. Multiple values allowed
--target-keywordCheck keyword in headings
--outputSave as XLSX
help
python heading_analyzer.py --help
Use cases
Technical audit
Pre-launch check
Ongoing monitoring

Run as part of a full site audit. Export issues to XLSX, prioritize by severity, and create a fix roadmap for the dev team.

Run before launching a new site or after a migration. Catch technical issues before Google crawls the new version.

Schedule regular checks and compare outputs over time. Catch regressions early.

Dependencies

Requires: beautifulsoup4, pandas, requests. All included in requirements.txt.

Get all 154 Python SEO tools — $49

One-time payment. Lifetime access. No monthly fees.
Learn 25 tools and get 25% back. Earn from client work and get 50% back.

Get the full toolkit

AAIO Inc — aaioinc.com/tools/heading_analyzer/