SEO Headings Structure Analyzer

This actor performs a complete audit of your page’s heading structure (H1–H6) to help you detect hierarchy problems, missing headings, or SEO issues that affect your site’s visibility and user experience.

You can analyze a single URL or configure a multi-page crawl for a broader audit. The actor scores each page, detects structural problems, and provides actionable recommendations based on SEO best practices..

Features

• Full H1–H6 Analysis: counts and inspects every heading tag on each page.
• SEO Scoring System: each page receives a score (0–100) and a letter grade (A–F).
• Issue Detection: flags missing or multiple H1s, hierarchy jumps, or consecutive same-level headings.
• Configurable Analysis: Choose what aspects to analyze (text, structure, scores).
• Actionable Recommendations: get suggestions like “Add H3 tags to improve content hierarchy”.
• Domain-Level Summary: aggregated metrics: heading averages, issue counts, score distribution.
• Flexible Setup: toggle between single-page or domain-level crawling.
• Developer-Friendly Output: clean JSON structure via Key-Value store or Dataset

Configuration Options

Crawling Behavior

The actor supports two analysis modes:

1. Single Page Analysis (Default): crawlUrls: false

   • Analyzes only the startUrl
   • Ignores the maxPages parameter
   • Fast and focused analysis

2. Multi-Page Crawling: crawlUrls: true

   • Crawls internal links starting from startUrl
   • Respects the maxPages parameter to limit crawling
   • Comprehensive domain analysis

Key Parameters

• startUrl: The URL to start analysis from
• crawlUrls: Boolean flag to enable/disable multi-page crawling (default: false)
• maxPages: Maximum number of pages to analyze (only applies when crawlUrls: true)

Output Format

{
  "domain": {
    "domain_name": "https://mysmartdigital.fr",
    "total_pages_analyzed": 1,
    "total_headings": 5,
    "total_h1": 1,
    "total_h2": 4,
    "total_h3": 0,
    "total_h4": 0,
    "total_h5": 0,
    "total_h6": 0,
    "average_headings_per_page": 5,
    "average_h1_per_page": 1,
    "average_h2_per_page": 4,
    "average_h3_per_page": 0,
    "average_heading_score": 73,
    "pages_with_h1": 1,
    "pages_with_h1_percentage": 100,
    "pages_with_multiple_h1": 0,
    "pages_with_multiple_h1_percentage": 0,
    "pages_with_no_h1": 0,
    "pages_with_no_h1_percentage": 0,
    "pages_with_h2": 1,
    "pages_with_h2_percentage": 100,
    "pages_with_h3": 0,
    "pages_with_h3_percentage": 0,
    "pages_with_good_structure": 1,
    "pages_with_good_structure_percentage": 100,
    "total_heading_issues": 1,
    "critical_issues": 0,
    "warning_issues": 1,
    "info_issues": 0,
    "issues_by_type": {
      "too many consecutive same level headings": [
        {
          "issue": "too many consecutive same level headings",
          "page": "https://mysmartdigital.fr/",
          "severity": "warning"
        }
      ]
    },
    "analysis_summary": {
      "has_heading_issues": true,
      "needs_h1_improvement": false,
      "has_good_structure": true,
      "average_score_grade": "C"
    }
  },
  "pages": [
    {
      "url": "https://mysmartdigital.fr/",
      "pageStatusCode": 200,
      "analysis_date": "2025-10-19T15:01:31.723Z",
      "data_source": "msd_headings",
      "h1": [
        "Agence WordPress"
      ],
      "h2": [
        "Un WordPress  plus simple performant rapide intelligent",
        "Développement de site WordPress",
        "Maintenance de site WordPress",
        "Optimisation des performances WordPress"
      ],
      "h3": [],
      "h4": [],
      "h5": [],
      "h6": [],
      "h1Count": 1,
      "h2Count": 4,
      "h3Count": 0,
      "h4Count": 0,
      "h5Count": 0,
      "h6Count": 0,
      "totalHeadings": 5,
      "headingStructure": [
        {
          "tag": "h1",
          "level": 1,
          "text": "Agence WordPress",
          "position": 1,
          "length": 16,
          "wordCount": 2
        },
        {
          "tag": "h2",
          "level": 2,
          "text": "Un WordPress  plus simple performant rapide intelligent",
          "position": 2,
          "length": 55,
          "wordCount": 7
        },
        {
          "tag": "h2",
          "level": 2,
          "text": "Développement de site WordPress",
          "position": 3,
          "length": 31,
          "wordCount": 4
        },
        {
          "tag": "h2",
          "level": 2,
          "text": "Maintenance de site WordPress",
          "position": 4,
          "length": 29,
          "wordCount": 4
        },
        {
          "tag": "h2",
          "level": 2,
          "text": "Optimisation des performances WordPress",
          "position": 5,
          "length": 39,
          "wordCount": 4
        }
      ],
      "headingScore": 73,
      "headingIssues": [
        "too many consecutive same level headings"
      ],
      "headingRecommendations": [
        "Consider adding H3 tags to create better content hierarchy",
        "Good heading structure, consider minor improvements"
      ],
      "pageTitle": "Agence Wordpress | Liberez le potentiel de votre site WordPress !"
    }
  ],
  "analysis": {
    "total_pages_processed": 1,
    "analysis_completed_at": "2025-10-19T15:01:31.725Z",
    "headings_engine_version": "1.0.0",
    "data_format_version": "1.0"
  }
}

How It Works

1. Fetches the specified page(s).
2. Extracts and parses all heading tags (H1–H6).
3. Builds a hierarchy tree and detects inconsistencies.
4. Scores each page using SEO and readability rules.
5. Returns a JSON object with domain summary, per-page data, and recommendations.

SEO Best Practices Analyzed

1. Single H1 per Page: ensures clear and unique page hierarchy
2. Logical Hierarchy: checks correct H1 → H2 → H3 nesting
3. Heading Length Optimization: detects too-short or too-long headings (ideal: 10–100 characters)
4. Keyword Relevance: evaluates heading context against page title for semantic alignment
5. Title vs H1 Differentiation: flags duplicated page titles and H1s
6. Content Organization: encourages balanced use of H2 and H3 tags for readability and SEO

Typical Use Cases

• SEO professionals auditing heading structure before a crawl or migration.
• Content editors checking that pages follow proper H1–H6 hierarchy.
• Developers validating new templates before deployment.

Support

For issues and questions, please contact My Smart Digital support.