SEO Audit — On-Page Score, Meta Tags, Schema & Fix Guidance

SEO audit of supplied public page URLs returns a reproducible on-page score and fix guidance for metadata, headings, canonical tags, hreflang, schema and links; optional batch summaries group duplicate metadata without crawling. AI agents can call and pay through Apify MCP. List event rates are $0.004 per page audited; start is extra, usage is included and failed results are uncharged.

Example result

This is the unchanged record returned for the minimal input by the built production image on 2026-10-28, using the real Apify SDK against the public source in local storage mode. Local event logs are not Apify settlement. The image identity, source commit, command and raw records are retained with the release.

{
  "url": "https://docs.apify.com/platform/actors/publishing/monetize",
  "finalUrl": "https://docs.apify.com/actors/monetize",
  "ok": true,
  "status": 200,
  "findings": [
    {
      "id": "twitter_missing",
      "severity": "notice",
      "message": "Recommended Twitter card metadata is absent.",
      "evidence": "twitter:title"
    },
    {
      "id": "twitter_missing",
      "severity": "notice",
      "message": "Recommended Twitter card metadata is absent.",
      "evidence": "twitter:description"
    },
    {
      "id": "redirected",
      "severity": "notice",
      "message": "The requested URL redirects.",
      "evidence": [
        "https://docs.apify.com/actors/monetize"
      ]
    }
  ],
  "summary": {
    "errors": 0,
    "warnings": 0,
    "notices": 3
  },
  "meta": {
    "title": "Monetize Actors | Platform | Apify Documentation",
    "description": "Monetize your Actors on Apify Store and earn regular passive income.",
    "canonical": "https://docs.apify.com/actors/monetize",
    "robots": [],
    "xRobotsTag": null,
    "lang": "en",
    "viewport": "width=device-width, initial-scale=1.0",
    "hreflang": [
      {
        "lang": "en",
        "url": "https://docs.apify.com/actors/monetize"
      },
      {
        "lang": "x-default",
        "url": "https://docs.apify.com/actors/monetize"
      }
    ],
    "openGraph": {
      "og:url": "https://docs.apify.com/actors/monetize",
      "og:locale": "en",
      "og:title": "Monetize Actors | Platform | Apify Documentation",
      "og:description": "Monetize your Actors on Apify Store and earn regular passive income.",
      "og:image": "https://apify.com/og-image/docs-article?title=Monetize+Actors"
    },
    "twitter": {
      "twitter:card": "summary_large_image",
      "twitter:image": "https://apify.com/og-image/docs-article?title=Monetize+Actors"
    }
  },
  "headings": [
    {
      "level": 1,
      "text": "Monetize Actors"
    },
    {
      "level": 2,
      "text": "Pricing models"
    },
    {
      "level": 2,
      "text": "Fees and costs"
    },
    {
      "level": 3,
      "text": "Platform usage"
    },
    {
      "level": 3,
      "text": "Testing costs"
    },
    {
      "level": 3,
      "text": "Apify's commission"
    },
    {
      "level": 2,
      "text": "Make your Actor eligible for agentic payments"
    },
    {
      "level": 2,
      "text": "Handle free users"
    },
    {
      "level": 2,
      "text": "Actor analytics"
    },
    {
      "level": 2,
      "text": "Promote your Actor"
    }
  ],
  "structuredData": [],
  "links": {
    "internal": 77,
    "external": 23,
    "nofollow": 0
  },
  "wordCount": 913,
  "imagesMissingAlt": 0,
  "onPageScore": 100,
  "scoreVersion": "hermes-on-page-v1",
  "scoreBreakdown": [
    {
      "group": "title",
      "cap": 20,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "description",
      "cap": 10,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "canonical",
      "cap": 15,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "headings",
      "cap": 10,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "language",
      "cap": 5,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "viewport",
      "cap": 10,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "hreflang",
      "cap": 5,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "schema",
      "cap": 10,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "alt",
      "cap": 5,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "mixed_content",
      "cap": 10,
      "deduction": 0,
      "findingIds": []
    },
    {
      "group": "observations",
      "cap": 0,
      "deduction": 0,
      "findingIds": [
        "redirected",
        "twitter_missing"
      ]
    }
  ],
  "actions": [
    {
      "id": "redirected",
      "priority": 3,
      "fixHint": "Check that the redirect destination is intended, and update links to the final address where appropriate.",
      "findingIndices": [
        2
      ],
      "occurrences": 1
    },
    {
      "id": "twitter_missing",
      "priority": 3,
      "fixHint": "If card previews matter, review the named Twitter card fields and the preview you intend to publish.",
      "findingIndices": [
        0,
        1
      ],
      "occurrences": 2
    }
  ]
}

How to use it

Start a run in Apify Console, by API or from an agent with an input like this one — it is the input Apify runs every day to test this Actor:

{"urls": ["https://docs.apify.com/platform/actors/publishing/monetize"]}

Start with the minimal JSON example above, then adjust the fields in the table below. Read the Example result and Output fields sections for the returned record, Errors for failure codes, and Events and prices for result events and the separate platform start.

Field	Type	Meaning
urls	array	Public HTTP(S) URLs to process; errors are uncharged.
render	string	auto renders sparse HTML; never audits static HTML; always audits the rendered DOM.
includeBatchSummary	boolean	Optional supplied-URL report and duplicate metadata groups, false by default; no crawl or extra event.

Events and prices

Event	Title	Charged when	FREE / BRONZE	SILVER	GOLD / PLATINUM / DIAMOND
page-audited	Page audited	One successfully fetched and audited HTML page.	$0.004	$0.0036	$0.0032

Platform usage is not passed through. Apify's automatic actor-start event remains $0.00005 per started GB (one GB or less counts once). The synthetic dataset-item event is absent. Charge limits stop further paying work; unprocessed inputs receive uncharged errors. Settlement of completed readable work is attempted on abort; interruption can leave a charge unconfirmed.

Worked cost example: ten successful primary events cost $0.04 at list, plus actor start. Failures are not included in that count.

Call it from an agent

Through Apify's MCP server (https://mcp.apify.com) use call-actor:

{
  "actor": "hermeskd/seo-page-audit",
  "input": {
    "urls": [
      "https://docs.apify.com/platform/actors/publishing/monetize"
    ]
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.05,
    "timeout": 600
  },
  "waitSecs": 30
}

Then call get-dataset-items with the returned defaultDatasetId. Dedicated tool URL: https://mcp.apify.com?tools=hermeskd/seo-page-audit

Output fields

Field	Meaning
url	Input URL.
finalUrl	URL after redirects.
ok	True for a readable audit, including pages with SEO findings.
status	Final HTTP status.
findings	Actionable observations; length checks are editorial heuristics.
summary	Finding counts by severity.
onPageScore	Original 0–100 findings-only score, null on failure; formula above.
scoreVersion	Original weight policy version, hermes-on-page-v1.
scoreBreakdown	Group caps, deductions and matching finding IDs.
actions	Fresh fixed fix hints, priority, occurrence count and bounded finding references.
meta	Title, description, canonical, robots, language, viewport, hreflang and social metadata.
headings	Document heading outline.
structuredData	Types and profile validation only; unknown types valid=null; no contact values returned.
links	HTTP(S) link counts.
wordCount	Words in visible static/rendered text, excluding scripts and styles.
imagesMissingAlt	Images without an alt attribute; decorative empty alt is accepted.
error	Failure, always uncharged.

Limits and run time

1–100 URLs; 10 MiB per HTML response. auto renders HTML with fewer than 200 static words, never parses static HTML only, always audits the rendered DOM. Actual HTML is requested; Markdown and files are rejected, uncharged. Title length 30–60 and description length 50–160 are editorial heuristics, not ranking guarantees. Structured-data profiles cover Article, NewsArticle, BlogPosting, Organization, BreadcrumbList and ListItem. Article/Organization currently have no required properties. Unknown types have valid=null; no complete schema.org or rich-result eligibility claim. Up to 1,000 structured nodes and depth 50.

The default run timeout is 600 seconds. Typical run time on Apify, measured by its deploy of 2026-10-21: the minimal input under How to use it took 3–13 seconds a run at the default 2,048 MB (three runs, peak memory 74 MiB). The same input also ran and passed the pricing floor at 1,024 MB and 4,096 MB (the deploy's memory probes).

On-page score and fix guidance

onPageScore is our hermes-on-page-v1 editorial audit rubric, not a Google score, a ranking prediction, a rich-result eligibility verdict or a complete accessibility assessment. Given the same findings, it always gives the same score. It uses only distinct finding IDs: no timing, run ID, metadata value, finding order or occurrence count changes the number.

Start at 100. For each group, add the deductions for distinct matching IDs, cap that sum at the group's cap, then subtract all capped sums. Clamp the result to 0–100. In formula form: max(0, 100 - sum(min(groupCap, sum(distinctIdDeductions)))). A http_status finding produces null, since no successful page audit is available. Failed input records likewise have no numeric score. Unknown finding IDs require an explicit policy update rather than silently earning a perfect score.

Group	Cap	Finding IDs and deductions
title	20	title_missing 20, title_length 5
description	10	description_missing 10, description_length 3
canonical	15	canonical_missing 5, canonical_invalid 15, canonical_multiple 15
headings	10	h1_count 5, heading_level_skipped 5
language	5	lang_missing 5
viewport	10	viewport_missing 10
hreflang	5	hreflang_invalid 5, hreflang_duplicate 5
schema	10	structured_data_malformed 10, structured_data_missing 5
alt	5	image_alt_missing 5
mixed_content	10	mixed_content 10
observations	0	not_indexable 0, open_graph_missing 0, twitter_missing 0, resource_url_invalid 0, redirected 0, http_status 0

For example, title_length, description_length and canonical_missing deduct 5 + 3 + 5 = 13, for a score of 87. Repeating any one of those findings does not subtract again. Conflicting canonical findings together subtract at most 15. Noindex can be intentional; redirects and optional social tags cost no points. Title/description length and heading conventions are editorial guidance, not search-engine ranking requirements. No schema markup is required simply to earn a score, and unsupported schema types remain unassessed in structuredData. A score of 100 means none of this rubric's weighted findings occurred, not that all possible SEO checks passed.

scoreBreakdown lists every group, cap, deduction and matching IDs. actions contains one original fix hint per finding ID, ordered by priority (1 error, 2 warning, 3 notice) then ID. findingIndices points into the original, unchanged findings array; at most three examples are referenced, with the full occurrence count recorded separately. The hints are fixed guidance written for this Actor; no model or third-party recommendation text is used.

Optional supplied-URL batch report

Set includeBatchSummary to true to write BATCH_SUMMARY.json in the run's key-value store. The output link Optional supplied-URL batch summary opens that JSON. It does not exist when the option is off. No page is discovered or crawled: only caller-supplied inputs and their policy-checked redirects contribute. Links found inside HTML are counted as before, never followed for this report. There is no extra paid event or page charge for the summary.

The report groups outcomes by final origin (scheme, host and non-default port). Failed or unfinished inputs use their supplied origin; malformed origins are null. Indices are zero-based positions in the caller's input list. Counts separate successful and failed completed attempts, pending attempts and unprocessed inputs. reportedInputs also includes uncharged limit/deadline error records. An origin with no successful scored pages has a null average, never a score of 100 or zero. Score distributions cover submitted successful inputs; issue frequencies count distinct audited final URLs, not repeated input aliases.

Duplicate title/description groups cover only distinct final URLs within one origin, without an explicit not_indexable finding. Blank values are ignored. A repeated URL or two supplied URLs redirecting to the same final URL is one observed page. Fragments, host letter case and default ports do not invent new pages; path and query order are retained. Values are normalized with Unicode NFKC, whitespace collapse and case folding; the report includes their SHA-256 digest and input indices rather than copying metadata text. Existing page records retain their original values. No claim is made about pages the caller did not supply or actual search indexing.

complete is false after an abort, timeout, charge limit or unfinished attempt; stoppedBy, pending indices and unprocessed indices show the boundary. Readable page outcomes can appear in a partial report even if settlement is still pending; the report is about audit outcomes, not proof of billed events. An abort may write an initial partial snapshot and a newer one as the current page finishes. An identical snapshot is not rewritten. Storage failures remain visible failures; they are not reported as successful summaries. Invalid run input is rejected before a summary is created.

Once a page write is acknowledged, a deadline or cancellation during settlement keeps that one readable page outcome and its successful summary facts. It does not add a timeout failure for the same input. Interrupted completion marks the summary partial; charge reservations remain with the existing charger. The log separates confirmed charge totals from requests whose settlement is unconfirmed. Abort stops new pages even when summaries are disabled, and allows up to 25 seconds for settlement before publishing the partial report. A remote request interrupted before confirmation may still have reached the platform. Its final billed status requires the platform's settlement evidence.

Errors

Code	Meaning
download_failed	The request or connection failed within its bounded deadline.
http_error	The source answered an unsuccessful HTTP status.
unsupported_content_type	An HTML audit/crawl received a non-HTML representation.
too_large	A documented response, expansion or traversal cap was exceeded.
robots_disallowed	robots.txt forbids fetching the URL; no request was made to it.
blocked_host	The host is on the deny-list or resolves to a private or local address; no request was made.
login_required	The page is a sign-in wall; no authentication is attempted.
timeout	The input did not finish within the run's time budget.
internal_error	Unexpected failure; the message carries the error class.
charge_limit_reached	The run reached its maximum total charge; this input was not processed.
invalid_input	The run input passed the input schema but cannot be used; the message names the field.

No failure record is charged. A run fails only when all input outcomes are Actor-side failures; caller errors and a mixture of caller/Actor failures do not fail the run.

Sources and terms

Only process content you have the right to process. URL fetches obey HermesBot robots-group selection, the shared deny-list, public-address checks on connections and redirects, honest identity, deadlines and rate limits. No caller credentials, cookies, CAPTCHA solving, residential proxies or evasion. Public caller-named HTML is parsed directly or after guarded Chromium rendering. Structured-data required-property checks cover the documented Article, Organization and Breadcrumb profiles; unsupported types remain unassessed. No contact values from structured data are returned. The committed enumeration records the Google Search guidance used for those profiles.

Not affiliated

This Actor is not affiliated with Google, Apify, IANA, Verisign or other named protocol/source providers. Third-party names describe compatibility and source material.

Related Hermes Actors

• AI Crawler Checker: Which AI Bots robots.txt Allows per URL — check declared robots.txt permissions for six AI crawlers at URL paths.
• Article Extractor — News & Blog Text, Date and Markdown by URL — an article's clean text, title and publish date, without the rest of the page.
• ATS Job Search — Jobs Confirmed Open on Company Career Boards — search open jobs in the Hermes directory of Greenhouse and Lever boards, each confirmed live.
• Speech to Text — Transcribe Audio & Video URLs, Speaker Labels — speech to text with SRT and VTT subtitles.
• Video Converter — MP4 to MP3, Trim, GIF and Audio Extraction — audio and video conversion: MP4 to MP3, trim, GIF.
• Broken Links Checker — Links, Assets, Redirects and Their Pages — broken links, 404s and redirects on a site.
• ATS Detector — Company Hiring System & Job Board Lookup — which hiring system and job board a company uses.
• SEC EDGAR Filings — Recent Company Forms, Dates and XBRL Flags — Read recent company financial filing metadata from the official SEC JSON API
• DOI Lookup — Crossref Titles, Venues, Dates and Citation Counts — crossref doi metadata.
• CVE Vulnerability Lookup — NVD CVSS Scores and Exploited Flags — look up NVD CVE dates, status, numeric CVSS scores and severity.
• Merge JSON Datasets — Deduplicate Rows, Export JSON and CSV — json dataset cleaner.
• DNS Lookup — Records, SPF Lookup Counts, DKIM & DMARC by Domain — DNS records and SPF, DKIM and DMARC checks.
• DOCX to Markdown — Word, Excel, PowerPoint and EPUB Converter — Word, Excel, PowerPoint and other office files to Markdown.
• Domain Availability Checker — Bulk RDAP Status and Registrar — whether domain names are available, from registry RDAP.
• USGS Earthquake Lookup — Event Magnitude, Depth, Coordinates — Read numeric USGS earthquake metadata for known event identifiers.
• Currency Exchange Rates — ECB Daily Euro Rates and Cross Pairs — Read latest ECB daily currency reference rates and calculated cross pairs.
• Bulk File Downloader — Save URL Lists to Storage With SHA-256 — files and images from URLs, saved with a public link each.
• GitHub Repo Stats — Stars, Forks, Subscribers and Open Issues — Read numeric metrics for known public GitHub repositories.
• Greenhouse Jobs — Live Openings, Offices and Apply Links — every open job on a company's Greenhouse board.
• Hacker News Story Metrics — Scores, Comment Counts, Timestamps — read numeric Hacker News story scores, timestamps and comment counts by ID.
• HTTP GET Request — Bulk Response Bodies, Status and SHA-256 — public http get.
• Security Headers Checker — HSTS, CSP, Framing, Nosniff by URL — Check seven declared HTTP security header families without returning raw values.
• Image Background Remover — U2NetP Cutouts for JPEG, PNG, WebP — Remove image backgrounds with the small U2NetP model and return transparent PNG pixels as base64
• Image Converter — JPEG, PNG and WebP With Resize and Quality — image format converter.
• Image Metadata Remover — EXIF and GPS Scrub, Pixels Verified — GPS location, camera serial numbers and other private metadata removed from photos, losslessly.
• Image to Text OCR — Text With Word Positions and Confidence — OCR: the text in images.
• Image Upscaler — Real-ESRGAN 2x/4x for Photos and Graphics — image upscaling 2x or 4x, and photo restoration.
• Lever Jobs Scraper — Job Board Postings With Salary, US & EU — every published job on a company's Lever site, global or EU.
• Lighthouse Audit — Lab Web Vitals and Scores, Mobile & Desktop — Lighthouse scores and Core Web Vitals.
• npm Package Lookup — Latest Version, License, Dependency Count — read latest npm package versions, license tokens and dependency counts.
• Website Change Monitor — Page Text Diffs Against Your Snapshots — what changed on a page since the last check.
• PDF to Markdown — PDF Parser & Text Extractor With OCR — PDF to Markdown and text, with OCR for scanned pages.
• Public Holidays Calendar — Holiday Dates for Five Countries — build offline public-holiday calendars for five countries and bounded years.
• Remote Jobs Search — Remote OK Jobs by Keyword, Tag and Salary — current remote jobs from Remote OK, with salary and listing links.
• Research Paper Search — OpenAlex Papers, DOIs, Citation Counts — Search OpenAlex for work-level paper metadata without authors, affiliations, abstracts or full text
• RSS Feed Reader — Atom and JSON Feed Parser With Enclosures — every item of an RSS, Atom or JSON feed.
• Sitemap Extractor — Unique URLs From XML, Gzip & Index Sitemaps — the URLs in a site's sitemaps.
• Text to Speech — Offline English, German, Spanish WAV Voices — Convert short nonpersonal texts to offline formant WAV speech for agents
• Time Zone Converter API — Convert one offset-qualified instant to named IANA time zones using pinned data.
• URL to Markdown — Clean Text for LLM & RAG, With Selectors — a public job page as clean Markdown where the site allows it (deny-listed job sites are refused).
• Extract Video Frames — Timed Stills by Interval or Scene Cut — frames, thumbnails and scenes from a video.
• Website Color Palette — CSS Colors With Alpha and Usage Counts — Extract declared website CSS color literals and counts from public HTML and bounded linked stylesheets
• Favicon Extractor — Icons, Touch Icons, Manifests, Theme Color — declared website icons, theme colors and manifest links.
• Website Screenshot — Full Pages, Elements, Dark Mode & PDF — screenshots and PDF prints of web pages.
• Tech Stack Detector — Website Technologies With Match Evidence — the technologies a website runs, detected live.
• Website Crawler to Markdown — Same-Site Pages for LLM and RAG — bounded whole-site Markdown with robots and crawl-delay enforced

Changelog

• 1.1 (2026-10-28) — original findings-only score and fix hints; optional supplied-URL batch summaries with duplicate metadata groups. No crawl; title, prices, events and fetch safeguards unchanged.

• 1.0 (2026-10-26) — store listing rewritten for the people and agents searching for this job: title, description, search-engine title and description, categories, and the README in the order a searcher reads it (what it does, a real result, how to use it, prices, the agent call).

• 1.0 (2026-10-21) — first public release on Apify Store, after the deploy's typical calls, memory probes, benchmarks and pricing floor passed on the platform.

• 1.0 (2026-10-19) — repairs from an independent review: DNS privacy, malformed publisher URLs, empty sitemap failures, responsive assets and schema prefill, as applicable to this Actor.

• 1.0 (2026-10-18) — the production image, smoke input, three example tasks and benchmarks passed on GitHub-hosted Linux.

• 1.0 (2026-10-17) — first implementation.