multi-location-seo-architecture agent
How to build per-location internal link recommendation engine
Every new location page arrives an orphan, and every existing page hoards links nobody rebalances. This guide builds the recommendation engine that proposes internal links per URL, gated before publish; the substrate below is what it reasons over.
DOWNSTREAM consumer of #575 internal-link-equity-distribution-analysis. The Recommend + Personalize + Gate + Audit skill bundle on the multi-location-seo-architecture agent sits above the per-URL link-equity canonical from #575 + graph-database (NetworkX + Neo4j + ArangoDB + TigerGraph + Amazon Neptune) + vector-similarity (Pinecone + Weaviate + Chroma + Qdrant + Milvus + Vespa + Marqo) + topical-embedding (sentence-transformers + Cohere Embed + OpenAI Embeddings + Anthropic Voyage + BGE + GTE) + CMS substrate and writes a per-recommendation canonical record with named regulatory anchors covering Google PageRank US Patent 6285999 + Topical PageRank + Reasonable Surfer + Hilltop + Google Search Essentials + per-API license + hiQ Labs/Van Buren CFAA + Lanham Act + per-vertical HIPAA/FINRA/state bar + EU AI Act Article 22 + Annex III + WCAG 2.2 AA + ADA Title III.
Published November 14, 2026 · 3,200 words
The 4-skill bundle on the multi-location-seo-architecture agent
One agent. Four coordinated skills. The Recommend + Personalize + Gate + Audit bundle consumes the canonical per-URL link-equity record from #575 + topical-embedding substrate + vector-similarity + CMS substrate and writes one canonical per-recommendation record.
Recommend
Per-page candidate-set top-50 internal-link candidates ranked by composite score (Internal-PageRank + Topical- PageRank + Reasonable-Surfer + Hilltop + topical similarity + revenue-uplift estimate). Inputs from #575 canonical link-equity + topical-embedding (sentence-transformers + Cohere + OpenAI + Anthropic Voyage + BGE + GTE) + vector-similarity (Pinecone + Weaviate + Chroma + Qdrant + Milvus + Vespa) + BM25 + Lucene + Elasticsearch + Vespa retrieval + revenue-attribution from GA4 + Adobe + Mixpanel + Amplitude + Heap.
Personalize
Per-portfolio per-banner per-location per-page customization: service area + vertical + regulatory applicability + language + locale + AI Overview presence + SERP-feature presence (from #571). Per-recommendation anchor-text via per-vendor LLM (OpenAI + Anthropic + Mistral) under zero-retention with brand-voice canonical from #549. Per-recommendation per-platform (web + mobile + AMP + AI Overview snippet) format.
Gate
5 anchors per-recommendation before insertion: PageRank patent + per-API license + CFAA + Crawl Budget + USPTO trademark + Lanham 1125(a) when competitor brand in anchor + FTC Endorsement Guides + Pfizer 1972 + Robinson-Patman + FDD Item 12 + per-vertical (HIPAA + FINRA + state bar + ABA + FDA + alcohol) + EU AI Act Article 22 + Annex III + FRIA + DSA + GDPR + WCAG 2.2 AA + ADA Title III + Section 508 + EAA.
Audit
Per-recommendation WORM record: link-equity input + topical-embedding + vector-similarity score + revenue-uplift + per-location personalization + per-anchor gate-pass + Lanham surface + per-vertical applicability + accessibility + AI-ML provenance + EU AI Act label. Retention: 7-year FTC + 7-year IRS + 7-year HIPAA + 7-year state bar + 6-year SEC + 3-year FINRA + GDPR Article 30 + EU AI Act Article 12 + SOC 2 CC7/CC8.
The real ecosystem this sits above
Recommend + Personalize + Gate + Audit does not replace the crawlers, graph databases, or CMS plugins. It consumes the link-equity canonical from #575 and orchestrates topical-embedding + vector-similarity + revenue-attribution with named regulatory anchors.
Topical-embedding + vector-similarity
- sentence-transformers + Cohere Embed + OpenAI Embeddings
- Anthropic Voyage + BGE + GTE topical-embedding
- Pinecone + Weaviate + Chroma + Qdrant + Milvus
- Vespa + Marqo vector-similarity
- BM25 + Lucene + Elasticsearch + OpenSearch retrieval
Graph-database + revenue-attribution
- NetworkX + Apache Spark GraphX + Neo4j + ArangoDB
- TigerGraph + DGraph + JanusGraph + Amazon Neptune
- GA4 + Adobe Analytics + Mixpanel + Amplitude + Heap
- Snowflake + BigQuery + Databricks + Redshift + ClickHouse
- DuckDB + Iceberg + Hudi + Delta Lake table format
CMS + crawler verification
- WordPress + Drupal + Joomla + Shopify + WooCommerce
- Magento + BigCommerce + Squarespace + Webflow + Wix
- Contentful + Sanity + Strapi + Storyblok + Prismic
- Sitebulb + Screaming Frog + OnCrawl + DeepCrawl Lumar
- Botify verification crawl after insertion
Compliance overlay
Five anchors run per-recommendation before any insertion commits. The first anchor is operationally distinctive: Google PageRank patent + per-API license intersect CFAA-scraping doctrine + Lanham trademark surface when anchor text uses competitor brand.
Anchor 1: PageRank patent + per-API license + CFAA + Lanham trademark (operationally distinctive)
Google PageRank Brin-Page 1998 + Google US Patent 6285999 + Topical PageRank Haveliwala + Personalized PageRank + Reasonable Surfer Model + Hilltop algorithm + Google Search Essentials + Google Search Quality Rater Guidelines + Google John Mueller + Gary Illyes guidance. Per-API license (Ahrefs + SEMrush + Moz Mozscape + Sistrix + Screaming Frog + Botify + OnCrawl + Sitebulb). CFAA 18 USC 1030 + hiQ Labs + Van Buren + Meta v Bright Data scraping doctrine + robots.txt + Google Crawl Budget + Sitemap protocol. USPTO trademark monitoring + Lanham 15 USC 1051 + 15 USC 1125(a) false-designation when recommendation anchor text uses competitor brand. FTC Endorsement Guides 16 CFR Part 255 + FTC Section 5 + Pfizer 1972 + FTC MARS + Robinson-Patman + FDD Item 12 + 15-state franchise + state UDTPA.
Anchor 2: Per-vertical (HIPAA + FINRA + state bar)
HIPAA 45 CFR 164.502 + 504 + 514 when MedicalBusiness recommendation includes patient-relationship signal + 7-year HIPAA. FINRA Rule 2210 when FinancialService + 3-year FINRA. SEC Regulation FD + 6-year SEC when public-company-IR. ABA Model Rule 7.1-7.5 when LegalService + 7-year state bar + 50-state matrix. State medical board. FDA OPDP + DEA Schedule + alcohol TABC + CalABC + state-board.
Anchor 3: EU AI Act + AI-ML recommendation
EU AI Act Article 22 + Article 26 + Article 50 + Article 13 + 14 + 15 + Annex III high-risk when AI-ML recommendation drives content prioritization + Article 6 + 27 FRIA. Digital Services Act + DMA. GDPR Article 22 + Article 6 + 7 + 28 + 30. LGPD + DPDP + PIPEDA + Quebec Law 25. CCPA + CPRA + COPPA + 18-state privacy. NIST AI RMF + ISO 42001.
Anchor 4: Accessibility + SEC material
WCAG 2.2 AA + ADA Title III + Section 508 + EAA EN 301 549 when recommendation rendering must remain accessible. SEC Reg S-K material disclosure + FASB ASC 350 intangible-asset.
Anchor 5: Security + WORM retention
ISO 27001 + SOC 2 Type II. Per-vendor LLM zero-retention + per-source DPA. Policy-as-code via OPA Rego + AWS Cedar + Casbin + Cerbos + Oso + Styra DAS + Permit.io. Storage: AWS S3 Object Lock + Azure Blob immutable + Google Cloud Storage Bucket Lock + Wasabi WORM. Retention: 7-year FTC + 7-year IRS + 7-year HIPAA + 7-year state bar + 6-year SEC + 3-year FINRA + GDPR Article 30 + EU AI Act Article 12 + SOC 2 CC7/CC8.
6-workstream reporting cycle
Every two weeks during a Tier 3 Fractional CMO engagement, six workstreams report against the pre-engagement baseline. No forecast accuracy claims. Process commitments only.
- 1. Per-portfolio recommendation coverage. Pages with recommendations + per-page volume + #575 link-equity freshness.
- 2. Recommend candidate-set distribution. Per-page top-50 candidate distribution + composite-score + topical-embedding coverage.
- 3. Personalize per-location customization flow. Per-location service area + vertical + regulatory applicability + AI Overview signal from #571.
- 4. Gate-pass/gate-fail distribution. Per-anchor gate-fail + Lanham trademark surface + per-vertical + accessibility WCAG 2.2 AA.
- 5. Regulatory-defense audit coverage. PageRank patent + per-API license + CFAA + Lanham + per-vertical HIPAA/FINRA/state bar + EU AI Act Article 22 + Annex III + DSA + WCAG.
- 6. FBC feedback-loop pattern-learning. Per-page realized-vs-predicted link-equity uplift + per-recommendation acceptance rate + per-vertical near-miss + per-Google-update impact.
FAQ
- What is per-location internal link recommendation engine — and what is the AI-ML-recommendation times PageRank-patent times CFAA-license problem distinctive to this skill?
- A multi-location retail operator with 80-300 stores generates a continuous stream of new + edited + republished pages. Internal links need to be recommended per page based on link-equity-distribution (from #575 sibling skill on same agent) + topical relevance + revenue impact + per-vertical regulatory constraints. The four-skill bundle on the multi-location-seo-architecture agent — Recommend, Personalize, Gate, Audit — consumes the canonical per-URL link-equity-record from #575 and writes a per-recommendation canonical record. The operationally distinctive anchor: Google PageRank patent + Topical PageRank + Reasonable Surfer Model + Hilltop algorithm + per-API license terms intersect CFAA-scraping doctrine + crawl-budget honoring + Lanham Act trademark surface (when recommendation anchor text uses competitor brand) + EU AI Act Article 22 + Annex III when AI-ML recommendation drives content prioritization. Per-vertical (HIPAA + FINRA + state bar + ABA Model Rule 7.1-7.5) gates per-recommendation. WCAG 2.2 AA + ADA Title III + Section 508 + EAA when recommendation rendering must remain accessible.
- Why do Sitebulb + Screaming Frog + OnCrawl + Ahrefs + SEMrush + Moz Pro + CMS-native plugins break at multi-location AI-ML-recommendation scale?
- Each crawler exposes per-account flat link-graph extraction. Each SEO platform exposes flat ranking signals. Each CMS-native plugin offers rule-based or shallow ML recommendations without per-vertical regulatory gating. None consumes a per-URL link-equity canonical from #575 sibling skill (Internal-PageRank + Topical-PageRank + Reasonable-Surfer + Hilltop + Block Level PR + revenue-attribution). None personalizes per-portfolio per-banner per-location per-page topical embedding via sentence-transformers + Cohere Embed + OpenAI Embeddings + Anthropic Voyage + BGE + GTE + vector-similarity (Pinecone + Weaviate + Chroma + Qdrant + Milvus + Vespa + Marqo). None gates per-recommendation against per-vertical regulatory anchors (HIPAA when MedicalBusiness + FINRA when FinancialService + state bar when LegalService + ABA Model Rule 7.1-7.5 + state medical board) + Lanham trademark surface (USPTO 15 USC 1125(a) when anchor text repeats competitor brand) + EU AI Act Article 22 + Annex III. None writes a per-recommendation audit trail with regulatory-defense retention. The four-skill bundle Recommend + Personalize + Gate + Audit sits above the crawler + SEO-platform + CMS-plugin substrate — it does not replace it.
- How does Recommend + Personalize work?
- Recommend runs per-portfolio per-page recommendation generation via per-URL link-equity canonical from #575 + topical-embedding (sentence-transformers + Cohere Embed + OpenAI Embeddings + Anthropic Voyage + BGE + GTE) + vector-similarity retrieval (Pinecone + Weaviate + Chroma + Qdrant + Milvus + Vespa + Marqo) + BM25 + Lucene + Elasticsearch + OpenSearch + Vespa retrieval + per-page revenue-attribution from GA4 + Adobe + Mixpanel + Amplitude + Heap. Per-page candidate-set: top-50 internal-link candidates ranked by composite score (Internal-PageRank + Topical-PageRank + Reasonable-Surfer + Hilltop + topical similarity + revenue-uplift estimate). Personalize runs per-portfolio per-banner per-location per-page customization: per-location service area + per-location vertical + per-location regulatory applicability + per-location language + per-location locale + per-location AI Overview presence + per-location SERP-feature presence (from #571 sibling). Per-recommendation anchor-text generation via per-vendor LLM (OpenAI + Anthropic + Mistral) under zero-retention with brand-voice canonical from voice-attribute extraction (#549 sibling). Per-recommendation per-platform (web + mobile + AMP + AI Overview snippet) format.
- What does Gate + Audit do?
- Gate runs 5 anchors per-recommendation before any insertion commits. (1) Google PageRank patent + per-API license terms (Ahrefs + SEMrush + Moz Mozscape + Sistrix + Screaming Frog + Botify + OnCrawl + Sitebulb) + CFAA 18 USC 1030 + hiQ Labs/Van Buren/Meta v Bright Data + robots.txt + Google Crawl Budget + Sitemap protocol. (2) USPTO trademark monitoring + Lanham Act 15 USC 1051 + 15 USC 1125(a) false-designation when recommendation anchor text uses competitor brand + FTC Endorsement Guides 16 CFR Part 255 + FTC Act Section 5 + Pfizer 1972 + FTC MARS + Robinson-Patman + FDD Item 12 + 15-state franchise registration + state UDTPA + Lanham. (3) HIPAA 45 CFR 164.502 + 504 + 514 when MedicalBusiness recommendation includes patient-relationship signal + state medical board + ABA Model Rule 7.1-7.5 when LegalService + state bar 50-state + FINRA Rule 2210 when FinancialService + SEC Regulation FD + FDA OPDP when prescription + DEA Schedule + alcohol TABC + CalABC + state-board. (4) EU AI Act Article 22 + Article 26 + Article 50 + Article 13 + 14 + 15 + Annex III high-risk when AI-ML recommendation drives content prioritization + Article 6 + 27 FRIA + Digital Services Act + DMA + GDPR Article 22 + Article 6 + 7 + 28 + 30 + LGPD + DPDP + PIPEDA + Quebec Law 25 + CCPA + CPRA + COPPA + 18-state privacy. (5) WCAG 2.2 AA + ADA Title III + Section 508 + EAA EN 301 549 + SEC Reg S-K material disclosure + FASB ASC 350 intangible-asset. Audit writes a per-recommendation WORM canonical record: per-URL link-equity input snapshot + topical-embedding + vector-similarity score + revenue-uplift estimate + per-location personalization + per-anchor gate-pass + Lanham trademark surface + per-vertical applicability + accessibility WCAG 2.2 AA + per-vendor license + CFAA attestation + AI-ML provenance + EU AI Act transparency label. Storage: AWS S3 Object Lock + Azure Blob immutable + Google Cloud Storage Bucket Lock + Wasabi WORM. Retention: 7-year FTC + 7-year IRS + 7-year HIPAA + 7-year state bar + 6-year SEC + 3-year FINRA + GDPR Article 30 + EU AI Act Article 12 + SOC 2 CC7/CC8.
- What does this skill connect to on the multi-location-seo-architecture agent and across the swarm?
- On the multi-location-seo-architecture agent: multi-location-seo-architecture + internal link equity distribution analysis (#575 UPSTREAM canonical link-equity record) + url-hierarchy-authoring + canonical-tag-management + orphan-page-detection + title-rewrite-tracking + ai-overview-tracking + seo-alerts. Across the swarm: schema-audit-remediation agent (rich-result eligibility #563 + JSON-LD #549 + continuous schema audit) + local-pack-rank-tracking (#559 + #567 + #571 cluster) + voice-attribute extraction (#549 brand-voice canonical) + governance-decision-router five-destination routing + master-record + per-jurisdiction compliance multi-state franchise. Build-pillar siblings: tiered pre-filter deterministic gates for AI content compliance + marketing AI autonomy profile configuration + per-location per-cohort two-sigma anomaly detection + per-location dynamic content for multi-location communications. Commercial-pillar parent: multi-location-seo-architecture.
- What does the 6-workstream pre-engagement-baseline reporting cycle look like for this skill?
- Every two weeks during the Tier 3 Fractional CMO with AI Swarm engagement, six workstreams report against the pre-engagement baseline. Workstream 1: per-portfolio recommendation coverage — pages with recommendations enabled + per-page recommendation volume + per-page link-equity canonical from #575 freshness. Workstream 2: Recommend candidate-set distribution — per-page top-50 candidate distribution + composite-score distribution + topical-embedding model coverage. Workstream 3: Personalize per-location customization flow — per-location service area applied + per-location vertical applied + per-location regulatory applicability + per-location AI Overview signal from #571. Workstream 4: Gate-pass/gate-fail distribution — per-anchor gate-fail rate + Lanham trademark surface coverage + per-vertical applicability + accessibility WCAG 2.2 AA. Workstream 5: Regulatory-defense audit coverage — PageRank patent + per-API license + CFAA + Lanham + per-vertical HIPAA/FINRA/state bar + EU AI Act Article 22 + Annex III + DSA + WCAG 2.2 AA. Workstream 6: FBC feedback-loop pattern-learning — per-page realized-vs-predicted link-equity uplift + per-recommendation acceptance rate + per-vertical near-miss + per-Google-update impact retrospective.
Engage Completions
Two ways to engage. The Tier 1 AI Readiness Assessment maps the link-equity canonical + topical-embedding + vector-similarity + CMS substrate against the Recommend + Personalize + Gate + Audit bundle. The Tier 3 Fractional CMO with AI Swarm embeds 1-2 days per week for 6+ months and runs the bundle end-to-end against the multi-location-seo-architecture agent across the swarm.
Related reading
- multi-location SEO architecture
- Sibling build-pillar: internal link equity distribution analysis (#575 UPSTREAM canonical record)
- Sibling build-pillar: per-location SERP feature-presence (#571 SERP-feature signal)
- Sibling build-pillar: voice-attribute extraction (#549 brand-voice canonical)
- Fractional CMO with AI Swarm
- AI Readiness Assessment