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.

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:

{
  "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.