internal-linking-optimizer

1# Internal Linking Optimizer
2 
3Analyze 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.
4 
5## Stage
6 
7S6: 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.
8 
9## When to Use
10 
11- User wants to improve their site's SEO through better internal linking
12- User asks about "orphan pages", "link structure", "hub and spoke"
13- User says "internal linking", "link audit", "link equity"
14- After publishing new content — new pages need internal links within 48 hours
15- After `keyword-cluster-architect` — cluster structure defines the ideal link architecture
16- Monthly maintenance task alongside `content-decay-detector`
17 
18## Input Schema
19 
20```yaml
21site_url: string              # REQUIRED — site to analyze
22                              # e.g., "myblog.com"
23 
24pages: object[]               # OPTIONAL — known pages with their topics
25  - url: string
26    title: string
27    topic_cluster: string     # Which topical cluster it belongs to
28    is_hub: boolean           # Is this a hub page?
29 
30hub_pages: string[]           # OPTIONAL — URLs of your hub/pillar pages
31                              # Default: auto-detected
32…