# RevenuePath Guard: Website Conversion Auditor (`prolific_hoopoe/website-conversion-path-auditor`) Actor Detect candidate failures in public signup, demo, pricing, buy, and checkout paths. Get browser-rendered evidence without clicking or submitting forms. - **URL**: https://apify.com/prolific\_hoopoe/website-conversion-path-auditor.md - **Developed by:** [Bassem Hakim](https://apify.com/prolific_hoopoe) (community) - **Categories:** Automation, Developer tools, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / completed site audit 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 ## Website Conversion Path Auditor RevenuePath Guard renders a public commercial page in a real browser, identifies visible buyer-intent controls, and safely checks a bounded set of same-origin GET destinations. It returns structured evidence for placeholder CTAs, missing fragments, disabled controls, and failed routes. The wedge is deliberately narrower than a broken-link crawler: it prioritizes signup, demo, pricing, buy, subscribe, checkout, quote, and account-creation paths instead of emitting every link on a site. ### What the MVP does - renders JavaScript-driven pages with Playwright; - classifies visible commercial CTAs using deterministic rules; - checks up to 6 unique same-origin routes with a pinned `HEAD` request and a byte-capped `GET` fallback only when `HEAD` is unsupported; - records HTTP failures, disabled controls, missing fragments, and placeholder routes; - captures tightly clipped CTA evidence screenshots only for candidate findings; - emits structured JSON on Apify; the local CLI also writes a compact Markdown report; - blocks credentials in URLs, private or reserved IP space, mixed public/private DNS answers, nonstandard ports, action-like paths, sensitive query parameters, and unsafe redirect targets; - routes browser traffic through a DNS-pinning egress proxy, blocks non-read methods, popups, forms, downloads, WebSockets, beacons, service workers, media, and non-proxied WebRTC; - checks `robots.txt` and stops conservatively when the target path is disallowed or the policy cannot be checked safely. It does **not** click controls, submit forms, log in, create accounts, purchase, message, upload, download, or mutate the target. It is not a vulnerability scanner and it does not claim that a technical finding caused lost revenue. The MVP is limited to English-language, public, unauthenticated landing pages. ### Local run ```bash npm install npm test npm run audit -- --url https://example.com --output artifacts/example ```` Use `--fail-on-high` to return exit code 3 when a high-severity candidate failure is found. That makes the CLI usable in CI without turning medium-confidence findings into hard failures. ### Apify Actor The `.actor` directory contains bounded input and output schemas, a dataset view, and a Playwright Docker image. Under pay-per-event pricing, `src/actor.mjs` verifies that one `completed-site-audit` event fits the caller's limit, completes the audit, and couples the event charge to delivery of the structured dataset result. The launch price is **$3 per completed site audit**, charged once only when the structured audit result is returned. Marketplace pricing is configured in Apify Console rather than hard-coded in this repository. External publication, payout verification, and later price changes remain owner-controlled actions. ### Output health values - `action_needed`: at least one high-severity candidate failure was reproduced. - `review`: no high finding, but at least one medium finding needs review. - `clear_in_bounded_scan`: no candidate failure was found within the declared limits; this is not a whole-site guarantee. # Actor input Schema ## `url` (type: `string`): A public HTTP or HTTPS page on standard port 80 or 443. ## `maxRoutes` (type: `integer`): Maximum commercial same-origin GET destinations to probe after rendering the homepage. ## `timeoutSeconds` (type: `integer`): Timeout for each bounded browser navigation. ## Actor input object example ```json { "url": "https://example.com", "maxRoutes": 6, "timeoutSeconds": 15 } ``` # Actor output Schema ## `results` (type: `string`): The completed structured audit item in the default dataset. # 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("prolific_hoopoe/website-conversion-path-auditor").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("prolific_hoopoe/website-conversion-path-auditor").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 prolific_hoopoe/website-conversion-path-auditor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=prolific_hoopoe/website-conversion-path-auditor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "RevenuePath Guard: Website Conversion Auditor", "description": "Detect candidate failures in public signup, demo, pricing, buy, and checkout paths. Get browser-rendered evidence without clicking or submitting forms.", "version": "0.1", "x-build-id": "EbXsi9gsQDeMba7Ic" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/prolific_hoopoe~website-conversion-path-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-prolific_hoopoe-website-conversion-path-auditor", "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/prolific_hoopoe~website-conversion-path-auditor/runs": { "post": { "operationId": "runs-sync-prolific_hoopoe-website-conversion-path-auditor", "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/prolific_hoopoe~website-conversion-path-auditor/run-sync": { "post": { "operationId": "run-sync-prolific_hoopoe-website-conversion-path-auditor", "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": [ "url" ], "properties": { "url": { "title": "Public website URL", "type": "string", "description": "A public HTTP or HTTPS page on standard port 80 or 443.", "default": "https://example.com" }, "maxRoutes": { "title": "Maximum same-origin routes", "minimum": 0, "maximum": 6, "type": "integer", "description": "Maximum commercial same-origin GET destinations to probe after rendering the homepage.", "default": 6 }, "timeoutSeconds": { "title": "Navigation timeout", "minimum": 5, "maximum": 30, "type": "integer", "description": "Timeout for each bounded browser navigation.", "default": 15 } } }, "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 } } } } } } } } } } ```