Get-found swarm · Citation-Link-Build Agent · NAP-approval-gating skill · Build pillar · Published June 15, 2026
How to clean up and govern local citations across 50 to 500 locations
This guide explains how to architect the nap-approval-gating skill on the citation-link-build agent end-to-end at multi-location franchise + multi-store scale: per-portfolio per-location per-canonical-multi-source-citation-discovery + per-NAP-canonical-source-of-truth-spec + per-NAP-discrepancy-detection + per-NAP-survivorship-rule + per-NAP-approval-PR-style-gate + per-NAP-propagation-orchestration + per-NAP-propagation-latency-tracking + per-NAP-drift-monitoring + per-NAP-FDD-trademark-compliance + per-NAP-change-effective-date-staging + per-portfolio audit-trail.
What you will build
- Per-portfolio per-canonical-multi-source-citation-discovery across per-citation-management vendor (Yext + BrightLocal + Whitespark + Moz Local + Synup + Uberall + Birdeye + Chatmeter + Rio SEO + Reputation.com) + per-primary-citation platform (GBP + Bing Places + Apple Business Connect + Facebook Pages + Yelp + Foursquare + TripAdvisor + Yellow Pages) + per-data-aggregator (Acxiom LiveRamp + Neustar Localeze TransUnion + Factual Foursquare + Infogroup DataAxle + Express Update) + per-vertical-directory (Healthgrades/WebMD + Avvo/FindLaw + CarGurus/Cars.com + Realtor.com/Zillow).
- Per-canonical-per-citation-source-NAP-field-extraction — per-business-name + per-address-street + per-address-suite + per-address-city + per-address-state + per-address-ZIP + per-phone-primary + per-phone-secondary + per-website-URL + per-categories + per-hours + per-source data-freshness spec.
- Per-canonical-NAP-discrepancy-detection — cross-source fuzzy-match (Levenshtein + Jaro-Winkler + Soundex + USPS CASS address normalization + libpostal address parsing + phone E.164 normalization + domain canonicalization) + per-discrepancy-type classification (business-name + address + suite-number-missing + phone + website-URL + categories + hours) + per-severity tiering + per-confidence scoring.
- Per-canonical-NAP-survivorship-rule — most-recent-update-wins + most-complete-field-wins + highest-trust-source-wins (GBP/Apple/Bing Tier-1 + Yelp/Foursquare Tier-2 + data aggregator Tier-3 + secondary directory Tier-4) + per-source freshness weight + per-source confidence weight + per-field conflict resolution + tied-survivor flag for human review.
- Per-canonical-NAP-approval-PR-style-gate — proposed NAP-change PR spec (title + description + rationale + substantiation-evidence + impact on existing listings + impact on GBP-suspension risk) + PR approval routing per stakeholder (corporate marketing + franchisee owner-operator + legal trademark counsel) + PR approval quorum (Tier-1 major NAP change requires all 3 + Tier-2 suite/phone change requires corporate + franchisee + Tier-3 hours update requires corporate only) + PR merge spec + PR rollback.
- Per-canonical-NAP-propagation-orchestration + per-propagation-latency-tracking + per-NAP-drift-monitoring — Tier-1 primary platform first (GBP + Bing Places + Apple Business Connect) + Tier-2 data aggregator second (Acxiom + Neustar + Factual + Infogroup) + Tier-3 secondary directory third + per-tier propagation API + per-tier update cadence + per-tier confirmation tracking + per-tier failure retry + per-tier rollback + per-source propagation latency (GBP 1-7 day + Bing 7-14 day + Apple 14-21 day + data aggregator 30-60 day + secondary directory 60-90 day) + per-source polling + per-source confirmation + rolling monthly/quarterly/annual NAP discovery + drift detection vs canonical source of truth + per-drift root-cause classification (aggregator re-introduced old NAP + secondary directory stale data + franchisee direct edit bypass + platform API update failure) + per-drift remediation routing.
- Per-canonical-NAP-FDD-Item-12-Item-13-trademark-compliance + per-NAP-change-effective-date-staging — per-Item-12 territorial-rights NAP attestation + per-Item-13 trademark NAP attestation + per-state franchise registration NAP effective-date validation + per-franchisee territory NAP cross-reference + per-franchisee NAP-change 90-day FDD disclosure + per-trademark counsel NAP-change review + per-NAP-change effective-date + per-staged rollout + per-grandfather clause + per-sunset clause + per-iCal/Google Calendar/Outlook export.
Why per-vendor-Yext-Knowledge-Network-single-account breaks at 50-500-location-franchise scale
Per-vendor-Yext-canonical-Knowledge-Network ships per-account per-listing per-field primitive. Per-vendor-BrightLocal + Whitespark + Moz Local + Synup + Uberall + Birdeye + Chatmeter + Rio SEO + Reputation.com-canonical-single-account ship per-vendor per-native citation-management primitives.
At 1-location-1-listing scale per-account per-listing per-field primitive is enough. At 50-500-location-franchise scale per-multi-source-citation-discovery-cross-vendor + per-NAP-canonical-source-of-truth-not-vendor-of-truth + per-NAP-discrepancy-detection-cross-source-fuzzy-match + per-NAP-survivorship-rule-most-recent-most-complete-highest-trust + per-NAP-approval-PR-style-gate-corporate-franchisee-legal + per-NAP-propagation-orchestration-primary-aggregator-secondary + per-NAP-propagation-latency-tracking-30-60-90-day + per-NAP-drift-monitoring-rolling-detection + per-NAP-FDD-Item-12-trademark-compliance + per-NAP-change-effective-date-staging.
Per-cross-vendor-citation-fragmentation + per-NAP-vendor-of-truth-blind + per-cross-source-discrepancy-fuzzy-match-blind + per-survivorship-rule-blind + per-PR-style-approval-gate-blind + per-propagation-orchestration-blind + per-propagation-latency-tracking-blind + per-drift-monitoring-blind + per-FDD-compliance-blind.
The operator-side architecture above per-vendor-citation-management primitive is canonical-multi-source-citation-discovery + per-NAP-canonical-source-of-truth-spec + per-NAP-discrepancy-detection + per-NAP-survivorship-rule + per-NAP-approval-PR-style-gate + per-NAP-propagation-orchestration + per-NAP-propagation-latency-tracking + per-NAP-drift-monitoring + per-NAP-FDD-trademark-compliance + per-NAP-change-effective-date-staging + per-portfolio-audit-trail.
What is in market today
Per-platform per-citation-management-vendor
Yext, BrightLocal, Whitespark, Moz Local, Synup, Uberall, Birdeye, Chatmeter, Rio SEO, Reputation.com, LocalFalcon, Vendasta, GMB Crush, Brandify, SOCi. Per-account per-listing per-field. Per-canonical-multi-source-cross-vendor-canonical-NAP-canonical-source-of-truth-canonical-discrepancy-detection-canonical-survivorship-rule is not the primitive.
Per-platform per-data-aggregator
Acxiom (LiveRamp), Neustar Localeze (TransUnion), Factual (Foursquare), Infogroup (DataAxle), Express Update, MyBusiness Listing Manager (Google), Apple Maps Connect Aggregators. Per-account per-feed primitive. Per-canonical-per-aggregator-propagation-priority-tier-canonical-per-aggregator-propagation-latency-30-60-day-canonical-confirmation-tracking-canonical-failure-retry is not the primitive.
Per-platform per-address-normalization-vendor
USPS Coding Accuracy Support System (CASS), SmartyStreets, Lob, Melissa, Loqate (GBG), Experian Address Validation, AccuZIP, libpostal (open-source), Google Geocoding API, Mapbox Geocoding. Per-account per-address per-validation primitive. Per-canonical-cross-source-NAP-fuzzy-match-canonical-Levenshtein-Jaro-Winkler-Soundex-canonical-USPS-CASS-canonical-libpostal-canonical-phone-E.164-canonical-domain-canonicalization is not the primitive.
Per-platform per-PR-style-versioning-platform
GitHub, GitLab, Bitbucket, Azure Repos, Linear (issue tracking), Jira (Atlassian), Asana, Notion. Per-account per-repository per-PR primitive. Per-canonical-NAP-change-PR-spec-canonical-stakeholder-approval-routing-canonical-quorum-rule-canonical-FDD-Item-12-trademark-compliance is not the primitive.
How the architecture is built
- Per-portfolio per-canonical-multi-source-citation-discovery-substrate. Per-citation-management-vendor + per-primary-citation-platform + per-data-aggregator + per-vertical-directory canonical-multi-source.
- Per-portfolio per-canonical-per-citation-source-NAP-field-extraction. Per-business-name + per-address-street-suite-city-state-ZIP + per-phone-primary-secondary + per-website-URL + per-categories + per-hours canonical-NAP-field.
- Per-portfolio per-canonical-cross-source-NAP-fuzzy-match. Per-Levenshtein + per-Jaro-Winkler + per-Soundex + per-USPS-CASS + per-libpostal + per-phone-E.164 + per-domain-canonicalization canonical-fuzzy-match.
- Per-portfolio per-canonical-NAP-discrepancy-classification. Per-business-name + per-address + per-suite-number-missing + per-phone + per-website-URL + per-categories + per-hours canonical-discrepancy-type.
- Per-portfolio per-canonical-NAP-discrepancy-severity-tiering + per-confidence-scoring. Per-Tier-1-Critical + per-Tier-2-High + per-Tier-3-Medium + per-Tier-4-Low canonical-severity.
- Per-portfolio per-canonical-NAP-survivorship-rule. Per-most-recent-update + per-most-complete-field + per-highest-trust-source (GBP/Apple/Bing Tier-1 + Yelp/Foursquare Tier-2 + data aggregator Tier-3 + secondary directory Tier-4) canonical-survivorship.
- Per-portfolio per-canonical-NAP-approval-PR-style-gate-spec. Per-PR-title + per-PR-description + per-PR-rationale + per-PR-substantiation + per-PR-impact-existing-listings + per-PR-impact-GBP-suspension-risk canonical-PR-spec.
- Per-portfolio per-canonical-PR-approval-routing + per-quorum-rule. Per-corporate-marketing + per-franchisee-owner-operator + per-legal-trademark-counsel + per-Tier-1-all-3 + per-Tier-2-corporate-plus-franchisee + per-Tier-3-corporate-only canonical-quorum.
- Per-portfolio per-canonical-NAP-propagation-orchestration. Per-Tier-1-primary-GBP-Bing-Apple-first + per-Tier-2-data-aggregator-second + per-Tier-3-secondary-directory-third + per-tier-API + per-tier-cadence + per-tier-confirmation + per-tier-failure-retry canonical-propagation.
- Per-portfolio per-canonical-NAP-propagation-latency-tracking. Per-GBP-1-7-day + per-Bing-7-14-day + per-Apple-14-21-day + per-data-aggregator-30-60-day + per-secondary-directory-60-90-day + per-polling + per-confirmation canonical-latency.
- Per-portfolio per-canonical-NAP-drift-monitoring. Per-rolling-monthly + per-rolling-quarterly + per-rolling-annual + per-drift-detection-vs-canonical-source-of-truth + per-drift-root-cause-classification + per-drift-remediation-routing canonical-drift.
- Per-portfolio per-canonical-NAP-FDD-Item-12-Item-13-trademark-compliance. Per-Item-12-territorial-rights + per-Item-13-trademark + per-state-franchise-registration + per-franchisee-territory-cross-reference + per-franchisee-90-day-FDD-disclosure + per-trademark-counsel-review canonical-FDD-compliance.
- Per-portfolio per-canonical-NAP-change-effective-date-staging + per-portfolio-audit-trail. Per-effective-date + per-staged-rollout + per-grandfather-clause + per-sunset-clause + per-iCal-Google-Outlook-export + per-CSV-export + per-SOC2-export + per-FDD-export + per-immutable-storage canonical-staging-audit.
Frequently asked questions
What is multi-location citation cleanup governance across 50 to 500 locations?
Multi-location citation cleanup governance runs per-portfolio per-location per-canonical-multi-source-citation-discovery + per-canonical-per-citation-source-NAP-extraction + per-canonical-NAP-canonical-source-of-truth-spec + per-canonical-NAP-discrepancy-detection + per-canonical-NAP-survivorship-rule + per-canonical-NAP-approval-PR-style-gate + per-canonical-NAP-propagation-orchestration + per-canonical-NAP-propagation-latency-tracking + per-canonical-NAP-drift-monitoring + per-canonical-NAP-FDD-trademark-compliance + per-canonical-NAP-change-effective-date-staging + per-portfolio audit-trail. Per-canonical-multi-source-citation-discovery runs per-portfolio per-canonical-citation-management-vendor (per-Yext + per-BrightLocal + per-Whitespark + per-Moz-Local + per-Synup + per-Uberall + per-Birdeye + per-Chatmeter + per-Rio-SEO + per-Reputation.com per-canonical-management) + per-canonical-primary-citation-platform (per-Google-Business-Profile + per-Bing-Places + per-Apple-Business-Connect + per-Facebook-Pages + per-Yelp + per-Foursquare + per-TripAdvisor + per-Yellow-Pages per-canonical-primary) + per-canonical-data-aggregator (per-Acxiom-LiveRamp + per-Neustar-Localeze-TransUnion + per-Factual-Foursquare + per-Infogroup-DataAxle + per-Express-Update per-canonical-aggregator) + per-canonical-vertical-directory (per-Healthgrades-WebMD + per-Avvo-FindLaw + per-CarGurus-Cars.com + per-Realtor.com-Zillow per-canonical-vertical). The per-platform citation-management vendor category includes Yext, BrightLocal, Whitespark, Moz Local, Synup, Uberall, Birdeye, Chatmeter, Rio SEO, Reputation.com, LocalFalcon, Vendasta, GMB Crush, Brandify, SOCi.
Why does per-vendor-Yext-canonical-Knowledge-Network-canonical-single-account break down at 50-500-location-franchise scale?
Per-vendor-Yext-canonical-Knowledge-Network ships per-account per-listing per-field primitive. Per-vendor-BrightLocal + per-Whitespark + per-Moz-Local + per-Synup + per-Uberall + per-Birdeye + per-Chatmeter + per-Rio-SEO + per-Reputation.com-canonical-single-account ship per-vendor per-native citation-management primitives. At 1-location-1-listing scale per-account per-listing per-field primitive is enough. At 50-500-location-franchise scale per-canonical-multi-source-citation-discovery-canonical-cross-vendor + per-canonical-NAP-canonical-source-of-truth-spec-canonical-not-vendor-of-truth + per-canonical-NAP-discrepancy-detection-canonical-cross-source-fuzzy-match + per-canonical-NAP-survivorship-rule-canonical-most-recent-most-complete-highest-trust + per-canonical-NAP-approval-PR-style-gate-canonical-corporate-vs-franchisee-vs-legal + per-canonical-NAP-propagation-orchestration-canonical-primary-to-aggregator-to-secondary + per-canonical-NAP-propagation-latency-tracking-canonical-30-60-90-day + per-canonical-NAP-drift-monitoring-canonical-rolling-detection + per-canonical-NAP-FDD-Item-12-trademark-compliance + per-canonical-NAP-change-effective-date-staging.
How does per-portfolio per-canonical-multi-source-NAP-discovery + per-NAP-discrepancy-detection work?
Per-portfolio per-canonical-multi-source-NAP-discovery runs per-portfolio per-canonical-per-citation-source-API + per-canonical-per-citation-source-crawler-scraper + per-canonical-per-citation-source-NAP-field-extraction (per-business-name + per-address-street + per-address-suite + per-address-city + per-address-state + per-address-ZIP + per-phone-primary + per-phone-secondary + per-website-URL + per-categories + per-hours per-canonical-NAP-field) + per-canonical-per-citation-source-update-cadence + per-canonical-per-citation-source-data-freshness-spec. Per-canonical-NAP-discrepancy-detection runs per-portfolio per-canonical-cross-source-NAP-fuzzy-match (per-Levenshtein-distance + per-Jaro-Winkler + per-Soundex + per-USPS-CASS-address-normalization + per-libpostal-address-parsing + per-phone-E.164-normalization + per-domain-canonicalization per-canonical-fuzzy-match) + per-canonical-cross-source-NAP-discrepancy-classification (per-business-name-discrepancy + per-address-discrepancy + per-suite-number-missing + per-phone-discrepancy + per-website-URL-discrepancy + per-categories-discrepancy + per-hours-discrepancy per-canonical-discrepancy-type) + per-canonical-cross-source-NAP-discrepancy-severity-tiering + per-canonical-cross-source-NAP-discrepancy-confidence-scoring.
What does per-portfolio per-canonical-NAP-survivorship-rule + per-NAP-approval-PR-style-gate do?
Per-portfolio per-canonical-NAP-survivorship-rule runs per-portfolio per-canonical-most-recent-update-wins-spec + per-canonical-most-complete-field-wins-spec + per-canonical-highest-trust-source-wins-spec (per-Google-Business-Profile-Tier-1 + per-Apple-Business-Connect-Tier-1 + per-Bing-Places-Tier-1 + per-Yelp-Tier-2 + per-Foursquare-Tier-2 + per-data-aggregator-Tier-3 + per-secondary-directory-Tier-4 per-canonical-trust-tier) + per-canonical-per-source-data-freshness-weight + per-canonical-per-source-confidence-weight + per-canonical-per-field-conflict-resolution + per-canonical-tied-survivor-flag-for-human-review. Per-canonical-NAP-approval-PR-style-gate runs per-portfolio per-canonical-proposed-NAP-change-PR-spec (per-PR-title + per-PR-description + per-PR-rationale + per-PR-substantiation-evidence + per-PR-impact-on-existing-listings + per-PR-impact-on-GBP-suspension-risk per-canonical-PR-spec) + per-canonical-PR-approval-routing-per-stakeholder (per-corporate-marketing + per-franchisee-owner-operator + per-legal-trademark-counsel per-canonical-approval-routing) + per-canonical-PR-approval-quorum-rule (per-Tier-1-major-NAP-change-requires-all-3 + per-Tier-2-suite-or-phone-change-requires-corporate-plus-franchisee + per-Tier-3-hours-update-requires-corporate-only per-canonical-quorum) + per-canonical-PR-merge-spec + per-canonical-PR-rollback.
What does per-portfolio per-canonical-NAP-propagation-orchestration + per-propagation-latency-tracking + per-NAP-drift-monitoring do?
Per-portfolio per-canonical-NAP-propagation-orchestration runs per-portfolio per-canonical-propagation-priority-tier (per-Tier-1-primary-platform-first (GBP + Bing Places + Apple Business Connect) + per-Tier-2-data-aggregator-second (Acxiom + Neustar + Factual + Infogroup) + per-Tier-3-secondary-directory-third per-canonical-priority-tier) + per-canonical-per-tier-propagation-API + per-canonical-per-tier-propagation-update-cadence + per-canonical-per-tier-propagation-confirmation-tracking + per-canonical-per-tier-propagation-failure-retry + per-canonical-per-tier-propagation-rollback. Per-canonical-NAP-propagation-latency-tracking runs per-portfolio per-canonical-per-source-propagation-latency-spec (per-GBP-1-7-day + per-Bing-7-14-day + per-Apple-14-21-day + per-data-aggregator-30-60-day + per-secondary-directory-60-90-day per-canonical-propagation-latency) + per-canonical-per-source-propagation-status-polling + per-canonical-per-source-propagation-confirmation. Per-canonical-NAP-drift-monitoring runs per-portfolio per-canonical-rolling-monthly-NAP-discovery + per-canonical-rolling-quarterly-NAP-discovery + per-canonical-rolling-annual-NAP-discovery + per-canonical-NAP-drift-detection-vs-canonical-source-of-truth + per-canonical-NAP-drift-root-cause-classification (per-aggregator-re-introduced-old-NAP + per-secondary-directory-stale-data + per-franchisee-direct-edit-bypass + per-platform-API-update-failure per-canonical-drift-root-cause) + per-canonical-NAP-drift-remediation-routing.
What does per-portfolio per-canonical-NAP-FDD-trademark-compliance + per-citation-link-build-agent-canonical-bundle do?
Per-portfolio per-canonical-NAP-FDD-Item-12-trademark-compliance runs per-portfolio per-canonical-FDD-Item-12-territorial-rights-NAP-attestation + per-canonical-FDD-Item-13-trademark-NAP-attestation + per-canonical-state-franchise-registration-NAP-effective-date-validation + per-canonical-per-franchisee-territory-NAP-cross-reference + per-canonical-per-franchisee-NAP-change-90-day-FDD-disclosure + per-canonical-trademark-counsel-NAP-change-review. Per-canonical-NAP-change-effective-date-staging runs per-portfolio per-canonical-per-NAP-change-effective-date + per-canonical-per-NAP-change-staged-rollout + per-canonical-per-NAP-change-grandfather-clause + per-canonical-per-NAP-change-sunset-clause + per-canonical-NAP-calendar-export-iCal-Google-Outlook. Per-citation-link-build-agent-canonical-bundle integrates the nap-approval-gating skill with sibling skills on the same agent: per-canonical-citation-cleanup (sibling, parent commercial pillar at /citation-cleanup) + per-canonical-nap-consistency (sibling, downstream consumer of approved NAP for consistency monitoring) + per-canonical-nap-propagation-latency (sibling, complementary propagation-latency tracking) + per-canonical-franchise-local-link-building (sibling, companion architecture for franchise local-link building on cleaned citation substrate).
Engage the citation-link-build agent
Per-portfolio per-canonical-multi-source-citation-discovery + per-NAP-canonical-source-of-truth-spec + per-NAP-discrepancy-detection + per-NAP-survivorship-rule + per-NAP-approval-PR-style-gate + per-NAP-propagation-orchestration + per-NAP-propagation-latency-tracking + per-NAP-drift-monitoring + per-NAP-FDD-trademark-compliance + per-NAP-change-effective-date-staging + per-portfolio audit-trail shipped as the orchestration layer above your existing per-citation-management-vendor + per-data-aggregator + per-address-normalization-vendor + per-PR-style-versioning-platform primitive.