# SEO Content Brief Agent

> An SEO brief agent that builds content briefs from real SERP analysis — intent, structure, subtopics, questions — without fabricating metrics or promising rankings.

- **Category:** SEO & Growth
- **Difficulty:** Intermediate
- **Setup time:** 40 min
- **Stacks:** Claude, LangGraph, OpenAI
- **Version:** 2.0.0 (updated 2026-06-21)
- **Source:** https://agent-kits.com/kit/seo-brief-generator

## Overview

Builds a content brief from real SERP analysis: search intent, structure, subtopics, entities, and related questions.

Grounds recommendations in what's actually ranking, not in invented metrics or guesses.

Flags ambiguous intent (e.g. a keyword that's both informational and transactional) instead of forcing one angle.

Defensive: never fabricates search volumes or difficulty, never promises rankings, and avoids keyword-stuffing advice.

## When to use it

- You brief writers and want consistent, intent-aligned content briefs fast.
- You have SERP/keyword data the agent can ground recommendations in.
- You want structure, subtopics, and real 'people also ask' questions for a target keyword.
- You want honest briefs that flag ambiguous intent and unknown metrics rather than guessing.

## When not to use it

- You want guaranteed rankings or invented search volumes — it won't provide either.
- You have no SERP/keyword data, so recommendations would be ungrounded.
- You want it to write the full article rather than a brief (different tool).
- You expect keyword-stuffing or manipulative tactics.

## Architecture

- **Keyword intake** — Receives the target keyword and any provided keyword/SERP data to ground the brief.
- **SERP analysis** — Examines what actually ranks — content types, dominant angle, and 'people also ask' — as the basis for the brief.
- **Intent classification** — Classifies the search intent from the SERP evidence, flagging mixed or ambiguous intent rather than forcing one.
- **Structure & subtopics** — Recommends a heading structure and the subtopics/entities to cover, grounded in the ranking content and intent.
- **Metric honesty gate** — Uses search volume/difficulty only when provided and marks anything else 'unknown', blocking fabricated numbers.
- **Questions & links** — Surfaces real related questions and relevant internal-link ideas to make the brief actionable.
- **Brief output** — Assembles the brief with cautions (ambiguities, unknown metrics, and an explicit no-ranking-guarantee note).

## Files in this bundle

- `system-prompt.md` — the agent's system prompt
- `tools.json` — tool/function definitions the agent expects
- `workflow.md` — step-by-step run loop
- `.env.example` — environment variables to fill in
- `kit.json` — full structured metadata
- `starters/` — minimal starter snippets
- `LICENSE` — Apache-2.0 (code, configuration, and schema)
- `LICENSE-CONTENT` — CC BY 4.0 (specification text and documentation)
- `NOTICE` — attribution and trademark notice
- `run.py` — **runnable demo**: real agent loop with mock tools (`pip install anthropic`, set `ANTHROPIC_API_KEY`, `python run.py`)
- `agentaz.json` / `agentaz.schema.json` — AgentAz™ governance spec + schema

## Implementation notes

- Never fabricate search volume, difficulty, or traffic; use provided data or mark it 'unknown' and point to connecting a real data source — invented metrics drive bad content bets.
- Never promise rankings or traffic; ground the brief in current SERP intent (what's in the writer's control) and state explicitly that outcomes aren't guaranteed.
- Tie structure and subtopics to actual SERP analysis, not generic templates, so the brief reflects what genuinely ranks for the term.
- Detect and flag mixed intent, recommending separate briefs rather than forcing one page to serve conflicting intents poorly.
- Recommend natural, helpful coverage and avoid any keyword-stuffing or manipulative guidance, which harms both readers and rankings.
- Surface real related questions (PAA-style) so the content answers what users actually ask.
- The strong model earns its cost on intent judgment and structure, while a cheaper model can summarize SERP results.

## Variations

- **Basic — Brief outliner:** Produces intent, a recommended structure, and subtopics for a keyword grounded in SERP analysis. On demand, single keyword.
- **Advanced — SERP-grounded brief:** Adds mixed-intent detection, real related questions, internal-link ideas, honest metric handling, and explicit cautions.
- **Enterprise — Content strategy at scale:** Adds keyword-cluster briefs, data-source integration for real metrics, content-gap analysis, internal-link mapping, and workflow integration with your CMS and writers.

## FAQ

**Will it tell me a keyword's search volume?**

Only if you provide a keyword data source — then it reports the real number. If no data is available, it marks the metric 'unknown' rather than inventing a figure, because a fabricated volume leads to bad content decisions.

**Can it guarantee I'll rank?**

No, and it will say so. Rankings depend on competition, domain authority, and many factors a brief can't control. It aligns the content with current search intent — the part that's actually in your control — without promising a position.

**How does it decide structure and subtopics?**

By analyzing what actually ranks for the keyword: the dominant angle, content types, and the questions people ask. The recommendations are grounded in the real SERP, not a generic template.

**What if a keyword has mixed intent?**

It flags the intent as mixed, explains the evidence from the SERP, and typically recommends splitting into separate briefs (for example, informational and commercial) rather than forcing one page to serve both poorly.

**Does it recommend keyword stuffing?**

No. It recommends natural, genuinely helpful coverage of the topic and related entities, and avoids manipulative tactics like unnatural keyword density that hurt both readers and rankings.

**Does it write the article too?**

It produces the brief — intent, structure, subtopics, and questions — for a writer to work from. Generating the full article is a separate step; the brief keeps the human writer in control of the final content.


---

© 2026 AgentKits · www.agent-kits.com

**Open source.** Code, configuration, and the AgentAz™ schema are licensed under
**Apache-2.0**; specification text and documentation under **CC BY 4.0** (with
attribution to AgentKits, link to https://www.agent-kits.com). See LICENSE, LICENSE-CONTENT,
and NOTICE in this bundle. "AgentAz" and "AgentKits" are trademarks of AgentKits.

**Flagship reference blueprint.** View the source, AgentAz™ spec, and frozen v1.0 schema
in the public registry: https://github.com/agent-kits/agentaz
Original: https://agent-kits.com/kit/seo-brief-generator
