@hanzlaa/rcode 4.3.3 → 4.4.1

package/rcode/skills/seo/rank-and-rent-local-seo/rules/city-matrix-and-pages.md

@@ -0,0 +1,76 @@
+# City Matrix & Pages
+
+How to turn chosen subniches into a programmatic subniche × city page set that ranks for local long-tail intent.
+
+## Purpose
+The asset is volume of well-targeted pages: one winnable subniche replicated across many cities. This rule defines the matrix, how to build pages with existing skills, and the quality bar that keeps them out of thin-content penalties.
+
+## Rules
+
+### Define the matrix
+
+**Subniche × city**
+Rows = your 5–10 chosen subniches. Columns = target cities. Start with cities a real buyer already wants (a buyer's city list is gold — build those first). One subniche × 100 cities = 100 pages.
+
+**Start narrow, then widen**
+Build one subniche fully across the priority cities before adding the next subniche. Depth ranks; breadth-without-depth doesn't.
+
+### Build with the existing skills (don't hand-roll)
+
+**Generate**
+`seo-site-builder` for the page framework/templating; `seo-content-factory` for the per-page copy. Each page targets `<subniche> <city>` and its near-me / emergency variants.
+
+**Localize**
+`geo-content-optimizer` + `entity-optimizer` for genuine local relevance — city landmarks, neighborhoods, service-area language, NAP. Avoid pure {city} token-swap pages.
+
+**Structure & markup**
+`schema-markup-generator` for LocalBusiness/Service JSON-LD. `internal-linking-optimizer` to silo: subniche hub → city pages, and cross-link related subniches.
+
+**QA every page**
+`on-page-seo-auditor` (title/H1/intent match) + `technical-seo-checker` (indexability, speed, mobile). No page ships unaudited.
+
+See `templates/service-city-page.md` for the page skeleton.
+
+### Domains & map pack
+
+**Exact-match domains**
+Because everyone chases the head term, subniche EMDs are often available cheap (e.g. a `basementfloodingcleanup<city>.com` for ~$10). Grab them where it fits the strategy.
+
+**GBP where allowed**
+A Google Business Profile / map-pack listing helps where the niche permits. In spam-heavy niches it's hard — then rely on mass long-tail organic. Multiple subniche sites can also be used to dominate the 3-pack in one area (advanced).
+
+## Examples
+
+### Example: Build order
+```
+Subniche: basement flooding cleanup
+Cities (buyer-supplied): Dallas, Houston, Austin, Phoenix, Atlanta, Las Vegas, ...
+1. Build hub page + all city pages for THIS subniche (geo + schema + silo + QA)
+2. rank-tracker on the set
+3. Only then start subniche #2
+```
+
+### Example: Page pipeline
+```
+seo-site-builder → seo-content-factory → geo-content-optimizer/entity-optimizer
+→ schema-markup-generator → internal-linking-optimizer
+→ on-page-seo-auditor + technical-seo-checker → publish → rank-tracker
+```
+
+## Anti-Patterns
+
+### Token-swap doorway pages
+**Problem**: Identical page with only `{city}` changed → thin/doorway content, penalized.
+**Instead**: Localize meaningfully (geo skill), vary intent sections, keep each page genuinely useful.
+
+### Publish-and-forget
+**Problem**: 100 pages live, none tracked, no idea what ranks.
+**Instead**: `rank-tracker` from day one; double down on the subniche/city cells that move.
+
+## Related
+- `subniche-discovery.md` — supplies the rows
+- `monetization.md` — what the ranked pages are for
+- `templates/service-city-page.md` — page skeleton
+
+## Changelog
+- 2026-06-22: Initial version.

package/rcode/skills/seo/rank-and-rent-local-seo/rules/monetization.md

@@ -0,0 +1,70 @@
+# Monetization
+
+How a ranked local-service site turns into recurring income, and the math that tells you when it's worth scaling.
+
+## Purpose
+Pages without a payment path are a hobby. Decide *how you get paid* before scaling pages, and use the call math to set realistic expectations.
+
+## Rules
+
+### Pick a payment model
+
+**Rent the site (flat monthly)**
+Lease the ranked site to one local business for a fixed monthly fee. Simplest recurring revenue; you keep the asset.
+
+**Pay-per-call / per-lead**
+Forward calls/leads and bill per qualified call ($200–$1,500 in high-ticket niches). Higher upside, needs call tracking and a billing agreement.
+
+**Own lead-gen brokerage**
+Sell the same area's leads to multiple buyers, or auction them. Most operational; highest ceiling.
+
+### Validate the buyer first
+
+**A buyer's city list is the best signal**
+If a business already says "I'll pay for calls in Dallas, Houston, Austin…", build *those* cities first. You're filling known demand, not guessing.
+
+**Confirm willingness to pay before mass-building**
+One LOI / verbal from a buyer de-risks the whole build. Don't build 500 pages on spec when 50 pages for a confirmed buyer pays the bills.
+
+### Run the math
+
+```
+monthly income ≈ pages_ranked × calls_per_page_per_month × close_rate × $_per_call
+```
+
+Field lowball example: 100 cities, ~1 call every other month each ≈ 50 calls/month.
+Conservative: 10 calls/month × $300 ≈ $3,000/month from ONE built-out niche.
+This is per niche — additional niches/subniches stack.
+
+## Examples
+
+### Example: De-risked launch
+```
+Buyer: "pay $300/call in Dallas, Houston, Austin, Phoenix, Atlanta"
+→ build basement-flooding-cleanup × those 5 cities first
+→ track calls → bill per call → reinvest into next subniche
+```
+
+### Example: Freedom-number framing
+```
+Target: replace $4,000/mo job income.
+At $300/call → ~14 calls/month needed.
+Plan city/subniche count backward from that, not "rank everything".
+```
+
+## Anti-Patterns
+
+### Build first, monetize "later"
+**Problem**: Hundreds of pages, no buyer, no tracking — an unsold asset.
+**Instead**: Line up a buyer or a clear model before Phase 3 scaling.
+
+### No call tracking
+**Problem**: Can't prove call volume → can't charge per call or justify rent.
+**Instead**: Call tracking from launch; the data is the sales pitch.
+
+## Related
+- `niche-selection.md` — lead value is set here
+- `city-matrix-and-pages.md` — buyer's cities drive the build order
+
+## Changelog
+- 2026-06-22: Initial version.

package/rcode/skills/seo/rank-and-rent-local-seo/rules/niche-selection.md

@@ -0,0 +1,60 @@
+# Niche Selection
+
+How to pick a local-service niche where the leads are worth enough to make rank-and-rent profitable.
+
+## Purpose
+The niche decides everything downstream. A high-value niche forgives mediocre execution; a low-value one punishes great execution. Choose on evidence (lead value), not interest.
+
+## Rules
+
+### Lead value first
+
+**High-CPC = high lead value**
+Pull head-term CPC with `keyword-research` / Google Keyword Planner. A high CPC means businesses already pay a lot to acquire one call — so an organically-ranked call is worth the same to them, for free. Examples seen in the field: `water remediation near me` ~$320 CPC, `water damage restoration` ~$88–$150.
+
+**Ticket size**
+Favor niches where one job is worth four or five figures (water damage $7k–$35k, roofing, mold, foundation, personal injury). Big ticket → buyers happily pay $200–$1,500 per qualified call.
+
+**Emergency / urgent intent**
+Emergency niches convert fast and tolerate thinner pages because intent is overwhelming ("near me", "emergency", "24 hour"). Urgency beats deliberation.
+
+### Competition reality check
+
+**The head term is a trap**
+The main keyword (`<niche> <city>`) is saturated with ads and exact-match-domain incumbents. Note it for value evidence; do **not** make it your entry point — that's what `subniche-discovery.md` solves.
+
+**Spammy-niche caveat**
+Some high-value niches (water damage, locksmith) are GBP-spam heavy, so map-pack entry is hard. That's fine — the play is mass long-tail organic pages, not fighting the 3-pack head-on.
+
+## Examples
+
+### Example: Qualifying "water damage restoration"
+```
+keyword-research → head CPC $88–$320, big ticket ($7k–$35k), emergency intent → QUALIFIES on value.
+serp-analysis    → head term = ads + EMD incumbents → DO NOT enter on head term.
+Decision: pick niche, proceed to subniche discovery.
+```
+
+### Example: Candidate scan
+```
+Run keyword-research across: water damage, mold remediation, roofing repair,
+foundation repair, towing, locksmith, junk removal, personal injury.
+Rank by (CPC × ticket × urgency). Shortlist top 2–3.
+```
+
+## Anti-Patterns
+
+### Chasing volume over value
+**Problem**: Picking a high-volume, low-CPC niche (generic "cleaning services") — lots of traffic, cheap leads, hard to monetize.
+**Instead**: Pick fewer, high-value calls. 10 calls at $300 beats 200 calls at $5.
+
+### Picking on personal interest
+**Problem**: "I like fitness, I'll do gym SEO" — leads barely monetize.
+**Instead**: Let CPC/ticket evidence choose. You're building an asset, not a hobby.
+
+## Related
+- `subniche-discovery.md` — once the niche is chosen, find the winnable wedge
+- `monetization.md` — confirm a buyer exists for these leads before scaling
+
+## Changelog
+- 2026-06-22: Initial version (derived from rank-and-rent field methodology).

package/rcode/skills/seo/rank-and-rent-local-seo/rules/subniche-discovery.md

@@ -0,0 +1,66 @@
+# Subniche Discovery
+
+How to find the long-tail subniches inside a chosen niche that big competitors ignore — the winnable wedge.
+
+## Purpose
+Everyone ranks for the head term, so nobody wins it cheaply. The money is in high-intent subniches the incumbents never built pages for. This rule finds and ranks them.
+
+## Rules
+
+### Manual mining (do this even if you also use AI)
+
+**Keyword Planner scoop**
+Seed the niche in Google Keyword Planner; it returns hundreds of variations (800+ is common). Add a second seed to expand further. Download the full set — it's the raw material for subniche grouping.
+
+**Competitor service menus**
+Open the top-ranking sites in big cities (Dallas, Miami, LA, NYC). Their homepage/service nav lists every subniche they bothered to build: flood damage, structural damage, pipe break, plumbing leak, wet insulation, sewage cleanup, etc. They did the grouping work — copy the map, then find what they *skipped*.
+
+**SERP surfaces**
+Mine People Also Ask, People Also Search For, and Reddit/forum threads via `serp-analysis`. These reveal how real searchers phrase the problem ("basement flooded what do I do") before they know the industry term.
+
+### AI subniche pass
+
+**Run the consultant prompt**
+Use `templates/subniche-research-prompt.md`: "Act as a specialist SEO consultant for a [niche] company. We want to dominate long-tail high-intent searches. Identify 10 subniches ignored by bigger companies." It returns named subniches plus angle ideas (before/after case studies, pairing with ads, etc.).
+
+**Reconcile with the gap analysis**
+Feed manual + AI candidates into `content-gap-analysis` to confirm which subniches the ranking competitors have **no** dedicated page for. Those are the targets.
+
+### Select and rank
+
+Pick **5–10** subniches scored on: intent (emergency > research), competitor absence, exact-match-domain availability, and volume (some is fine; high intent beats high volume).
+
+## Examples
+
+### Example: Water damage subniches that surface
+```
+emergency water extraction · basement flooding cleanup · sump pump failure cleanup
+sewage backup / black water cleanup · burst pipe water damage · appliance leak cleanup
+ceiling water damage from upstairs leak · plumbing overflow cleanup · wet insulation removal
+→ score each, keep top 5–10 with weakest competitor coverage.
+```
+
+### Example: Pipeline
+```
+keyword-research (scoop) ─┐
+competitor-analysis ──────┤→ candidate list → content-gap-analysis → ranked 5–10 subniches
+AI consultant prompt ─────┘
+```
+
+## Anti-Patterns
+
+### Going straight for the head term
+**Problem**: Building `water damage restoration <city>` pages — months and money against entrenched incumbents.
+**Instead**: Start with a single winnable subniche (`basement flooding cleanup`) and expand by city.
+
+### Boiling the ocean
+**Problem**: Targeting all 30 subniches at once → none rank.
+**Instead**: One subniche fully built across cities (90/91 rule), then add the next.
+
+## Related
+- `niche-selection.md` — must be done first
+- `city-matrix-and-pages.md` — turn chosen subniches into pages
+- `templates/subniche-research-prompt.md` — the AI prompt
+
+## Changelog
+- 2026-06-22: Initial version.

package/rcode/skills/seo/rank-and-rent-local-seo/templates/service-city-page.md

@@ -0,0 +1,36 @@
+# Service × City Page Skeleton
+
+Page structure for one `{subniche}` in one `{city}`. Generate the framework with `seo-site-builder` and the copy with `seo-content-factory`; this is the target shape, not a token-swap template. Each page must be meaningfully localized (see `city-matrix-and-pages.md`).
+
+## Target query
+`{subniche} {city}` + variants: `{subniche} near me`, `emergency {subniche} {city}`, `24 hour {subniche} {city}`.
+
+## Skeleton
+
+```
+H1: {Subniche} in {City} — {Emergency/24-Hour} Service
+
+[Hero] one-line promise + click-to-call + service-area ({City} + neighborhoods)
+
+H2: When you need {subniche} (symptoms / triggers, problem-aware language)
+H2: Our {subniche} process (steps; reassures + builds intent)
+H2: Why {City} homeowners call us
+    - local references: neighborhoods, common local causes (climate, housing stock)
+    - NAP / service-area block
+H2: Before & after / case study (the conversion angle from subniche research)
+H2: FAQ (seeded from People Also Ask for this subniche)
+[CTA] click-to-call + lead form (call tracking number)
+
+Schema: LocalBusiness + Service (via schema-markup-generator)
+Internal links: → {subniche} hub, → related subniches in {City}, → other cities for {subniche}
+```
+
+## Quality gates (before publish)
+- Title/H1 match the `{subniche} {city}` intent exactly (`on-page-seo-auditor`).
+- Genuinely localized — not just `{city}` swapped (`geo-content-optimizer`).
+- Indexable, fast, mobile-clean (`technical-seo-checker`).
+- Tracked from launch (`rank-tracker`).
+
+## Variables
+- `{subniche}` — from `subniche-discovery.md`
+- `{city}` — from the buyer-driven city list in `monetization.md`

package/rcode/skills/seo/rank-and-rent-local-seo/templates/subniche-research-prompt.md

@@ -0,0 +1,34 @@
+# Subniche Research Prompt
+
+Drop-in AI prompt to surface ignored, high-intent subniches for a chosen local-service niche. Pair its output with `content-gap-analysis` to confirm competitor absence.
+
+## Prompt
+
+```
+Act as a specialist SEO consultant for a {NICHE} company operating in the US.
+
+Goal: dominate long-tail, high-intent local searches that the big national
+and franchise competitors ignore.
+
+Identify 10 overlooked subniches within {NICHE} that:
+- have clear emergency or high-intent demand,
+- are NOT covered by dedicated pages on the top-ranking competitors,
+- can realistically rank with focused long-tail content + local pages.
+
+For each subniche return:
+1. Subniche name and the primary keyword(s) a searcher would use (incl. "near me"/"emergency" variants)
+2. Why bigger companies ignore it
+3. The buyer intent / urgency level (emergency | urgent | research)
+4. One content/conversion angle (e.g. before/after case study, pair with Google Ads)
+5. Rough difficulty to rank (low | medium | high)
+
+Return as a table, ordered by best opportunity (high intent + low competition) first.
+```
+
+## Variables
+- `{NICHE}` — the chosen niche from `niche-selection.md` (e.g. "water damage restoration").
+
+## After running
+1. Export the 10 subniches.
+2. Run `content-gap-analysis` against the top 3–5 ranking competitors to confirm none have a dedicated page.
+3. Keep the 5–10 with the weakest competitor coverage → feed into `city-matrix-and-pages.md`.