Internal Linking Optimizer

Analyze your site's internal link structure and generate an optimized hub-and-spoke linking plan. Finds orphan pages (no internal links pointing to them), identifies link equity bottlenecks, and creates specific linking instructions to maximize SEO impact.

Stage

S6: Analytics & Optimization, This is analytics/audit work on existing content. Internal linking is the most underutilized SEO lever, it's 100% in your control and costs nothing.

When to Use

• User wants to improve their site's SEO through better internal linking
• User asks about "orphan pages", "link structure", "hub and spoke"
• User says "internal linking", "link audit", "link equity"
• After publishing new content, new pages need internal links within 48 hours
• After keyword-cluster-architect, cluster structure defines the ideal link architecture
• Monthly maintenance task alongside content-decay-detector

Input Schema

site_url: string              # REQUIRED, site to analyze
                              # e.g., "myblog.com"

pages: object[]               # OPTIONAL, known pages with their topics
  - url: string
    title: string
    topic_cluster: string     # Which topical cluster it belongs to
    is_hub: boolean           # Is this a hub page?

hub_pages: string[]           # OPTIONAL, URLs of your hub/pillar pages
                              # Default: auto-detected

new_pages: string[]           # OPTIONAL, recently published pages needing links
                              # Default: none

Chaining from S3 keyword-cluster-architect: Use keyword_clusters.hub and keyword_clusters.clusters to define ideal link architecture.

Workflow

Step 1: Discover Site Structure

1. web_search: site:[site_url], discover indexed pages
2. Map pages to topic clusters (if not provided)
3. Identify current hub pages (pages that link to many others)
4. Note orphan pages (pages with few/no internal links pointing to them)