Raw schema
{
"type": "object",
"properties": {
"include_comparison": {
"default": true,
"description": "Include the head-to-head comparison table (research runs either way).",
"type": "boolean"
},
"product_id": {
"description": "Which product to review, by id. Ignored with a product API key. Prefer product_url, which is how people name their own app.",
"type": "string"
},
"product_url": {
"description": "Which product to review, by website, e.g. \"sparkmobile.dev\". Matched by domain against the products on the account, ignoring www and the scheme. Ignored with a product API key.",
"type": "string"
},
"brief_only": {
"default": false,
"description": "Research only: return the competitors, the verified feature matrix and the full writing brief, and write nothing. Nothing is saved, no quota is spent and no editor is involved. Follow it with a second call passing `draft`.",
"type": "boolean"
},
"rivals": {
"description": "Competitors to compare against, comma separated, instead of whatever a live search turns up. You know your own market better than a listicle does.",
"type": "string"
},
"fills": {
"description": "Answers for rows the research could not confirm from your site, as {\"Feature name\": \"value\"}, e.g. {\"MCP tools\": \"Yes\"}. Authoritative: you know whether you ship the thing, and a dash next to three ticks reads as a missing feature rather than a missing fact. Use the row names exactly as they come back from brief_only.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"research": {
"description": "The extracted research JSON, when a previous call handed you the extraction prompt instead of running it. This server never calls an AI model on your behalf: you are the model. Pass back exactly the JSON object the prompt asked for.",
"type": "string"
},
"draft": {
"description": "Your article, written from a brief_only call. Supplying it skips the built-in writer: the comparison table, the strengths and weaknesses cards, the quality score and the editor hand-off all run exactly as they otherwise would. Prose fields together should run 320 to 480 words.",
"type": "object",
"properties": {
"title": {
"default": "",
"type": "string"
},
"summary": {
"default": "",
"type": "string"
},
"verdict": {
"default": "",
"type": "string"
},
"insights": {
"default": "",
"type": "string"
},
"overview": {
"default": "",
"type": "string"
},
"keyDifference": {
"default": "",
"type": "string"
},
"strengths": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"weaknesses": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"budget": {
"default": "",
"type": "string"
},
"bottomLine": {
"default": "",
"type": "string"
}
}
},
"hold_as_draft": {
"default": false,
"description": "Save the article as a dashboard draft and stop: no editor is picked, nobody is notified. The owner reviews it at the dashboard (Reviews view) and submits it from there, where the same publish benchmark applies. Still spends the generation (one review per app), so use it when a human should read the article before any editor does.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}