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.