GitHub Add to your assistant
Menu

site.broken-internal-links

ErrorSEO auditcrawl

Internal links point to URLs that return 4xx/5xx or fail to load.

What to change

Fix or remove the links listed in evidence. Each entry shows the broken target and the pages linking to it.

The documentation on developers.google.com

A finding of this rule on a page carries the exact edits for that page: the markup it quotes, and what to write instead.

When it runs

Runs on a crawl or a build directory. An error is a problem that keeps a page out of search or out of answers, or breaks how it shows there. Each finding takes 15 points off the page's score.

The severity here is the rule's usual one: a finding can be raised or lowered when the page gives a reason.

Run it, or skip it

Check a page for this rule alone, after a fix for instance:

npx @rivi-software/agentic-seo-check crawl https://example.com --rule site.broken-internal-links

Or from an assistant, with the MCP tool seo_crawl_site:

{
  "url": "https://example.com",
  "rules": [
    "site.broken-internal-links"
  ]
}

To leave it out of an audit, pass --disable site.broken-internal-links on the command, or disableRules: ["site.broken-internal-links"] to a tool.

All 49 rules