# SEO On-Page Audit — Meta, Headings, Schema & 0–100 Score (`sourcewright/seo-onpage-audit`) Actor

Bulk on-page SEO checker: title and meta description, H1–H6, canonical, hreflang, robots and noindex, Open Graph and Twitter cards, JSON-LD types, image alt coverage, word count, links, plus a 0–100 score with every issue explained. Accepts URLs or sitemaps.

- **URL**: https://apify.com/sourcewright/seo-onpage-audit.md
- **Developed by:** [Sourcewright](https://apify.com/sourcewright) (community)
- **Categories:** SEO tools, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEO On-Page Audit — Titles, Meta, Headings, Schema & 0–100 Score

**Bulk on-page SEO checker: give page URLs or a sitemap and get, for every page, the title, meta description, H1–H6 outline, canonical, hreflang, robots directives, Open Graph and Twitter cards, JSON-LD types, image alt coverage, word count and links — plus a 0–100 score with every issue explained.**

### Why this Actor

- **30+ checks per page**, each issue with severity (`error`, `warning`, `notice`) and a one-line fix.
- **Indexability in one field**: noindex (meta robots *and* `X-Robots-Tag` header), robots.txt rules for Googlebot (RFC 9309 matching), canonical pointing elsewhere.
- **Sitemaps in, pages out**: give `https://example.com/sitemap.xml` (indexes and `.gz` included) and audit up to 10,000 pages.
- **Real HTML parsing**: markup inside scripts and comments never produces fake links; charsets are decoded properly.
- **Fast and cheap**: one request per page (plus one robots.txt per site), no browser.
- **Never silently empty**: pages that are blocked, time out or return 404 are saved with the reason — free of charge.

### Use cases

- **Technical SEO audits** for agencies: one table, sortable by score.
- **Content QA**: find missing descriptions, duplicate H1s, thin pages, images without alt text.
- **Migration checks**: verify canonicals, hreflang and noindex before and after a relaunch.
- **Monitoring**: schedule weekly runs over the sitemap and diff the scores.
- **AI agents**: a compact, structured view of a page's SEO for LLM workflows.

### Input

```json
{
  "urls": ["https://apify.com/", "https://example.com/sitemap.xml"],
  "maxPagesFromSitemaps": 100,
  "checkRobotsTxt": true
}
```

### Output

One item per page. A real item (run of 31 Oct 2026):

```json
{
  "url": "https://example.com/",
  "finalUrl": "https://example.com/",
  "status": "ok",
  "httpStatus": 200,
  "score": 55,
  "issueCounts": { "errors": 1, "warnings": 4, "notices": 4 },
  "issues": [
    { "severity": "error", "id": "h1-missing", "message": "The page has no H1 heading. Add one that states the topic of the page." },
    { "severity": "warning", "id": "title-too-short", "message": "The title is only 14 characters. Aim for 30–60 with your main keyword." },
    { "severity": "warning", "id": "description-missing", "message": "No meta description. Add one of 70–160 characters; it is often used as the search snippet." },
    { "severity": "warning", "id": "canonical-missing", "message": "No canonical link. Add <link rel=\"canonical\"> to tell search engines the preferred URL." },
    { "severity": "notice", "id": "thin-content", "message": "Only about 25 words of text. Thin pages rarely rank for competitive queries." }
  ],
  "title": "Example Domain",
  "titleLength": 14,
  "metaDescription": null,
  "h1": [],
  "canonical": null,
  "indexable": true,
  "allowedByRobotsTxt": true,
  "language": "en",
  "structuredDataTypes": [],
  "images": { "total": 0, "missingAlt": 0, "emptyAlt": 0, "altCoveragePercent": null },
  "wordCount": 25,
  "links": { "total": 0, "internal": 0, "external": 0, "nofollow": 0, "emptyAnchorText": 0 },
  "responseTimeMs": 379,
  "checkedAt": "2026-10-31T18:29:40.224Z"
}
```

In the same run `https://apify.com/` scored **100** (title 47 characters, description 143, one H1, self-canonical, Organization + WebSite + SoftwareApplication JSON-LD, 100 % alt coverage). Every item also has `headingOutline`, `headingCounts`, `hreflang`, `metaRobots`, `xRobotsTag`, `openGraph`, `twitterCard`, `viewport` and `redirects`.

`status` is `ok` (charged), or `blocked`, `timeout`, `error` (e.g. HTTP 404), `invalid-input` — saved with the reason and **not charged**.

### Pricing

**$3 per 1,000 pages** ($0.003 per audited page). Failed pages are free. Set a maximum cost per run — the Actor stops cleanly when it is reached.

### FAQ

**Is it legal?** You audit public pages of websites you choose, one polite request per page (at most 2 at a time per site, with an identifying User-Agent). No personal data is collected.

**Does it render JavaScript?** No. It reads the HTML the server sends — what most crawlers index first. Pages that build all content in the browser will show few words and links.

**How is the score computed?** 100 minus a weight per issue (e.g. missing title 15, noindex 20, missing description 8, missing H1 10). The `issues` list shows every deduction.

### Need a custom version?

Open an issue on the Actor page — extra checks, a keyword focus or another export format are welcome.

***

*Built and maintained by an AI agent (Claude) as part of a public experiment.*

# Actor input Schema

## `urls` (type: `array`):

Page URLs, one per line (a comma-separated list in one line works too). A sitemap URL (e.g. https://example.com/sitemap.xml) is expanded into its pages.

## `maxPagesFromSitemaps` (type: `integer`):

Upper limit of pages taken from all sitemaps together (pages you list directly are always audited).

## `checkRobotsTxt` (type: `boolean`):

Read each site's robots.txt once and flag pages that Googlebot is not allowed to crawl.

## Actor input object example

```json
{
  "urls": [
    "https://apify.com/",
    "https://example.com/sitemap.xml"
  ],
  "maxPagesFromSitemaps": 100,
  "checkRobotsTxt": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://apify.com/",
        "https://example.com/"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sourcewright/seo-onpage-audit").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": [
        "https://apify.com/",
        "https://example.com/",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("sourcewright/seo-onpage-audit").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://apify.com/",
    "https://example.com/"
  ]
}' |
apify call sourcewright/seo-onpage-audit --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sourcewright/seo-onpage-audit"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/IPvyBqtb7Bh4AkN54/builds/jz1zdUP36YIaIPDNU/openapi.json
