SEO Aeo Internal Linking

{
  "pages": [
    {
      "title": "string — page or post title",
      "url": "string — URL if published, leave blank if not yet live",
      "primary_keyword": "string — the keyword this page targets",
      "page_type": "pillar | cluster-article | landing-page |
                    blog-post | product-page",
      "content_summary": "string — 1-2 sentences describing the page"
    }
  ],
  "focus_page": "string — title of the page you most want to
                  boost with incoming links",
  "cluster_context": "string — optional, paste content cluster
                       output to inform link map",
  "product_pages": ["string — product, signup, pricing, or demo pages that should receive relevant CTAs"],
  "audit_findings": "string — optional orphan, cannibalization, or priority findings"
}

# Internal Linking Report

## Summary

| Metric                          | Value      |
|---------------------------------|------------|
| Total Pages Analysed            | [n]        |
| Total Link Opportunities Found  | [n]        |
| Orphan Pages Detected           | [n]        |
| Cannibalization Risks           | [n]        |
| Focus Page Incoming Links       | [n]        |
| Pages Exceeding Link Limit      | [n]        |

---

## Orphan Page Alert

Pages with no incoming internal links — these are invisible
to search engines and must be linked immediately:

| Page Title                  | URL                  | Fix                              |
|-----------------------------|----------------------|----------------------------------|
| [title]                     | [url or "unpublished"]| Link from [suggested source page]|

---

## Link Opportunities

Listed in priority order — highest impact first.

---

### 🔴 High Priority — Do These First

**Link [n]**
| Field              | Value                                             |
|--------------------|---------------------------------------------------|
| Link Type          | [Cluster → Pillar / Pillar → Cluster / etc]       |
| Source Page        | [title]                                           |
| Target Page        | [title]                                           |
| Anchor Text        | [suggested anchor text]                           |
| Anchor Type        | Partial match / Exact match / Branded             |
| Placement          | [Where in the source page — intro / body / CTA]   |
| Context Sentence   | "[Write the sentence the anchor should appear in, |
|                    |  with anchor text in brackets like [this]]"       |
| Impact             | [Why this link matters for SEO or AEO]            |

---

**Link [n]**
[same format]

---

### 🟡 Medium Priority — Do These Second

**Link [n]**
[same format]

---

### 🟢 Low Priority — Polish Round

**Link [n]**
[same format]

---

## Cannibalization Risks

Anchor text conflicts that could confuse search engines:

| Anchor Text Used    | Used On              | Points To            | Fix                        |
|---------------------|----------------------|----------------------|----------------------------|
| [anchor]            | [source page title]  | [target page title]  | [alternative anchor text]  |

If none detected: ✅ No cannibalization risks found.

---

## Link Equity Map

Visual representation of how authority flows across the content:

[Focus Page / Pillar: {page title}]
    ↑ receives links from:
    ├── [Cluster Article 1] — anchor: [text]
    ├── [Cluster Article 2] — anchor: [text]
    └── [Cluster Article 3] — anchor: [text]

    ↓ sends links to:
    ├── [Cluster Article 1] — anchor: [text]
    └── [Cluster Article 2] — anchor: [text]

Cross-links between cluster articles:
    [Article 1] ↔ [Article 3] — anchor: [text]
    [Article 2] → [Article 4] — anchor: [text]

---

## Links Per Page Check

| Page Title          | Incoming Links | Outgoing Links | Status                          |
|---------------------|----------------|----------------|---------------------------------|
| [title]             | [n]            | [n]            | ✅ Healthy / ⚠️ Too many outgoing|

**Rule:** No page should have more than 100 outgoing internal links.
**Rule:** Focus page should have the highest incoming link count.

---

## Action Checklist

- [ ] All orphan pages have been linked
- [ ] Every cluster article has a Cluster → Pillar link
- [ ] No exact-match anchor used more than once per target
- [ ] No generic anchors ("click here", "read more") present
- [ ] Focus page has the highest incoming link count
- [ ] No page exceeds 100 outgoing internal links
- [ ] Cannibalization risks resolved