# SEO Article Rewrite with Before/After Score (`uduzgun/rewrite-article-for-seo`) Actor Rewrite existing articles with website context, SEO intent, metadata, FAQs, and internal-link guidance. Get improved markdown plus before/after content readiness scores so you can show what changed before publishing. - **URL**: https://apify.com/uduzgun/rewrite-article-for-seo.md - **Developed by:** [Uygar Duzgun](https://apify.com/uduzgun) (community) - **Categories:** SEO tools, Developer tools, 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 ## SEO Article Rewrite with Before/After Score Rewrite an existing article using website context and return the improved markdown with before/after content readiness scores. Built from practical SEO work in e-commerce, where organic search is a serious acquisition channel and weak content needs a clear fix plan before it is rewritten. This Actor is for customer-owned drafts and articles that need better structure, metadata, search-intent coverage, FAQs, and internal-link opportunities. This Actor calls the Uygar Content API at `/api/v1/rewrite-article-seo`. It analyzes the original article, builds a fix plan, rewrites the article with that brief, then scores the rewritten version. It does not publish or save the article to the owner site. The output is a rewritten article package for review. When `companyWebsite`, `articleDestinationUrl`, or `referenceUrls` are provided, the backend fetches a small amount of public page context with SSRF-protected requests before writing the rewrite brief. ### Use cases - Managed SEO Article Rewrite for existing customer articles. - Before/after proof for a paid content audit. - Updating weak drafts before a human editor publishes them. - E-commerce, SaaS, local service, and consulting content that needs website context instead of a generic rewrite. ### Input - `source`: public article URL, article text, or markdown to rewrite. - `targetKeyword`: primary keyword or search topic. - `companyWebsite`: customer website for business context. - `articleDestinationUrl`: where the article is or will be published. - `referenceUrls`: customer pages or existing articles, one URL per line. - `instructions`: optional human rewrite instructions. - `title` and `metaDescription`: optional original metadata 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: - before content readiness score - after content readiness score - score delta - before/after readiness labels - before/after metadata and search-intent status - rewritten title - rewritten meta description - rewritten markdown content - rewritten SEO keywords, FAQ count, and internal-link count - before and after top problems - remaining coverage gaps, heading recommendations, and fix plan for editorial review - full before and after audits Do not call this a Google ranking score. Use content readiness score or SEO draft score. The goal is to improve article quality and show the before/after work clearly. # 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 rewrite. ## `targetKeyword` (type: `string`): Primary keyword or search topic the rewrite should satisfy. ## `instructions` (type: `string`): Optional human instructions for the rewrite. The system still uses the SEO fix plan as the main brief. ## `title` (type: `string`): Optional title to use when scoring the original article. ## `metaDescription` (type: `string`): Optional meta description to use when scoring the original article. ## `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 rewrite context and internal-link suggestions. ## `maxLength` (type: `integer`): Max original article characters to analyze before rewriting. Capped by the API. ## Actor input object example ```json { "source": "# SEO article service\n\nPaste the current article 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, rewritten article, and before/after content readiness scores. # 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 current article 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/rewrite-article-for-seo").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 current article 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/rewrite-article-for-seo").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 current article here, or replace this with a public article URL.", "targetKeyword": "SEO article service" }' | apify call uduzgun/rewrite-article-for-seo --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=uduzgun/rewrite-article-for-seo", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEO Article Rewrite with Before/After Score", "description": "Rewrite existing articles with website context, SEO intent, metadata, FAQs, and internal-link guidance. Get improved markdown plus before/after content readiness scores so you can show what changed before publishing.", "version": "0.1", "x-build-id": "sk6BLQk6HiCk2xHZe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/uduzgun~rewrite-article-for-seo/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-uduzgun-rewrite-article-for-seo", "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~rewrite-article-for-seo/runs": { "post": { "operationId": "runs-sync-uduzgun-rewrite-article-for-seo", "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~rewrite-article-for-seo/run-sync": { "post": { "operationId": "run-sync-uduzgun-rewrite-article-for-seo", "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 rewrite." }, "targetKeyword": { "title": "Target keyword", "type": "string", "description": "Primary keyword or search topic the rewrite should satisfy.", "default": "SEO article service" }, "instructions": { "title": "Rewrite instructions", "type": "string", "description": "Optional human instructions for the rewrite. The system still uses the SEO fix plan as the main brief." }, "title": { "title": "Meta title override", "type": "string", "description": "Optional title to use when scoring the original article." }, "metaDescription": { "title": "Meta description override", "type": "string", "description": "Optional meta description to use when scoring the original article." }, "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 rewrite context and internal-link suggestions." }, "maxLength": { "title": "Max characters", "minimum": 1000, "maximum": 80000, "type": "integer", "description": "Max original article characters to analyze before rewriting. 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 } } } } } } } } } } ```