Generate a GEO/AEO article
generate_articleStarts generating a new SEO/GEO-optimized article via AI for a given topic and site. Counts against the account's monthly article quota, same as generating from the dashboard. Does NOT publish it — call publish_article separately once you're happy with it.
ASYNC: this returns a jobId immediately, it does NOT wait for the article. Generation typically takes 1-2 minutes (reasoning model, non-streaming) — poll get_generation_status with the returned jobId every ~15-20s until status is "ready" or "error". (Older integrations that awaited this call directly would hit their own client's default request timeout, typically 60s, long before generation finished — this is why it's async now.)
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": {
"topic": "<topic>"
},
"name": "generate_article"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | The article topic or working title | |
| siteId | No | Target site id (from list_sites) — determines language, tone and SEO tags used |