Franchise Location Consistency Auditor

Compare franchise and branch pages across brand, NAP, CTA, schema, and template rules while preserving explicitly allowed local differences.

What it does

• Builds a source profile for every capped location page.
• Checks expected brand terms and required template elements.
• Uses the first page or an optional master page as the comparison baseline.
• Separates missing elements from unapproved differences.
• Calculates a transparent per-page consistency score.

Input

• startUrls, locationPages, sitemapUrls, or htmlInputs.
• expectedBrandTerms and requiredTemplateElements.
• allowedLocalVariations for intentional differences.
• compareAgainstMasterPage and consistencyThresholds.minimumScore.
• maxLocations, maxRules, maxPages, maxDepth, and maxChargeUsd.

Dataset output

Each dataset item is one JSON object. The schema includes:

• location URL and name.
• template rule.
• expected and actual values.
• consistency status.
• allowed-variation and location-difference flags.
• brand-term flag and consistency score.

The actor also writes a Markdown summary, CSV records, JSON issues, evidence excerpts, and run metadata to key-value storage. Raw HTML is excluded unless includeRawSnapshots is enabled.

Pricing and charge safety

This actor uses pay per event with Apify platform-usage pass-through disabled. Charges are accepted before paid dataset or report output. maxChargeUsd stops the run before the next event would exceed the configured amount, including when the limit is zero.

Event	Price
actor-start	$0.03500
franchise-page-analyzed	$0.01150
consistency-rule-checked	$0.01150
consistency-issue-emitted	$0.01150
executive-report-generated	$0.40000

Example input

{
  "htmlInputs": [
    {
      "sourceUrl": "https://example.com/nashville",
      "html": "<h1>Acme Nashville</h1><p>100 Broadway, Nashville, TN 37201 · 615-555-0100</p><a href=\"/quote\">Request a quote</a><script type=\"application/ld+json\">{\"@type\":\"LocalBusiness\",\"name\":\"Acme Nashville\"}</script>"
    },
    {
      "sourceUrl": "https://example.com/franklin",
      "html": "<h1>Franklin</h1><p>200 Main St, Franklin, TN 37064</p>"
    }
  ],
  "expectedBrandTerms": [
    "Acme"
  ],
  "requiredTemplateElements": [
    "phone",
    "address",
    "cta",
    "schema"
  ],
  "maxLocations": 5,
  "maxRules": 20,
  "maxChargeUsd": 35
}

Result quality

• Public URL fetching rejects localhost and private IPv4 targets.
• Domain allowlists, timeouts, request delays, crawl depth, and actor-specific limits are enforced.
• Missing or blocked source evidence produces an explicit diagnostic instead of invented values.
• Every dataset row follows the declared dataset schema.
• Reports include the evidence reference and recommended next action for each finding.

Responsible use

Only process public pages or content you are authorized to analyze. Respect site terms, robots policies, rate limits, privacy obligations, and applicable law.