create_content_brief
Generate an evidence-grounded content brief for one tracked prompt: it reads the recent answers for the prompt, the pages the engines cited and the searches they ran, checks the brand's own Search Console (when connected) for a page already within Google's top 20 for those searches, and writes a page plan (target question, recommendations, structure, schema to add, and proof to include: the kind of proof and its genuine source, never a figure to publish) with the evidence and a refresh-or-new verdict. When the recent answers show no real gap, it says so instead of writing a brief. It spends AI on the workspace's own key or Managed AI, not against the scan allowance. Requires write actions and "Allow actions that spend AI"; counts toward 20 assistant-started scans, briefs and rankings refreshes per workspace per day. Without confirm:true it returns a preview. Saved briefs are read with get_content_brief.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"promptId": "<promptId>"
},
"name": "create_content_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | With search: only answers of prompts carrying this tag. | |
| days | No | With search: the window in whole UTC days (default 30). | |
| engine | No | With search: only that engine's answers (the channel id get_ai_visibility_metrics names). | |
| search | No | Scope the brief to ONE fan-out search of that prompt (a search the engines ran for it, as get_query_fanouts lists them): it is built on the answers that ran that search in the window, saved beside the prompt's own brief (one open brief per search), and read back with get_content_brief's search. Omit for the prompt's own brief over every answer. | |
| confirm | No | true generates the brief. Omit to preview. With confirm:true, also pass the preview's previewToken. | |
| promptId | Yes | The tracked prompt to write a brief for (id from list_prompts or get_content_gaps). | |
| promptType | No | With search: only answers of shopping prompts, or only of the others (the fan-outs page's type filter). | |
| previewToken | No | With confirm:true: the previewToken from this tool's preview (valid 15 minutes, once, for exactly the previewed arguments). |