# Setup guide — SEO Content Brief Agent

## 1. Install and connect SEO data

Install the agent and connect your SERP/keyword data source.

```
pipx install seo-brief-agent
seo-brief-agent connect --serp serpapi --keywords gsc
seo-brief-agent doctor
```

## 2. Configure honesty guardrails

Enforce no fabricated metrics and no ranking promises.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
METRICS_FROM_SOURCE_ONLY=true
NO_RANKING_GUARANTEES=true
GROUND_IN_SERP=true
```

## 3. Set brief template

Define the brief structure your writers expect.

```
# brief.yml
sections: [intent, serp_summary, structure, subtopics, related_questions, internal_links, cautions]
flag_mixed_intent: true
```

## 4. Generate a brief

Produce a brief and review intent, structure, and cautions.

```
seo-brief-agent run --keyword 'best running shoes for flat feet' --explain
# prints intent, SERP summary, structure, subtopics, PAA, cautions
```

## 5. Wire into your workflow

Generate briefs from your keyword queue and hand them to writers.

```
# keyword queue -> brief -> content doc for the writer (metrics sourced or 'unknown')
```
