# Local Business Opportunity Auditor (`samqp/local-business-opportunity-auditor`) Actor Audit business websites, score sales opportunities, and generate ready-to-send service proposals for agencies and freelancers. - **URL**: https://apify.com/samqp/local-business-opportunity-auditor.md - **Developed by:** [Samuel Quiñonez Pérez](https://apify.com/samqp) (community) - **Categories:** Lead generation, SEO tools, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 business page auditeds 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 ## Local Business Opportunity Auditor Turn authorized business websites into qualified sales opportunities. This Actor audits public website signals, assigns a transparent opportunity score, recommends sellable digital services, and creates a personalized outreach pitch. ### What it checks - Availability, HTTP status, redirects, HTTPS, and response time - Titles, meta descriptions, H1 headings, thin content, and forms - Broken internal/external links and broken images - Missing image alt text and mixed HTTP content - Visible contact methods, WhatsApp, and online booking signals - Stale copyright indicators - Crawl limits, deduplication, throttling, and SSRF protection ### Output Each page produces a structured `PAGE` record. Each website also produces a `SUMMARY` containing the opportunity score (0–100), priority, detected issues, recommended services, estimated project value, and optional outreach pitch. Scores measure **sales opportunity**, not overall website quality. Higher scores indicate more visible problems a service provider could solve. For example, an unreachable site adds 30 points, an HTTP error 25, missing HTTPS 15, and missing lead capture 12. Scores are capped at 100. ### Example input ```json { "startUrls": ["https://example.com"], "maxPagesPerSite": 10, "maxDepth": 2, "requestDelayMs": 750, "checkExternalLinks": true, "generateProposal": true, "language": "en", "authorizedUse": true } ```` ### Use cases - Web design and SEO agencies qualifying prospects - Freelancers identifying website maintenance opportunities - Booking, e-commerce, and WhatsApp integration providers - Sales teams prioritizing authorized business lists ### Responsible use and limitations Use only on websites you own or have permission to audit. The Actor performs non-invasive public checks: it does not log in, bypass access controls, test passwords, exploit vulnerabilities, or perform penetration testing. It respects conservative crawl limits and delays. Some JavaScript-rendered content, bot-protected resources, and intermittent failures may not be detected. Results do not guarantee that every problem is found. ### Typical duration A 10-page audit normally takes 15–60 seconds plus the configured delay, depending on the site and linked resources. Large or slow sites take longer. ### Pricing - USD 0.01 per run - USD 0.005 per audited page - USD 0.05 per generated sales proposal Platform usage is included. Disable proposal generation when you only need opportunity data. The Actor respects the maximum run cost and returns partial results when the limit is reached. One qualified website opportunity can represent a USD 50–300 service project, while a typical one-page screening with a proposal costs about USD 0.065. ### Support Open an issue on the Actor page with the run ID and a description. Do not include passwords, API keys, or private customer information. *** ### Español Convierte sitios web autorizados en oportunidades comerciales calificadas. El Actor revisa señales públicas, calcula una puntuación transparente, recomienda servicios digitales y genera un mensaje comercial. Úsalo solamente en sitios propios o autorizados. No realiza pruebas de penetración, no inicia sesión y no intenta obtener acceso administrativo. # Actor input Schema ## `startUrls` (type: `array`): Public websites you own or are authorized to audit. ## `maxPagesPerSite` (type: `integer`): Limits cost and crawl size for each website. ## `maxDepth` (type: `integer`): How many internal link levels to follow. ## `requestDelayMs` (type: `integer`): A polite delay between crawled pages. ## `timeoutSeconds` (type: `integer`): Maximum wait for an individual network request. ## `checkExternalLinks` (type: `boolean`): Verify links that point outside the audited website. ## `generateProposal` (type: `boolean`): Create a short outreach pitch from detected opportunities. ## `language` (type: `string`): Language used for the generated outreach pitch. ## `authorizedUse` (type: `boolean`): Required. This Actor performs non-invasive checks only. ## Actor input object example ```json { "startUrls": [ "https://example.com" ], "maxPagesPerSite": 25, "maxDepth": 2, "requestDelayMs": 750, "timeoutSeconds": 20, "checkExternalLinks": true, "generateProposal": true, "language": "en", "authorizedUse": false } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("samqp/local-business-opportunity-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("samqp/local-business-opportunity-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 samqp/local-business-opportunity-auditor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=samqp/local-business-opportunity-auditor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Local Business Opportunity Auditor", "description": "Audit business websites, score sales opportunities, and generate ready-to-send service proposals for agencies and freelancers.", "version": "0.1", "x-build-id": "EJmz5oueAFDHXBOuu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/samqp~local-business-opportunity-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-samqp-local-business-opportunity-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/samqp~local-business-opportunity-auditor/runs": { "post": { "operationId": "runs-sync-samqp-local-business-opportunity-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/samqp~local-business-opportunity-auditor/run-sync": { "post": { "operationId": "run-sync-samqp-local-business-opportunity-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": [ "startUrls", "authorizedUse" ], "properties": { "startUrls": { "title": "Business website URLs", "type": "array", "description": "Public websites you own or are authorized to audit.", "default": [ "https://example.com" ], "items": { "type": "string" } }, "maxPagesPerSite": { "title": "Maximum pages per website", "minimum": 1, "maximum": 100, "type": "integer", "description": "Limits cost and crawl size for each website.", "default": 25 }, "maxDepth": { "title": "Maximum crawl depth", "minimum": 0, "maximum": 5, "type": "integer", "description": "How many internal link levels to follow.", "default": 2 }, "requestDelayMs": { "title": "Delay between page requests (ms)", "minimum": 250, "maximum": 10000, "type": "integer", "description": "A polite delay between crawled pages.", "default": 750 }, "timeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum wait for an individual network request.", "default": 20 }, "checkExternalLinks": { "title": "Check external links", "type": "boolean", "description": "Verify links that point outside the audited website.", "default": true }, "generateProposal": { "title": "Generate a sales proposal", "type": "boolean", "description": "Create a short outreach pitch from detected opportunities.", "default": true }, "language": { "title": "Proposal language", "enum": [ "en", "es" ], "type": "string", "description": "Language used for the generated outreach pitch.", "default": "en" }, "authorizedUse": { "title": "I own or am authorized to audit these websites", "type": "boolean", "description": "Required. This Actor performs non-invasive checks only.", "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 } } } } } } } } } } ```