Heading Structure Analyzer

Seo REST API MCP

Analyze the H1-H6 heading hierarchy of an HTML document and return every heading, SEO warnings (missing or multiple H1, skipped levels, empty or overly long headings), and per-level counts.

This page documents the MCP tool findutils:heading_structure_analyzer. See the REST reference →

Use in the browser View as Markdown

Call it over MCP

Tool name findutils:heading_structure_analyzer · no API keys · 120 requests/min per IP

Claude Code

claude mcp add findutils --transport http https://mcp.findutils.com/

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "heading_structure_analyzer",
      "arguments": {
        "html": "<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>",
        "keyword": "seo"
      }
    }
  }'

Input schema

Argument	Type	Required	Description
html	string	yes	The HTML source to analyze (a full page or a fragment).
keyword	string	no	Optional target keyword. Each heading reports whether it contains this keyword (case-insensitive).

Example arguments (verified)

{
  "html": "<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>",
  "keyword": "seo"
}

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/heading-structure-analyzer/execute — no key, 60 requests/min.

Open the REST reference for Heading Structure Analyzer →

More Seo tools

Bot Crawl Checker

Return which of 24 well-known crawlers (Googlebot, BingBot, GPTBot, ClaudeBot, PerplexityBot, AhrefsBot, Twitterbot and more) are allowed or

Domain Rating Checker

Return the Ahrefs Domain Rating (0-100) for up to 25 domains in one call, with a per-domain status.

Faq Schema Generator

Generate FAQPage JSON-LD structured data from question-answer pairs, and return the JSON-LD string, a ready <script> tag, the schema object,

Form To Json Schema

Returns a form schema object ({ formId, method, action, fields, submitText }) extracted from HTML form markup.

Geo Analyzer

Return a Generative Engine Optimization (GEO) report for a public web page: an overall 0-100 score, per-category scores (technical, content,

Graphql Schema Validator

Validate a GraphQL SDL schema and return errors, naming-convention warnings, and counts of types, queries, mutations, and subscriptions.

Hreflang Tag Generator

Generate hreflang annotations for multilingual pages and return them as HTML <link> tags, an HTTP Link header, and an XML sitemap block, plu

Json Ld Generator

Generate JSON-LD structured data for 12 schema.org types (Article, BlogPosting, Product, Organization, LocalBusiness, Person, Event, FAQPage