# SEO Audit Scraper (`actorfordge/seo-audit-scraper`) Actor Crawl any website and run an on-page SEO audit. This Actor checks page titles, meta descriptions, H1/H2 headings, word count, canonical URLs, image alt text, internal links, external links, and gives each page an SEO score with clear issues found. - **URL**: https://apify.com/actorfordge/seo-audit-scraper.md - **Developed by:** [Will E](https://apify.com/actorfordge) (community) - **Categories:** SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 audited pages This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEO Audit Scraper SEO Audit Scraper crawls websites and runs a fast on-page SEO audit for every page it finds. It checks important SEO elements like page titles, meta descriptions, headings, word count, canonical URLs, image alt text, internal links, external links, and gives each page a simple SEO score with clear issues found. This Actor is useful for SEO audits, website quality checks, competitor research, client reports, and finding common on-page SEO problems at scale. ### What does SEO Audit Scraper check? For each crawled page, this Actor checks: - Page title - Title length - Meta description - Meta description length - Canonical URL - H1 headings - H2 headings - Word count - Image count - Images missing alt text - Internal links - External links - SEO issues - SEO score from 0 to 100 ### Common SEO issues found The Actor can detect common on-page SEO problems such as: - Missing page title - Title may be too short - Title may be too long - Missing meta description - Meta description may be too short - Meta description may be too long - Missing H1 heading - Multiple H1 headings found - Low word count - Missing canonical URL - Images missing alt text - No internal links found ### Best use cases Use SEO Audit Scraper for: - Auditing websites for basic SEO issues - Finding missing titles and meta descriptions - Checking heading structure across a website - Finding pages with low word count - Checking image alt text problems - Reviewing internal and external link counts - Creating SEO reports for clients - Researching competitor websites - Monitoring small and medium websites ### Input The Actor only needs a website URL and the maximum number of pages you want to audit. #### Example input ```json { "startUrls": [ { "url": "https://example.com" } ], "maxRequestsPerCrawl": 10 } ```` #### Input fields | Field | Type | Description | |---|---|---| | `startUrls` | Array | One or more website URLs to audit | | `maxRequestsPerCrawl` | Integer | Maximum number of pages to crawl and audit | ### Output The Actor returns a clean dataset where each row represents one audited page. #### Output fields | Field | Description | |---|---| | `url` | The page URL that was audited | | `seoScore` | SEO score from 0 to 100 | | `issues` | List of SEO issues found on the page | | `title` | Page title | | `titleLength` | Number of characters in the title | | `metaDescription` | Page meta description | | `metaDescriptionLength` | Number of characters in the meta description | | `canonical` | Canonical URL found on the page | | `h1Count` | Number of H1 headings | | `h1s` | List of H1 headings | | `h2Count` | Number of H2 headings | | `h2s` | List of H2 headings | | `wordCount` | Estimated word count from the page body | | `imageCount` | Number of images found | | `imagesMissingAlt` | Number of images missing alt text | | `internalLinks` | Number of internal links found | | `externalLinks` | Number of external links found | ### Example output ```json { "url": "https://example.com", "seoScore": 85, "issues": [ "Meta description may be too short", "2 images missing alt text" ], "title": "Example Website", "titleLength": 15, "metaDescription": "This is an example website.", "metaDescriptionLength": 27, "canonical": "https://example.com", "h1Count": 1, "h1s": [ "Example Website" ], "h2Count": 3, "h2s": [ "About", "Services", "Contact" ], "wordCount": 742, "imageCount": 8, "imagesMissingAlt": 2, "internalLinks": 24, "externalLinks": 5 } ``` ### How the SEO score works Each page starts with a score of 100. Points are removed when common SEO issues are found, such as missing titles, missing meta descriptions, missing H1 headings, low word count, missing canonical URLs, or images without alt text. The score is meant to give a quick overview of basic on-page SEO quality. A higher score usually means the page has fewer common SEO issues. ### Why use this Actor? Manually checking every page on a website can take a long time. SEO Audit Scraper helps you quickly collect important on-page SEO data and identify common problems across multiple pages. It is especially useful for: - Freelancers - SEO specialists - Marketing agencies - Website owners - Developers - Lead generation workflows - Client website audits ### Notes and limitations This Actor performs a basic on-page SEO audit based on the HTML content it can access. It does not replace a full technical SEO platform, but it is a fast and simple way to find common SEO issues across websites. Some websites may block crawlers, require JavaScript rendering, or limit access to certain pages. Results may vary depending on the website structure and accessibility. # Actor input Schema ## `startUrls` (type: `array`): Enter one or more website URLs to audit for SEO issues. ## `maxRequestsPerCrawl` (type: `integer`): The maximum number of pages the Actor will crawl from the website. ## Actor input object example ```json { "startUrls": [ { "url": "https://apify.com" } ], "maxRequestsPerCrawl": 10 } ``` # Actor output Schema ## `results` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://apify.com" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("actorfordge/seo-audit-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://apify.com" }] } # Run the Actor and wait for it to finish run = client.actor("actorfordge/seo-audit-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://apify.com" } ] }' | apify call actorfordge/seo-audit-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=actorfordge/seo-audit-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEO Audit Scraper", "description": "Crawl any website and run an on-page SEO audit. This Actor checks page titles, meta descriptions, H1/H2 headings, word count, canonical URLs, image alt text, internal links, external links, and gives each page an SEO score with clear issues found.", "version": "0.0", "x-build-id": "2xg4m9njzvTqSK1Go" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actorfordge~seo-audit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actorfordge-seo-audit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/actorfordge~seo-audit-scraper/runs": { "post": { "operationId": "runs-sync-actorfordge-seo-audit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/actorfordge~seo-audit-scraper/run-sync": { "post": { "operationId": "run-sync-actorfordge-seo-audit-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Website URLs", "type": "array", "description": "Enter one or more website URLs to audit for SEO issues.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxRequestsPerCrawl": { "title": "Max Pages to Audit", "minimum": 1, "maximum": 100, "type": "integer", "description": "The maximum number of pages the Actor will crawl from the website.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```