AgentSkillsCN

internal-linker

分析文章内容与现有网站结构,为文章推荐并插入相关的内部链接。综合考虑语义相关性、锚文本优化与链接权重分配,避免出现孤立页面,同时构建主题集群。适用于内容撰写完成后,或在优化内部链接结构时使用。

SKILL.md
--- frontmatter
name: internal-linker
description: Analyzes article content and existing site structure to suggest and insert relevant internal links. Considers semantic relevance, anchor text optimization, and link equity distribution. Prevents orphan pages and creates topic clusters. Use after writing content or when optimizing internal link structure.

Internal Linker

Intelligente interne Verlinkung basierend auf Content-Analyse und Seitenstruktur.

Quick Start

code
Input: Artikel-Content + Bestehende Artikel-Datenbank
Output: Link-Vorschläge mit Anchor-Text + optimierter Content

Workflow

  1. Artikel-Inventar laden → Alle bestehenden URLs + Titles + Topics
  2. Neuen Content analysieren → Themen, Keywords, Entities extrahieren
  3. Semantische Matches findenSEMANTIC_ANALYSIS.md
  4. Link-Stellen identifizieren → Natürliche Ankerpunkte im Text
  5. Anchor-Text optimierenANCHOR_TEXT_STRATEGIES.md
  6. Link-Struktur validieren → Keine Orphan Pages, ausgewogene Verteilung
  7. Links einfügen → Mit optimiertem Anchor-Text

Output Format

json
{
  "article_id": "uuid",
  "internal_links": {
    "outbound": [
      {
        "target_url": "/artikel-xyz",
        "target_title": "Zielartikel Titel",
        "anchor_text": "optimierter Anchor Text",
        "position": {
          "paragraph": 3,
          "context": "...Text vor [LINK] Text nach..."
        },
        "relevance_score": 0.85,
        "reason": "Thematisch verwandt: beide über Content Marketing"
      }
    ],
    "inbound_suggestions": [
      {
        "source_url": "/anderer-artikel",
        "source_title": "Quell-Artikel Titel",
        "suggested_anchor": "Anchor für Link hierher",
        "reason": "Erwähnt [Thema], sollte hierher verlinken"
      }
    ]
  },
  "orphan_page_warnings": [],
  "link_equity_analysis": {
    "pages_linking_here": 5,
    "pages_this_links_to": 8,
    "status": "balanced"
  }
}

Link-Typen

TypBeschreibungPriorität
ContextualIm Fließtext, thematisch relevantHoch
Related"Weitere Artikel" SectionMittel
NavigationKategorien, TagsNiedrig
CTA"Mehr erfahren" LinksMittel

Relevanz-Kriterien

Links werden vorgeschlagen basierend auf:

  1. Thematische Übereinstimmung (40%)

    • Gleiche/ähnliche Hauptkeywords
    • Überlappende Topics
  2. Semantische Nähe (30%)

    • Entity-Matching (Personen, Produkte, Konzepte)
    • LSI-Keywords
  3. User Intent Match (20%)

    • Gleiche Suchintention
    • Logische Weiterführung
  4. Link-Struktur (10%)

    • Seite braucht mehr Links (Orphan Prevention)
    • Wichtige Seite verdient mehr Links

Anchor-Text Regeln

DO ✅

  • Beschreibend und natürlich
  • Keyword-relevant aber nicht stuffed
  • Variiert (nicht immer gleicher Anchor)
  • Im Kontext sinnvoll

DON'T ❌

  • "Hier klicken"
  • "Mehr erfahren" (als einziger Anchor)
  • Exact-Match-Keyword-Stuffing
  • Zu lange Anchors (>5 Wörter)

Details: ANCHOR_TEXT_STRATEGIES.md

Orphan Page Prevention

Jede Seite sollte:

  • Mind. 3 interne Links erhalten
  • Mind. 3 interne Links ausgeben
  • Innerhalb von 3 Klicks von Homepage erreichbar sein

Integration

Mit Supabase

typescript
// Alle Artikel laden
const { data: articles } = await supabase
  .from('articles')
  .select('id, title, slug, content, seo_keywords')
  .eq('status', 'published');

// An Internal Linker übergeben
const linkSuggestions = await internalLinker.analyze(newArticle, articles);

Output anwenden

typescript
// Links in Content einfügen
const linkedContent = internalLinker.applyLinks(
  article.content,
  linkSuggestions.outbound
);

Checkliste

  • Alle bestehenden Artikel geladen?
  • Mind. 3 ausgehende Links pro Artikel?
  • Anchor-Texte variiert?
  • Keine Orphan Pages entstanden?
  • Links thematisch sinnvoll?
  • Link-Verteilung ausgewogen?