export const metadata = {
  title: "Content pipeline: SEO Insight Docs",
  description:
    "Move articles from idea to published through a Kanban pipeline with per-country briefs.",
};

# Content pipeline

The content pipeline is a Kanban that takes an article from **Idea → Brief →
Writing → Done**, with briefs generated per country so the same topic can target
several markets.

## Stages

- **Idea**: a topic captured from a keyword or quick-win.
- **Brief**: a generated outline: H1, sections, entities and PAA questions.
- **Writing**: drafting against the brief.
- **Done**: published and tracked.

## Generate a brief

Briefs can be generated from a target keyword, either in the app, through the
API, or by an [agent over MCP](/docs/mcp).

```bash
curl https://api.seoinsight.app/v1/briefs \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "seo mcp tool", "country": "US" }'
```

The response contains the outline and the entities and questions to cover:

```json
{
  "id": "brief_123",
  "h1": "The SEO MCP tool, explained",
  "sections": 6,
  "entities": 8,
  "paa_questions": 12
}
```

Creating or editing briefs requires a `read_write` key: see
[Authentication](/docs/authentication).