/link-opportunities

name: link-opportunities
description: >
  Plan off-page authority for a brand — find and prioritize backlink opportunities from
  its topical map and competitor set, with a safe anchor-text mix and a competitor
  backlink-gap worksheet. Use whenever the user mentions backlinks, link building, off-page
  SEO, domain authority, digital PR, guest posts, "who should link to us", getting into
  best-of listicles, or why competitors outrank despite thinner content. Discovers real
  prospects via web_search (T1) or DataForSEO backlinks (T2); never invents authority
  numbers, referring domains, or contact emails. Triggers on off-page / link intent broadly.

link-opportunities

The authority layer the content engine omits. A perfect map on a zero-authority domain still loses to funded incumbents — this plans the external links (and the citations that travel with them) that make ranking possible. It reads the same brand workspace, respects the tier, and tags every prospect's provenance.

Read first: `../../framework/off-page-authority.md` (plays, anchor rules, the honesty line), then `../../framework/eeat-signals.md` (why off-site entity consistency matters).

Preconditions

• `entity-profile.json` (competitors drive the backlink gap) + `topical-map.json`.
• Prospect *discovery* needs `web_search: true` (T1) or `dataforseo: true` (T2). At T0 the

skill produces the plan, plays, and anchor mix but cannot name real prospects — say so; do not invent domains.

Workflow

1. **Build the plan skeleton (T0, offline).**

   python ../../scripts/link_prospects.py --map brands/<slug>/topical-map.json \
     --entity-profile brands/<slug>/entity-profile.json --brand "<Brand>" \
     --out brands/<slug>/outreach/link-plan.md

Emits, per node (priority-ordered core→outer): the fitting plays, an off-page anchor mix, and a competitor backlink-gap worksheet. Priorities are `derived`; play notes are `asserted`.

2. **Discover real prospects.**

• **T1 (web_search):** for top-priority commercial nodes, search the target query +

"best/ alternatives/ vs" and record the listicles/reviews that already rank — inclusion targets. For each competitor, search their brand + "review / integration / alternative" to surface sites already covering the category.

• **T2 (DataForSEO backlinks):** pull each competitor's referring domains, filter for

topical relevance, and rank the gap. Authority numbers here are `measured`.

• Record every prospect with: URL, why-relevant, authority (`measured` **or** left

blank — never guessed), the node it supports, and the play. Score with `link_prospects.py:score_prospect` (unknown authority scores on relevance + link type, flagged unknown).

3. **Write the outreach queue** → append to `brands/<slug>/outreach/link-plan.md`:

• Ranked prospect table (prospect · node · play · authority[measured|unknown] · angle).
• Suggested anchor per placement, drawn from the node's anchor examples, honoring the

mix (keep exact-match ~10%).

• **No fabricated contacts.** If you can't find a real, published contact, mark it

"contact: research needed" — do not invent an email.

4. **Feed the loop.**

• A high-priority node with no realistic prospects → recommend building a *linkable

asset* for it (free tool / data study), not low-value link spam.

• Queries where competitors are linked/cited and the brand is absent → shared signal

with **answer-engine-optimizer**.

• When a link lands, record the URL on the node; it raises that node in

**seo-performance-tracker**.

Definition of done

• `link-plan.md` written: anchor mix, competitor gap worksheet, priority-ordered plays.
• If T1/T2 on: a ranked prospect queue with provenance on every authority value and no

invented domains or emails. If T0: the plan only, with an explicit note that discovery needs web_search/DataForSEO.

• Nothing fabricated — the whole point of doing this inside the suite.

Grounding ladder

• **T0:** offline plan skeleton, plays, anchor mix, competitor worksheet. Useful alone.
• **T1 (web_search):** + real listicle/review/resource prospects, `measured` + dated.
• **T2 (DataForSEO):** + competitor backlink-gap with `measured` authority numbers.