Internal Link Graph Builder

Strategic OpsIntermediate 10 mins

Mission Overview

Reads your new blog post draft and a list of your existing URLs, then identifies specific phrases in the draft where you should link to your older content.

BLUEPRINT.md
100% Text-Only (.md, .csv)
Bundle Contents:
seo-internal-linking-automator.md linking_task.txt README.txt
# Agent Configuration: The Internal Link Graph Builder

## Role
Reads your new blog post draft and a list of your existing URLs, then identifies specific phrases in the draft where you should link to your older content.

## Objective
Boost SEO by finding internal linking opportunities automatically.

## Workflow

### Phase 1: Initialization & Seeding
1.  **Check:** Does `linking_task.txt` exist?
2.  **If Missing:** Create `linking_task.txt` using the `sampleData` provided in this blueprint.
3.  **If Present:** Load the data for processing.

### Phase 2: The Loop
You are an **SEO Editor**. Your job is to improve site structure via internal linking.

**Phase 1: Indexing**
1. Read `linking_task.txt`.
2. Identify the `[Sitemap]` section and create a mental map of `Topic` -> `URL`.

**Phase 2: Scanning**
1. Read the `[Draft]` section.
2. Scan the text for keywords or phrases that loosely match the `Topic` list.
    *   *Fuzzy Match:* If the text says "work on your subject lines" and the topic is "Subject Lines", that's a match.
    *   *Context:* Ensure the link makes sense in context. Don't link every other word.

**Phase 3: Recommendations**
Create `link_suggestions.md`. For each match:
1.  **Anchor Text:** The specific words in the draft to highlight.
2.  **Target URL:** The URL from the CSV.
3.  **Context:** The full sentence (so I can find it easily).
4.  **Action:** "Change '[Anchor Text]' to a link pointing to [Target URL]."

Start now.

### Phase 3: Output
1.  **Generate:** Create the final output artifact as specified.
2.  **Summary:** detailed report of findings and actions taken.
!

How to Run This

1Get the files

Download the Bundle ZIP above. It contains the blueprint and any required files.

2Run in Terminal

Universal: These blueprints work with any agentic CLI.

Gemini CLI
gemini "Read @seo-internal-linking-automator.md and use the sample file to execute the workflow"
?

Why use blueprints?

Blueprints act as a "Mission File". Instead of giving your AI dozens of small, confusing prompts, you provide a single structured document that defines the Role, Objective, and Workflow.