How to run an SEO audit and broken link check on a whole site

Updated 2026-11-10 · Data and API builders · by CyberMax

Copy-paste code

Python (pip install apify-client): site in, worst pages and broken links out

Copyimport os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("cybermax/seo-audit").call(run_input={
    "startUrls": ["https://example.com"],
    "maxPages": 200,
    "checkExternalLinks": True,
})
pages = sorted(client.dataset(run["defaultDatasetId"]).iterate_items(), key=lambda p: p["score"])
for p in pages[:10]:  # worst first
    print(p["score"], p["url"], "; ".join(p["issueDetails"]))
summary = client.key_value_store(run["defaultKeyValueStoreId"]).get_record("OUTPUT")["value"]
print(summary)  # pages audited, average score, every broken link with the page it was found on

JavaScript / Node (npm i apify-client)

Copyimport { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('cybermax/seo-audit').call({
  startUrls: ['https://example.com'], maxPages: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const p of items.filter((p) => p.brokenLinks?.length)) {
  for (const b of p.brokenLinks) console.log(p.url, '->', b.url, b.status);
}

No code: n8n, Make or Zapier

Copyn8n: HTTP Request node (or the Apify node, action "Run an Actor and get dataset")
Method:  POST
URL:     https://api.apify.com/v2/acts/cybermax~seo-audit/run-sync-get-dataset-items
Auth:    Header Auth  ->  Authorization: Bearer <your Apify token>
Body:    JSON  {"startUrls": ["https://yoursite.com"], "maxPages": 500, "monitor": true}
Output:  one n8n item per result row

Make:    Apify app -> "Run an Actor" (Actor: cybermax/seo-audit, wait for finish = yes)
         -> Apify "Get Dataset Items" (dataset = the run's defaultDatasetId) -> your next module
Zapier:  Apify app -> action "Run Actor" (cybermax/seo-audit, input JSON as above)
         -> trigger "Finished Actor Run" -> "Fetch Dataset Items" -> your app
Runs longer than 5 minutes: start with POST /v2/acts/cybermax~seo-audit/runs and read the dataset when the run finishes.

Weekly report: Schedule trigger (Monday 06:00) -> the request above -> Google Sheets "Append rows" (url, score, issueDetails, newIssues) -> Slack message when newIssues is not empty.

From an AI agent (MCP)

Copy# Any MCP client (Claude Desktop, Claude Code, Cursor, VS Code): Apify's hosted MCP server
{
  "mcpServers": {
    "seo-audit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.apify.com/?tools=cybermax/seo-audit",
               "--header", "Authorization: Bearer ${APIFY_TOKEN}"],
      "env": { "APIFY_TOKEN": "<your Apify token>" }
    }
  }
}
# The agent sees one tool, cybermax--seo-audit, with the Actor's input schema.
# Ask: "audit example.com and tell me the 5 most important fixes".

Source: Auditmoss (Apify Actor cybermax/seo-audit) README, real Apify run on 10 Nov 2026

What a whole-site SEO audit checks

Per page: HTTP status and redirects, title and meta description (missing, too long, too short, duplicated across the site), H1s, canonical, noindex, images without alt text, thin content, mobile viewport, lang, Open Graph tags, JSON-LD, mixed content, page size and response time. Every row also carries the raw values, so you can build your own rules in a spreadsheet.

Broken link checker for the whole site, free

Every internal link on every audited page is checked (external links too when you turn that on), and each 404 or 5xx comes back with the page it sits on. Link checks never cost anything; only audited pages do.

After the audit: authority and links

On-page fixes are half of SEO. To see how strong a site (or each competitor) is from the outside, Linkheft returns a 0-100 domain authority score and rank from open web-graph data for a whole list of domains.

Good to know

Price on Apify: $0.004 per page audited ($4 per 1,000), no start fee; a 100-page site is $0.40. Link checks, the site summary and pages beyond your limit are free. Apify's free plan includes $5 of usage each month.

Auditmoss reads the HTML the server sends and does not render JavaScript. Sites that build all content in the browser show as thin pages, which is worth knowing for SEO too.

Questions

Compare the options

Related answers