# Article SEO Score and Fix Plan (`uduzgun/score-existing-article`) Actor Audit any article or draft before publishing. Get a content readiness score, top SEO issues, keyword and structure gaps, internal-link opportunities, and a prioritized fix plan for faster rewrites. - **URL**: https://apify.com/uduzgun/score-existing-article.md - **Developed by:** [Uygar Duzgun](https://apify.com/uduzgun) (community) - **Categories:** SEO tools, E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 33.3% 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/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Article SEO Score and Fix Plan Check an existing article or draft and get a content readiness score plus a concrete SEO fix plan. Built from practical SEO work in e-commerce, a billion-dollar industry where organic search is one of the most heavily invested growth channels. Use it when you want to show what is weak in an article before asking a writer, editor, or customer to rewrite it. This Actor calls the Uygar Content API at `/api/v1/analyze-article-seo`, analyzes a public article URL or pasted article text, and writes one dataset item with the score, top problems, audit fields, internal-link guidance, and rewrite brief. It is read-only. It does not publish, rewrite, save content to the owner site, or call an AI model. ### Use cases - Free lead magnet: return a score and the 3 most important problems. - Paid SEO Content Audit: return score, content issues, keyword gaps, internal-link opportunities, and a new outline. - Managed SEO Article Rewrite: use the rewrite brief as the handoff, then compare before and after content readiness score. - E-commerce and service pages: check whether supporting articles have enough search intent coverage, metadata, headings, and internal-link opportunities. ### Input - `source`: public article URL, article text, or markdown to score. - `targetKeyword`: primary keyword or search topic. - `companyWebsite`: customer website for business context and internal-link opportunities. - `articleDestinationUrl`: where the article is or will be published. - `referenceUrls`: customer pages or articles, one URL per line. - `title` and `metaDescription`: optional overrides. `source` and `targetKeyword` are required. Advanced/private inputs: - `apiKey`: optional customer-scoped Uygar Content API key override. Leave it blank on public Store runs. ### Output Each successful run returns one dataset item with: - content readiness score - top 3 problems - extracted word count, heading count, H2 count, and internal-link count - meta title and meta description audit - search intent assessment - keyword gaps and coverage gaps - internal-link opportunities - heading recommendations - concrete fixes - prioritized fix plan - rewrite brief with suggested outline The main audit deliverables are exposed as first-class dataset fields, with the full API result kept in `rawResult` for deeper review. ### Positioning Do not call this a Google ranking score. Use content readiness score or SEO draft score. The goal is to show article quality and next fixes, not promise rankings or traffic. # Actor input Schema ## `apiKey` (type: `string`): Optional advanced override. Leave blank on public Store runs; the Actor owner should configure UYGAR_CONTENT_API_KEY as a secret environment variable. ## `source` (type: `string`): Paste a public article URL, article text, or markdown to score. ## `targetKeyword` (type: `string`): Primary keyword or search topic the article should satisfy. ## `title` (type: `string`): Optional title to use when scoring pasted article text, or to override the fetched page title. ## `metaDescription` (type: `string`): Optional meta description to use when scoring pasted article text, or to override the fetched page meta description. ## `companyWebsite` (type: `string`): Customer website for business context and internal-link opportunities. ## `articleDestinationUrl` (type: `string`): Where the article is or will be published, or the page/category it should support. ## `referenceUrls` (type: `string`): Optional customer pages or existing articles, one URL per line. Used for internal-link and context suggestions. ## `maxLength` (type: `integer`): Max article characters to analyze. Capped by the API. ## Actor input object example ```json { "source": "# SEO article service\n\nPaste the article text here, or replace this with a public article URL.", "targetKeyword": "SEO article service", "maxLength": 80000 } ```` # Actor output Schema ## `results` (type: `string`): Default dataset items containing the request ID, content readiness score, top problems, concrete fixes, fix plan, and rewrite brief. # 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 = { "source": `# SEO article service Paste the article text here, or replace this with a public article URL.`, "targetKeyword": "SEO article service" }; // Run the Actor and wait for it to finish const run = await client.actor("uduzgun/score-existing-article").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 = { "source": """# SEO article service Paste the article text here, or replace this with a public article URL.""", "targetKeyword": "SEO article service", } # Run the Actor and wait for it to finish run = client.actor("uduzgun/score-existing-article").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 '{ "source": "# SEO article service\\n\\nPaste the article text here, or replace this with a public article URL.", "targetKeyword": "SEO article service" }' | apify call uduzgun/score-existing-article --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=uduzgun/score-existing-article", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Article SEO Score and Fix Plan", "description": "Audit any article or draft before publishing. Get a content readiness score, top SEO issues, keyword and structure gaps, internal-link opportunities, and a prioritized fix plan for faster rewrites.", "version": "0.1", "x-build-id": "n8WQXpZe9xRq20pQ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/uduzgun~score-existing-article/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-uduzgun-score-existing-article", "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/uduzgun~score-existing-article/runs": { "post": { "operationId": "runs-sync-uduzgun-score-existing-article", "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/uduzgun~score-existing-article/run-sync": { "post": { "operationId": "run-sync-uduzgun-score-existing-article", "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": [ "source", "targetKeyword" ], "properties": { "apiKey": { "title": "Uygar Content API key", "type": "string", "description": "Optional advanced override. Leave blank on public Store runs; the Actor owner should configure UYGAR_CONTENT_API_KEY as a secret environment variable." }, "source": { "title": "Article URL or text", "type": "string", "description": "Paste a public article URL, article text, or markdown to score." }, "targetKeyword": { "title": "Target keyword", "type": "string", "description": "Primary keyword or search topic the article should satisfy.", "default": "SEO article service" }, "title": { "title": "Meta title override", "type": "string", "description": "Optional title to use when scoring pasted article text, or to override the fetched page title." }, "metaDescription": { "title": "Meta description override", "type": "string", "description": "Optional meta description to use when scoring pasted article text, or to override the fetched page meta description." }, "companyWebsite": { "title": "Customer website", "type": "string", "description": "Customer website for business context and internal-link opportunities." }, "articleDestinationUrl": { "title": "Article destination or target URL", "type": "string", "description": "Where the article is or will be published, or the page/category it should support." }, "referenceUrls": { "title": "Reference pages or articles", "type": "string", "description": "Optional customer pages or existing articles, one URL per line. Used for internal-link and context suggestions." }, "maxLength": { "title": "Max characters", "minimum": 1000, "maximum": 80000, "type": "integer", "description": "Max article characters to analyze. Capped by the API.", "default": 80000 } } }, "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 } } } } } } } } } } ```