# Metadata Rewrite QA (`junipr/metadata-rewrite-qa`) Actor Detect missing, duplicate, truncated, weak, or risky titles/descriptions and QA proposed rewrites. - **URL**: https://apify.com/junipr/metadata-rewrite-qa.md - **Developed by:** [junipr](https://apify.com/junipr) (community) - **Categories:** SEO tools, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.90 / 1,000 record profileds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Metadata Rewrite QA ### Store Positioning **Store title:** Metadata Rewrite QA **Short description:** Detect missing, duplicate, truncated, weak, or risky titles/descriptions and QA proposed rewrites. **SEO title:** Metadata Rewrite QA — data QA, validation, and cleanup utility **SEO description:** Detect missing, duplicate, truncated, weak, or risky titles/descriptions and QA proposed rewrites. Use it to validate rows, schemas, duplicates, field quality, and delivery-readiness before handing data to clients or automations. **Categories:** SEO_TOOLS, DEVELOPER_TOOLS **Keywords:** metadata, rewrite, qa, data qa, data/schema qa utility ### Fixed-Inclusive PPE Pricing This actor uses pay-per-event pricing. Event prices include Apify platform usage; users are not expected to pay a separate platform-usage pass-through charge for the configured pricing model. - Tier: U2 — Data/schema QA utility - Primary event: `record-profiled` at $0.00390 base - Default max charge: $5.00 - Store discounts: FREE/BRONZE base, SILVER discounted, GOLD deepest approved discount Event set: - `actor-start`: base $0.00500, GOLD $0.00400. Metadata Rewrite QA: charged when actor start is completed. The price includes Apify platform usage; no separate usage pass-through is intended. - `record-profiled`: base $0.00390, GOLD $0.00312. Metadata Rewrite QA: charged when record profiled is completed. The price includes Apify platform usage; no separate usage pass-through is intended. - `issue-detected`: base $0.00372, GOLD $0.00298. Metadata Rewrite QA: charged when issue detected is completed. The price includes Apify platform usage; no separate usage pass-through is intended. - `qa-report-generated`: base $0.05000, GOLD $0.04000. Metadata Rewrite QA: charged when qa report generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended. ### Public Task Concepts - Audit Metadata Rewrite QA controls on a capped public sample - Find high-priority Metadata Rewrite QA issues before release - Validate Metadata Rewrite QA evidence from supplied pages - Prioritize Metadata Rewrite QA fixes with severity and proof - Export Metadata Rewrite QA QA rows for client review Validate proposed page-title and meta-description rewrites before publication. ### What This Actor Does Metadata Rewrite QA compares current and proposed titles and descriptions. It measures length, checks preservation of required intent terms, detects duplicate peer metadata, finds repeated keywords, flags unresolved HTML entities, and identifies unsupported superlative or guarantee language. Each dataset row includes a `metadataRewriteRows` evidence object with current and proposed values, exact lengths, important terms, preserved and dropped terms, intent coverage, duplicate status, and stuffed terms. ### What This Actor Does Not Do - It does not generate titles or descriptions. - It does not estimate rankings, click-through rate, or search-engine approval. - It does not infer peer-page uniqueness unless `peerTitles` and `peerDescriptions` are supplied. - URL fetching does not invent proposed metadata; structured comparison fields remain required. ### Best Use Cases - prepublication QA for SEO metadata rewrites - intent-loss checks during migrations or content refreshes - duplicate metadata checks across supplied peer pages - keyword-stuffing and unsupported-claim review - client-ready metadata decision exports ### Input Fields | Field | Type | Default | Notes | | --- | --- | --- | --- | | `records` | array | two built-in records | Current and proposed metadata comparisons. | | `urls` | array | `[]` | Explicit source URLs; these override schema-populated defaults. | | `fetchUrls` | boolean | `false` | Fetch source text when needed for traceability. | | `fetchTimeoutMs` | integer | `12000` | Per-request timeout, capped at 30 seconds. | | `watchTerms` | array | metadata terms | Terms retained in the general result summary. | | `includeReport` | boolean | `true` | Writes JSON and Markdown report artifacts. | | `maxItems` | integer | `2` | Result cap; maximum 50. | | `maxTextBytes` | integer | `500000` | Text cap per record. | Comparison metadata fields are `currentTitle`, `currentDescription`, `proposedTitle`, `proposedDescription`, `importantTerms`, `peerTitles`, and `peerDescriptions`. ### Example Input ```json { "records": [ { "sourceId": "roof-repair-metadata", "sourceUrl": "https://example.com/services/roof-repair", "metadata": { "currentTitle": "Roof Services", "currentDescription": "Learn about our services.", "proposedTitle": "Roof Repair Service for Storm and Leak Damage", "proposedDescription": "Schedule roof repair for storm damage, active leaks, and inspection findings with an experienced local service team.", "importantTerms": ["roof", "repair", "storm", "leak"], "peerTitles": ["Roof Replacement Service"] } } ], "maxItems": 1, "includeReport": true } ```` ### Output Evidence The result reports status, severity, score, issue codes, recommendations, and normalized comparison evidence. Findings can include `proposed-title-too-long`, `proposed-description-too-short`, `duplicate-proposed-title`, `intent-loss`, `keyword-stuffing`, `unsupported-marketing-claim`, and `unresolved-html-entity`. ### Cost Control - Compare small batches before scaling a migration review. - Supply only the peer metadata needed for the page group. - Disable URL fetching when current metadata is already in the record. - Disable report artifacts when only dataset rows are needed. ### Public Task Examples - validate rewrite intent and length before release - find duplicate proposed titles across supplied peers - identify keyword stuffing and unsupported claims - prepare a metadata QA source table - export approved and rejected rewrite rows ### Limitations Length thresholds are practical QA signals, not guarantees of search-result display. Intent coverage is lexical and depends on the supplied important terms. Rendered snippets, pixel width, localization, and search-engine rewriting require separate validation. ### Source And Safety Notes Do not include credentials or private unpublished content unless you are authorized to process it. Review flagged claims and final metadata with the content owner before publication. ### Changelog - 2026-07-10: Added intent preservation, peer uniqueness, stuffing, claim, entity, and exact-length evidence with expanded regression coverage. # Actor input Schema ## `records` (type: `array`): Records, snapshots, or source observations to process. Defaults to a tiny deterministic fixture. ## `urls` (type: `array`): Optional URLs reserved for live fetching when Fetch URLs is true. ## `fetchUrls` (type: `boolean`): Fetch sourceUrl text over HTTP. Default is false for deterministic local runs. ## `fetchTimeoutMs` (type: `integer`): Timeout for each bounded HTTP request. ## `watchTerms` (type: `array`): Keywords or topics used to flag relevant records. ## `includeReport` (type: `boolean`): Write JSON and Markdown report artifacts to the key-value store. ## `maxItems` (type: `integer`): Maximum records to process in one run. ## `maxTextBytes` (type: `integer`): Maximum searchable text bytes per record. ## `dryRun` (type: `boolean`): Validate input and write a dry-run summary without PPE charges or dataset output. ## `debug` (type: `boolean`): Enable debug logging. ## Actor input object example ```json { "records": [ { "sourceId": "metadata-good", "sourceUrl": "https://example.com/service", "title": "Roof Repair Nashville | Example Roofing", "description": "Concise title and description with a proposed rewrite that preserves page intent.", "category": "metadata", "keywords": [], "metadata": { "currentTitle": "Roof Repair Nashville | Example Roofing", "currentDescription": "Get roof repair in Nashville from licensed local crews. Fast inspections and clear estimates.", "proposedTitle": "Nashville Roof Repair | Example Roofing", "proposedDescription": "Book Nashville roof repair with licensed local crews, storm inspections, and clear estimates." } }, { "sourceId": "metadata-risk", "sourceUrl": "https://example.com/duplicate", "title": "missing title duplicate too long", "description": "duplicate metadata and too long proposed title risk marker.", "category": "metadata", "keywords": [ "missing title", "duplicate", "too long" ], "metadata": { "currentTitle": "", "currentDescription": "Services", "proposedTitle": "A very long proposed title that will almost certainly be too long for ordinary search result display snippets and browser tabs" } } ], "urls": [], "fetchUrls": false, "fetchTimeoutMs": 12000, "watchTerms": [ "missing title", "duplicate", "too long" ], "includeReport": true, "maxItems": 2, "maxTextBytes": 500000, "dryRun": false, "debug": false } ``` # Actor output Schema ## `results` (type: `string`): Structured result rows in the default dataset. ## `summary` (type: `string`): Summary JSON in the key-value store when includeReport is enabled. ## `markdownReport` (type: `string`): Markdown report in the key-value store when includeReport is enabled. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("junipr/metadata-rewrite-qa").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 = {} # Run the Actor and wait for it to finish run = client.actor("junipr/metadata-rewrite-qa").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 '{}' | apify call junipr/metadata-rewrite-qa --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=junipr/metadata-rewrite-qa", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Metadata Rewrite QA", "description": "Detect missing, duplicate, truncated, weak, or risky titles/descriptions and QA proposed rewrites.", "version": "1.0", "x-build-id": "ivzvHCDauSxWT9DJZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/junipr~metadata-rewrite-qa/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-junipr-metadata-rewrite-qa", "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/junipr~metadata-rewrite-qa/runs": { "post": { "operationId": "runs-sync-junipr-metadata-rewrite-qa", "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/junipr~metadata-rewrite-qa/run-sync": { "post": { "operationId": "run-sync-junipr-metadata-rewrite-qa", "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", "properties": { "records": { "title": "Records To Check", "type": "array", "description": "Records, snapshots, or source observations to process. Defaults to a tiny deterministic fixture.", "items": { "type": "object" }, "default": [ { "sourceId": "metadata-good", "sourceUrl": "https://example.com/service", "title": "Roof Repair Nashville | Example Roofing", "description": "Concise title and description with a proposed rewrite that preserves page intent.", "category": "metadata", "keywords": [], "metadata": { "currentTitle": "Roof Repair Nashville | Example Roofing", "currentDescription": "Get roof repair in Nashville from licensed local crews. Fast inspections and clear estimates.", "proposedTitle": "Nashville Roof Repair | Example Roofing", "proposedDescription": "Book Nashville roof repair with licensed local crews, storm inspections, and clear estimates." } }, { "sourceId": "metadata-risk", "sourceUrl": "https://example.com/duplicate", "title": "missing title duplicate too long", "description": "duplicate metadata and too long proposed title risk marker.", "category": "metadata", "keywords": [ "missing title", "duplicate", "too long" ], "metadata": { "currentTitle": "", "currentDescription": "Services", "proposedTitle": "A very long proposed title that will almost certainly be too long for ordinary search result display snippets and browser tabs" } } ] }, "urls": { "title": "URLs To Fetch", "type": "array", "description": "Optional URLs reserved for live fetching when Fetch URLs is true.", "items": { "type": "string" }, "default": [] }, "fetchUrls": { "title": "Fetch URLs", "type": "boolean", "description": "Fetch sourceUrl text over HTTP. Default is false for deterministic local runs.", "default": false }, "fetchTimeoutMs": { "title": "Fetch Timeout (ms)", "minimum": 1000, "maximum": 30000, "type": "integer", "description": "Timeout for each bounded HTTP request.", "default": 12000 }, "watchTerms": { "title": "Watch Terms", "type": "array", "description": "Keywords or topics used to flag relevant records.", "items": { "type": "string" }, "default": [ "missing title", "duplicate", "too long" ] }, "includeReport": { "title": "Include Report Artifacts", "type": "boolean", "description": "Write JSON and Markdown report artifacts to the key-value store.", "default": true }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum records to process in one run.", "default": 2 }, "maxTextBytes": { "title": "Max Text Bytes", "minimum": 100, "maximum": 2000000, "type": "integer", "description": "Maximum searchable text bytes per record.", "default": 500000 }, "dryRun": { "title": "Dry Run", "type": "boolean", "description": "Validate input and write a dry-run summary without PPE charges or dataset output.", "default": false }, "debug": { "title": "Debug Logs", "type": "boolean", "description": "Enable debug logging.", "default": false } } }, "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 } } } } } } } } } } ```