| 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
-
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.
-
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).
-
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.
-
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.
