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 HTTP endpoint POST /api/tools/heading-structure-analyzer/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/heading-structure-analyzer/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/heading-structure-analyzer/execute \
-H "Content-Type: application/json" \
-d '{
"html": "<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>",
"keyword": "seo"
}' Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/heading-structure-analyzer 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 an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:heading_structure_analyzer after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/ 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