Internal linking tool

What the internal linking tool does

seo internal-links crawls your site from your machine, honouring robots.txt and any crawl delay. It reads each page's main content, finds pages about the same things, and checks which of them do not link to each other yet. It works in two ways.

Each suggested link names the page to edit, the page it points to, a real sentence on that page that it fits in, and a real phrase from that sentence to use as the link text. When your Search Console account has the site, it also counts the searches both pages appear for.

Text matching or Jev

Without a key, links come from text matching: pages that use the same words, and sentences that name the target page. That finds good candidates, but it cannot tell a helpful link from a forced one, so the result says Jev was not used.

With a TypeSafe key, Jev sorts every page into a type (guide, article, tool, product page and so on), then judges each link: how likely it is to help a reader, which real sentence it belongs in, which real phrase to use, and what the link does for the reader. A link needs a probability of 50% to count as possible and 75% to count as strong. Fixed rules still apply on top, and Jev only picks among your own pages, sentences and phrases. It never writes text. The result says how many requests Jev made and what they cost.

Why internal links matter for SEO

Search engines find most pages by following links, and they read the links between your pages as a map of what matters. A page that many related pages link to looks central to its topic. A page nothing links to may not be found at all, and if it is, little tells Google it is important.

Internal links also carry meaning. The link text tells Google what the target page is about, which is why a descriptive phrase beats "click here". And they move readers: a link in the right sentence takes someone to the next thing they need, which is the reason to add it in the first place.

Orphan pages and weakly linked pages

An orphan page has no links from other pages on the site. It often happens when a page lives only in the sitemap, or when the pages that linked to it were removed. A weakly linked page has fewer than three links from other pages' main content. Navigation and footer links repeat on every page, so they say little about any one page; links in the content say much more.

The tool lists both, so you can start with the pages that need links most. If the crawl hit its page limit, it says so, because pages it did not reach could link to the ones it lists.

Build an internal linking strategy that lasts

1. Link related pages to each other. Guides on one topic should point to each other where the text calls for it, and to the page that covers the topic best.
2. Link from the content, not just the menu. A link inside a sentence that explains why to click is worth more than one more menu item.
3. Use descriptive link text. Use the words that describe the target page, as they read naturally in the sentence. Avoid using the same exact phrase every time.
4. Fix links that go through redirects. Point them straight at the final URL so readers and crawlers skip a hop.
5. Check after you publish. Run the command again, or a crawl, to confirm the links are live.

Add internal links with your AI agent

The command is built for an agent to run. Ask your agent to audit the site, read each suggestion, open the source page and add the link where it helps a reader. Your agent can then check the work with a crawl. A person approves every change. Ask:

Run seo internal-links on example.com, open the strong suggestions, and add each link to the source page in the sentence it names. Show me the diff before you save.

Install the CLI and run setup. The crawl runs from the CLI or the local MCP server:

npm i -g seo && seo start

Or add the hosted MCP server for the rest of your data and sign in with Google:

Internal linking questions