link-prospecting
π―SkillFinds websites, pages and authors that might link to your page or product, then looks up public ways to contact them. It drafts outreach messages and saves the findings as a report in OpenSEO.
Installation
npx skills add every-app/open-seo --skill link-prospectingRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/link-prospectingInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/link-prospecting/ - All projects
~/.claude/skills/link-prospecting/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βFind link prospects, discover contact paths, and draft outreach from SERPs and backlink signals.
OpenSEO Link Prospecting
Goal
Find realistic pages, sites, and authors that might reference the user's page, product, study, guide, or tool. Use OpenSEO for prospect discovery, then use available web/search/browser tools for contact discovery.
Required inputs
projectId- User domain or target URL
- Linkable asset, page, product, study, tool, or topic
- Optional competitors
- Optional market/location/language
Project context
The project-context tools are free and shared with the app and other agents.
- Call
get_project_contextfirst and ground the outreach in it β positioning supplies the claim that makes a link worth giving, and the saved competitors are the backlink profiles to mine. - This skill needs
positioningand competitors. If either is empty, run a minimal inline setup: ask the user why someone would cite them and who they compete with, or infer from the site andfind_serp_competitorsand confirm, write it back withupdate_project_context, then continue the prospecting. Never front-load the full interview; suggestseo-project-setupat the end for the rest. - Before spending credits, check the research log. If the same research ran within the last 30 days, reuse that result and say so instead of re-buying it.
- On finish, write back what is durable β the linkable asset via
addKeyPages, any competitor whose backlink profile proved useful viaaddCompetitorsβ and append a research log entry:{ appendResearchLog: { summary: "Link prospecting: <asset/target page>. Verdict: <conclusion>" } }.
Deliver as a report
Deliver through the seo-report skill, saving with skill: "link-prospecting". If that skill is not available, say so and stop before writing HTML.
OpenSEO MCP tools
get_serp_results: find ranking articles, listicles, resource pages, comparisons, and topical publishers.get_backlinks_overview: inspect competitor domain or page backlink/referring-domain patterns.get_domain_overview: qualify important prospect domains.get_ranked_keywords: understand what a prospect or competitor ranks for when topical fit matters.search_local_businessesandget_local_serp_results: use for local SEO link prospecting when nearby businesses, local competitors, or Maps/category signals can reveal partnership targets.research_keywords: expand prospecting queries.
Contact discovery tools
After OpenSEO identifies good prospects, use available non-OpenSEO browsing or search tools for public contact discovery. Depending on the client, this may be web search, page fetches, browser automation, or a search API.
Look for:
- Author byline pages
- Contact pages
- Editorial guidelines
- About/team pages
- LinkedIn, X, Bluesky, or other professional profiles
- Newsletter or publication masthead pages
- Public email addresses in page HTML or visible page text
- Structured data such as
Person,Organization,sameAs, oremail
Only record contact details that were actually found. Include the source URL for any email, profile, or contact form.
Prospecting query patterns
Build queries from the asset/topic:
<topic> resourcesbest <category> tools<competitor> alternatives<topic> statistics<topic> guide<topic> examples<topic> templates<topic> software<topic> for <audience>
Use get_serp_results in batches for the most relevant patterns. Send at most 10 queries per call.
Workflow
- Clarify the linkable asset and the reason someone would reference it.
- Build 5-10 prospecting queries by default.
- Call
get_serp_resultsfor those queries. - If competitors are provided, call
get_backlinks_overviewfor the strongest competitor domains or pages first. Continue without backlink evidence if it is unavailable. - For local SEO, use
search_local_businessesandget_local_serp_resultsaround priority locations to identify nearby competitors, categories, and local SERP evidence before searching for local chambers, associations, campus resources, community pages, and directories. - Filter prospects:
- Keep topical relevance and editorial pages.
- Prioritize articles, directories, resource pages, comparisons, statistics pages, templates, and curated lists.
- Deprioritize homepages, login pages, thin affiliate pages, spam, unrelated forums, and direct competitors unless a comparison angle is valid.
- For each good prospect, define the outreach angle:
- Broken/missing resource
- Better current data
- Useful tool/template
- Alternative or comparison inclusion
- Expert quote or supporting reference
- For the strongest prospects, visit or search the prospect site to find the best contact path.
- Draft outreach messages. If contact details were found, include the source. If not, list the next best contact-discovery path.
Output format
h1: the linkable asset.
If a report template applies (see seo-report), its sections and tone replace this list.
Sections in this order:
- The angle β one or two opening sentences naming the best outreach angle and the prospect type to work first.
- Prospects β a table of prospect URL, site, source, suggested angle, contact path, and priority. Keep it under about eight columns; drop the ones that add nothing for this run.
- Why these β one finding per prospect worth explaining: the evidence that they link to things like this, then the exact ask.
- Outreach drafts β the message text for each of two or three reusable angles: resource or list inclusion, an article update, and a comparison mention.
- Limitations β notes: contact paths not found, prospects that are direct competitors or likely paid placements, and which source found each contact detail.
- What to do next β an ordered list: who to send to first, and in what order.
- How this report was made β opens with the skill link line from
seo-report, pointing athttps://openseo.so/docs/skills/link-prospecting("OpenSEO Link Prospecting skill"), then which tools returned prospects and which came from the web or the browser.
Guardrails
- Do not invent email addresses, social handles, or contact names.
- Do not say OpenSEO found contact details unless an OpenSEO tool returned them. Attribute contact discovery to the web/search/browser source used.
- If contact details are not available after a reasonable search, recommend specific discovery steps such as checking the author page, contact page, LinkedIn, X, or a reputable contact-enrichment tool.
- Avoid spammy mass outreach. Personalize by page and reason.
- Flag prospects that are direct competitors or likely paid placements.
More from this repository10
OpenSEO is an open-source tool for improving how your website shows up in search results, as a cheaper option to Semrush or Ahrefs. Your AI agent can use its data to do keyword research, track rankings and check your site.
Helps you find search words worth targeting for your website using OpenSEO data. It checks how often people search them and how hard they are to rank for, saves the good ones, and delivers a report.
Studies one competitor's website to see how it gets visitors from search engines. It looks at the search words it ranks for, its topics and links from other sites, then shows gaps you can use, in an OpenSEO report.
Groups search words by what people are looking for and decides which page on your site should target each group. It uses OpenSEO tools and delivers the plan as a report.
A friendly coach for OpenSEO that explains how to get your site found in search engines in plain words. It reads your project details, suggests one clear next step, and points you to a fuller report when you want more depth.
Shows who wins the most search traffic in your market, what content works for them, and where openings remain for you. It uses OpenSEO data and delivers the result as a saved report.
Interviews you once about your website's search goals, competitors, key pages and writing preferences, and saves the answers in your OpenSEO project. Other OpenSEO skills then reuse this information in later sessions.
Gets a code branch ready for the project maintainer's final review. It checks for security problems, needless complexity, and ways to get paid features for free, fixes real issues, runs the checks, and opens or updates the pull request without merging it.
Prepares a new release of the OpenSEO project from start to finish. It raises the version number, writes short release notes from the changes since the last release, double-checks them, and opens a pull request.
Skill