# Setup guide — Keyword Cluster Mapping Agent

## 1. Install and configure

Install the agent and set defaults.

```
pipx install keyword-cluster-agent
keyword-cluster-agent init
keyword-cluster-agent doctor
```

## 2. Configure guardrails

No fabricated metrics and no guarantees are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
NO_FABRICATED_METRICS=true
NO_RANKING_GUARANTEES=true
LABEL_INTENT_AS_INFERRED=true
```

## 3. Provide keywords

Supply your keyword list (with metrics if you have them).

```
# keywords.csv  (volume/difficulty optional; flagged if absent)
keyword,volume,difficulty
best running shoes,,
running shoes for flat feet,,
```

## 4. Run clustering

Cluster and review intent, structure, and data gaps.

```
keyword-cluster-agent run --keywords ./keywords.csv --explain
# prints clusters + inferred intent + structure + needs_data (no fabricated metrics)
```

## 5. Wire into content ops

Turn keyword lists into content plans for review.

```
# keyword list -> clusters + structure -> content team prioritizes and creates
```
