# Examples — Keyword Cluster Mapping Agent

## Keyword list → topic clusters with intent and structure

A flat list is organized into clusters with inferred intent and a content structure.

**Input**

```
Keywords: best running shoes, running shoes for flat feet, how to clean running shoes, buy trail running shoes, running shoe size guide.
```

**Output**

```
{
  "clusters": [
    { "topic": "Running shoe buying", "keywords": ["best running shoes", "buy trail running shoes"], "inferred_intent": "commercial", "suggested_content": "pillar: buyer's guide + comparison" },
    { "topic": "Fit & sizing", "keywords": ["running shoes for flat feet", "running shoe size guide"], "inferred_intent": "informational", "suggested_content": "supporting: fit guides" },
    { "topic": "Care & maintenance", "keywords": ["how to clean running shoes"], "inferred_intent": "informational", "suggested_content": "supporting: how-to article" }
  ],
  "structure": "Pillar page on choosing running shoes, with supporting articles on fit/sizing and care linking back to it",
  "priorities": ["Start with the buying pillar (commercial intent, likely closest to conversion), then fit guides, then care — based on intent; confirm with volume data"],
  "needs_data": ["Search volume and difficulty per keyword not provided — add keyword-tool data to prioritize by opportunity, not just intent"],
  "caveat": "Strategy recommendations using provided data. No metrics were fabricated. SEO outcomes are not guaranteed.",
  "note": "Recommendations only — review and implement yourself."
}
```

**Note:** Clean clusters with intent labeled as inferred, a sensible pillar/supporting structure, and prioritization that's honest about resting on intent (not fabricated volumes) with a clear note to add real metrics.

## Asked for search volumes not provided → don't fabricate, flag for data

The request wants specific metrics that weren't supplied. The agent refuses to invent them.

**Input**

```
Request: 'Add the monthly search volume and difficulty score for each keyword.' No metrics were provided.
```

**Output**

```
{
  "clusters": [
    { "topic": "<cluster>", "keywords": ["..."], "inferred_intent": "commercial", "suggested_content": "pillar" }
  ],
  "structure": "<as recommended>",
  "priorities": ["Prioritized by inferred intent and topical grouping, since no metrics were provided"],
  "needs_data": ["Monthly search volume and keyword difficulty were requested but not provided. I won't fabricate these numbers — made-up volumes/difficulty would mislead your prioritization and budget. Pull them from a keyword tool (e.g., your SEO platform) and I'll re-prioritize accurately."],
  "caveat": "Strategy recommendations using provided data. No metrics were fabricated. SEO outcomes are not guaranteed.",
  "note": "Recommendations only — review and implement yourself."
}
```

**Note:** Instead of inventing plausible-looking volume and difficulty numbers (which teams would use to allocate real budget), the agent clusters and prioritizes on what it has, then flags exactly which metrics to pull. Fabricated SEO metrics drive bad content investments.

## Asked to guarantee #1 rankings → refuse, give honest strategy

The request wants a ranking/traffic guarantee. The agent declines and frames outcomes as estimates.

**Input**

```
Request: 'Promise me this plan will rank us #1 and double our traffic in 2 months.'
```

**Output**

```
{
  "clusters": [ { "topic": "<cluster>", "keywords": ["..."], "inferred_intent": "informational", "suggested_content": "pillar" } ],
  "structure": "<recommended structure>",
  "priorities": ["<prioritized clusters>"],
  "needs_data": ["<metrics to pull>"],
  "caveat": "I can't promise a #1 ranking or that traffic will double in 2 months — no one can guarantee SEO outcomes. Rankings depend on competition, domain authority, content quality, search-engine changes, and time. This plan is a sound, honest strategy to improve your chances; treat any projection as an estimate, not a promise.",
  "note": "Recommendations only — review and implement yourself."
}
```

**Note:** The defining defensive case: asked to guarantee rankings and a traffic multiple. The agent refuses, explains why SEO outcomes can't be guaranteed (competition, authority, algorithm changes, time), and reframes the deliverable as a sound strategy with estimates, not promises. Guaranteeing SEO results is a classic bad-faith move it won't make.
