Internal Link Checker — Orphans, Broken Links, Graph

In the complex landscape of modern websites, a robust internal linking structure is the backbone of effective SEO and a seamless user experience. Yet, many site owners and SEO professionals grapple with common issues: pages that go unnoticed by search engines because they're not linked internally ("orphans"), or broken links that frustrate users and waste crawl budget. Before a site launch, or ahead of a major content push, identifying and rectifying these issues is paramount.

Traditional broken link checkers only scratch the surface. You need a comprehensive tool that maps your entire internal link graph, highlighting not just broken edges but also critical structural flaws like orphaned pages. ToolYour's internal link checker provides this deep insight, empowering you to optimize your site's crawl architecture for peak performance. It's designed to give you clarity and actionable steps, whether you're performing a quick browser check or integrating a sophisticated SEO agent via our Model Context Protocol (MCP) server.

What an internal link checker does

An internal link checker goes far beyond merely scanning for 404 errors. Its primary function is to crawl your website from a designated starting URL, discover every internal link, and construct a comprehensive map of how your pages connect. This map reveals the flow of authority and relevance across your site, crucial for search engine optimization.

Key insights provided by a robust internal link checker include:

• Identification of Orphans: Pages with no internal links pointing to them, making them difficult for search engines (and users) to discover.
• Discovery of Broken Links: Internal links pointing to non-existent or inaccessible pages (404s, 500s), which degrade user experience and waste crawl budget.
• Link Graph Visualization: An understanding of which pages receive the most internal links, indicating their perceived importance within your site's structure.
• Redirect Chains: Detecting multiple redirects that slow down page loading and dilute link equity.

ToolYour's internal link checker, accessible at https://www.toolyour.com/digital-tools/internal-linking, performs this detailed analysis. It allows site owners to move beyond reactive fixes to proactive architectural improvements, ensuring every valuable page is discoverable and properly supported by your internal linking strategy.

Orphans vs broken links vs GSC

Understanding the distinct types of internal link issues and their implications is key to effective site management. While often conflated, orphaned pages and broken links represent different challenges, and relying solely on tools like Google Search Console (GSC) for these issues has specific limitations.

Orphans:

The Invisible Pages

An orphan page is any page on your website that has no internal links pointing to it from other pages on the same domain. Imagine a room in a house with no doors – you know it exists, but there's no way to get to it from within the house. For search engines, an orphan page is extremely difficult to discover and crawl because it isn't part of the interconnected web of your site.

Why orphans are bad for SEO:

• Reduced Crawlability: Search engine bots might never find these pages, or find them only via external links or sitemaps, which is inefficient.
• Lost Authority Flow: Orphan pages do not benefit from the internal link equity passed from higher-authority pages, hindering their ability to rank.
• Poor User Experience: Users cannot navigate to these pages naturally, unless they know the exact URL or find them via search results.

ToolYour's internal link checker includes a dedicated "orphan focus mode" to specifically identify these invisible pages, allowing you to quickly surface them and integrate them into your site's architecture.

Broken Links:

The Dead Ends

Broken links are hyperlinks that point to a resource (another page, image, document) that no longer exists or is inaccessible. These typically result in 404 (Not Found) or 500 (Server Error) responses when clicked.

Why broken links are bad for SEO:

• Negative User Experience: Users encounter dead ends, leading to frustration and potentially bouncing from your site.
• Wasted Crawl Budget: Search engine bots waste time and resources trying to access non-existent pages, rather than crawling valuable content.
• Diluted Link Equity: Any link equity (PageRank) that would have been passed through a broken link is lost.

While many tools, including ToolYour's specialized https://www.toolyour.com/digital-tools/broken-link-checker and https://www.toolyour.com/digital-tools/link-extractor, can identify broken links, the internal link checker provides this data within the context of your overall site structure.

Google Search Console (GSC): A Post-Discovery Report

Google Search Console is an invaluable tool for website owners, providing data on crawl errors, indexation status, and search performance. However, GSC acts more as a reporting mechanism after issues have been discovered by Google's crawlers.

Limitations of GSC for internal linking:

• Delayed Reporting: It can take days or weeks for GSC to reflect changes or identify new issues.
• Incomplete Picture: GSC primarily reports on pages Google has attempted to crawl and found issues with; it doesn't give you a real-time, comprehensive internal link graph of all your pages (especially orphans it hasn't found yet).
• No Proactive Diagnosis: GSC won't tell you why a page is an orphan or where the best place to link from is.

ToolYour's internal link checker complements GSC by offering proactive, real-time analysis before search engines encounter problems. It allows you to audit and fix your internal linking before launch or before Google's next crawl, giving you control over your site's architecture.

Run ToolYour Internal Link Checker (full vs orphan mode)

ToolYour offers flexible methods to run its internal link checker, catering to both manual, quick checks and automated, programmatic workflows. You can initiate a scan directly in your browser or integrate it into your development and SEO processes via our REST API or the Model Context Protocol (MCP).

Browser-Based Internal Link Checking

For immediate analysis or smaller sites, the browser interface is the quickest way to get started. It's free to use without requiring an account or API key for basic checks.

1. Navigate to the Tool: Go to https://www.toolyour.com/digital-tools/internal-linking.

2. Enter Start URL: Input the URL you want to begin the crawl from (e.g., https://yoursite.com/).

3. Choose Mode:

   • Full Scan: The default mode, which crawls your site thoroughly to map all internal links and identify both broken links and orphans.
   • Orphan Focus Mode: A specialized option to quickly scan for pages that are not internally linked from anywhere on your site. This is particularly useful for quickly auditing new content or checking for overlooked pages.

4. Initiate Scan: Click the "Check" or "Scan" button.

The tool will then crawl your site (up to a certain depth for browser-based free runs) and present a report detailing the link graph, identified orphans, and any broken internal links.

Programmatic Internal Link Checking via REST API

For developers and those looking to integrate internal link checking into custom scripts or applications, ToolYour offers API access. This allows for automated, scalable checks, which are essential for larger sites or continuous monitoring.

While specific direct REST API endpoints for the internal link checker are abstracted under our API-backed tool catalog, the capability is available. You interact with our API using your API key (prefixed with ty_) in the X-Api-Key header. For detailed information on calling tools via REST API, refer to https://www.toolyour.com/developers/docs/calling-tools.

Example (Conceptual HTTP Header for API calls):

GET /api/v1/tools/{tool_slug}/run HTTP/1.1
Host: api.toolyour.com
X-Api-Key: ty_YOUR_API_KEY
Content-Type: application/json

{
  "startUrl": "https://yoursite.com/",
  "mode": "full" // or "orphan"
}

Quota and Billing for API Usage: Your ToolYour account provides a shared monthly quota for both REST API and MCP usage.

• Free Plan: Includes 500 credits per month.
• Credit Cost: Tools typically cost 1–10 credits per successful call, depending on the complexity of the operation (e.g., pages crawled).
• Throughput: The free plan also allows up to 30 successful tool runs per rolling 60-second window.
• Reset: Your quota resets on the 1st of each calendar month.
• Multiple Keys: All API keys associated with your account share this same monthly credit quota.

For more details on credit consumption and upgrading your plan, visit https://www.toolyour.com/developers/docs/usage-and-plans or https://www.toolyour.com/pricing.

Fix order: orphans then broken edges

When presented with a report from an internal link checker revealing both orphan pages and broken links, a strategic approach to remediation is crucial for maximizing SEO impact and user experience. The recommended fix order prioritizes foundational crawlability and indexation before addressing secondary issues.

1. Address Orphans First:

   • Why: Orphan pages are fundamentally disconnected from your site's internal architecture. Until they are linked internally, search engines will have difficulty discovering, crawling, and assigning authority to them. They are effectively invisible in your internal link graph.
   • How: For each identified orphan page, determine its relevance and importance.
     • If the page is valuable: Find logical, topically relevant existing pages on your site to link from. Create new internal links pointing to the orphan. This could be from a relevant blog post, a category page, or an informational hub.
     • If the page is outdated or irrelevant: Consider updating it, consolidating its content with another page, or simply removing it and implementing a 301 redirect to a relevant, existing page if necessary.
   • Goal: Ensure every valuable page is reachable by at least one, and preferably multiple, internal links. This immediately improves crawlability and helps distribute link equity.

2. Fix Broken Edges (Broken Links) Second:

   • Why: While broken links are detrimental to user experience and waste crawl budget, the pages they link to (if they exist) are likely still discoverable through other valid internal links. Fixing orphans ensures pages become discoverable, whereas fixing broken links improves the path to already discoverable (or non-existent) content.
   • How: For each identified broken link:
     • Identify the correct target: If the target page moved, update the link to the new URL.
     • Remove the link: If the target page no longer exists and has no suitable replacement, remove the broken link entirely from the source page.
     • Implement 301 redirects: If a page was permanently moved or removed and there's a highly relevant replacement, implement a 301 redirect at the server level from the old URL to the new one. This preserves link equity.
   • Goal: Eliminate dead ends, improve user navigation, and ensure search engine crawlers don't waste resources on non-existent pages.

By following this order, you first ensure all valuable content is discoverable and integrated into your site's authority flow. Only then do you refine the existing pathways, ensuring they are efficient and error-free. This iterative process allows for a systematic and impactful improvement of your site's internal linking structure.

Re-check the same start URL

After diligently identifying and implementing fixes for orphan pages and broken links, the next critical step in optimizing your site's internal linking architecture is verification. Simply making changes isn't enough; you need to confirm that your adjustments have successfully resolved the issues and haven't inadvertently introduced new ones.

ToolYour's internal link checker is designed for this iterative process. You should re-check the same start URL (or the specific pages/sections you've focused on) to confirm your remediation efforts.

Here's how this verification process works:

1. Execute a New Scan: Rerun the internal link checker (via browser, REST API, or MCP agent) using the same start URL and parameters as your initial audit.

2. Review the Updated Report:

   • Orphans: Verify that the pages you linked internally are no longer appearing in the "orphan pages" list.
   • Broken Links: Confirm that the broken links you either fixed, removed, or redirected are no longer reported as errors.
   • New Issues: Scrutinize the report for any new orphans or broken links that might have been created during your previous fixes (e.g., if you accidentally linked to a wrong URL while fixing an orphan).

3. Iterate as Needed: If new issues arise or some original problems persist, return to the "Fix order" step and repeat the process until your site's internal linking graph is clean and optimized.

Each successful tool run, whether a full scan or an orphan focus check, consumes credits according to your ToolYour plan. This cost reflects the computational resources used to re-crawl and re-analyze your site, providing fresh, verifiable data. For users on the free plan, remember you have 500 credits per month, with tools costing 1–10 credits per successful call. Efficient use of re-checks ensures that your credits buy you verified evidence and progress, not just busywork.

This systematic re-checking process is vital for maintaining a healthy and performant website, especially for large or frequently updated sites where internal linking can quickly become complex.

Agents: SEO playbooks on remote MCP

For SEO and site owners who manage large, dynamic websites or want to integrate internal link optimization directly into their development and deployment pipelines, ToolYour functions as a robust remote Model Context Protocol (MCP) server for AI agents. This empowers you to automate complex SEO playbooks, moving beyond manual browser checks to continuous, intelligent site architecture management.

ToolYour exposes API-backed catalog tools to agents via MCP (API-backed tools only — not every browser-only utility). When an agent needs to perform an SEO task like an internal link check, it interacts with ToolYour using a structured plan_task → solve_task → verify_task loop.

How SEO Agents Utilize ToolYour via MCP

1. Define the Goal (plan_task): Your agent starts by outlining a high-level SEO objective. For instance, "Ensure https://yoursite.com/new-product is not an orphan page" or "Audit internal links on https://yoursite.com/ for broken links before launch." This plan_task operation is free and helps the agent strategize.

2. Execute the Task (solve_task or run_playbook): The agent then uses the solve_task method to execute a specific ToolYour tool or an entire playbook tailored for the goal. For internal link checking, this would involve invoking the underlying internal link checker capability.

   Example solve_task input for an SEO goal:

   {
     "goal": "Find all orphan pages and broken links on `https://yoursite.com/blog/` to improve crawlability.",
     "input": {
       "url": "https://yoursite.com/blog/",
       "mode": "full"
     }
   }
   

   The solve_task call sends this goal to ToolYour, which uses its internal catalog of API-backed tools to perform the necessary actions (e.g., crawling the specified URL, analyzing internal links).

3. Apply loop.nextActions and verify_task: ToolYour's response includes loop.nextActions, which might provide suggestions like patchType or roleHint on how to fix identified orphans or broken links. The host system (your agent or CI/CD pipeline) then applies these suggested fixes. After applying changes, the agent can call verify_task to confirm the problem is resolved. The loop continues until loop.gate indicates pass or loop.stop. If the goal is ambiguous, ToolYour might return status: suggest instead of executing.

   This agent loop ensures that credits are effectively used for evidence generation and re-checks, rather than busywork.

Benefits of MCP for Internal Link Management

• Automation at Scale: Automate internal link audits across thousands of pages or multiple sites.
• Continuous Monitoring: Integrate checks into CI/CD pipelines to prevent internal linking issues from ever reaching production. This is a critical "ship-gate" task.
• Targeted Fixes: Agents can be programmed to not only identify but also suggest and even implement fixes for common internal linking problems based on predefined playbooks.
• Enhanced SEO Workflow: Beyond internal links, agents can leverage the full https://www.toolyour.com/toolkits/seo-toolkit through ToolYour's MCP server, addressing other SEO concerns like meta tag analysis, page speed, or keyword checks.

To get started with setting up your SEO agent to interact with ToolYour's MCP server, refer to our comprehensive developer documentation at https://www.toolyour.com/developers/mcp and specifically for SEO agents at https://www.toolyour.com/developers/seo-agent. For examples of integrating MCP with agent frameworks, you can check resources like https://www.toolyour.com/blogs/mcp-server-for-cursor-setup or https://www.toolyour.com/blogs/mcp-server-for-claude-setup.

Remember, your API key for ToolYour works for both REST and MCP, sharing the same monthly credit quota. Browsing the MCP catalog and running plan_task are free, but solve_task and run_playbook executions consume credits (1–10 credits per successful tool call).

FAQ

Q1: What's the core difference between ToolYour's internal link checker and a basic broken link tool?

A basic broken link tool primarily identifies URLs that return a 404 or 500 error. ToolYour's internal link checker goes much further by mapping your entire site's internal link graph. This allows it to identify crucial SEO issues like orphan pages (pages with no internal links) in addition to broken links, providing a holistic view of your site's crawl architecture.

Q2: How many credits does an internal link check use on ToolYour's API?

Tools on ToolYour, including the internal link checker, cost between 1 and 10 credits per successful call. The exact number of credits depends on the scope and complexity of the check, such as the number of pages crawled and links analyzed. Your free plan includes 500 credits per month.

Q3: Can I automate internal link audits for my website?

Yes, absolutely. ToolYour offers a REST API and functions as a remote MCP server for AI agents. This allows you to programmatically run internal link checks, integrate them into CI/CD pipelines, and automate the discovery and remediation of linking issues at scale. Refer to https://www.toolyour.com/developers/mcp for details.

Q4: Does the free plan allow me to use the internal link checker?

Yes, the free plan includes 500 credits per month, which you can use for internal link checking via the browser interface, REST API, or MCP. Tools cost 1–10 credits per successful call. You also have a throughput limit of 30 successful tool runs per rolling 60-second window.

Q5: How does ToolYour's internal link checker compare to Google Search Console (GSC) for finding link issues?

ToolYour's internal link checker provides proactive, real-time insights into your site's link structure, identifying orphans and broken links before Google's crawlers encounter them. GSC, while invaluable, typically reports issues after they've been discovered by Google, often with a delay, and doesn't offer a comprehensive, real-time internal link graph for diagnosis. ToolYour empowers you to fix issues preventatively.

Q6: Can I check internal links on a staging site or a site not yet public?

Yes, as long as your staging site is accessible from the internet (even if password-protected, though you may need to configure the tool for authentication if the staging environment requires it), you can provide its URL (e.g., https://staging.yoursite.com/) to the internal link checker. This is ideal for pre-launch SEO audits.

Optimize Your Site's Foundation with ToolYour

A well-structured internal linking strategy is indispensable for strong SEO performance, user experience, and efficient crawlability. Ignoring issues like orphan pages and broken links can severely undermine your site's authority and visibility in search engine results. ToolYour's internal link checker provides the depth of analysis you need to ensure your site's architecture is robust and optimized.

Whether you're conducting a quick, manual audit via our free browser tool or integrating sophisticated SEO agents with our remote MCP server, ToolYour offers the flexibility and power to identify and address critical internal linking flaws. Prioritize the discovery and linking of orphan pages, then systematically resolve broken links, and finally, re-check your site to confirm all fixes are in place. This iterative approach guarantees a healthier, more crawlable, and more user-friendly website.

Ready to take control of your internal linking strategy?

• Perform your first internal link audit: https://www.toolyour.com/digital-tools/internal-linking
• Explore our full suite of SEO tools: https://www.toolyour.com/toolkits/seo-toolkit
• Learn how to integrate ToolYour with your AI agents: https://www.toolyour.com/developers/mcp
• Discover the power of SEO agents: https://www.toolyour.com/developers/seo-agent
• Understand our plans and credit usage: https://www.toolyour.com/pricing