Prepare a Pulse article brief (server pipeline)
flypost_prepare_articleStep 1 of Flypost's own long-form writer (server-side AI + web research). Prefer flypost_save_article when you can write the article yourself — it is faster and costs the user nothing. Use this when the user explicitly asks for Flypost to write it, or wants its built-in research. Creates the article from topic + target_query + angle (or takes an existing article_id) and gathers Brain material into a brief. Then build the outline with flypost_outline_article. Always set target_query: it steers the writer and is what keyword tracking reports on. Set article_type to match the query (list for numbered points, roundup for "best X" lists); when you leave it out the result carries suggested_article_type if Flypost would pick another one. To write from research you gathered (or the user collected), save it to a notebook first and pass notebook_id.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "flypost_prepare_article"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| angle | No | ||
| topic | No | Topic for a new article when article_id is omitted. | |
| article_id | No | ||
| project_id | No | Project id; omit for the active project. | |
| notebook_id | No | Write from ONE notebook: the brief, outline and article retrieve only from its sources. Pass the source_package_id that flypost_create_notebook returns (or a notebook id from flypost_list_sources). Typical flow when you did the research yourself: flypost_create_notebook, then save each finding with flypost_add_source_url or flypost_add_source_text (one source per tool or page you researched), then flypost_prepare_article with notebook_id and research_mode "source". For a roundup, everything comes from the notebook: save a source per tool (your own company and, for "X alternatives", X itself included), with the tool named in its title or saved from its own site so it can be matched. With research_mode "source" a tool the notebook does not cover is left out. Set on a new article, or moves an existing one onto that notebook. | |
| article_type | No | The article format. guide (default): explains how or why in 4-7 sections ("how to measure share of voice"). list: numbered points, one per H2, count taken from the brief ("10 questions to ask an agency", "a 25-point checklist"). roundup: "best X for Y" written by the author in the first person as having tested the tools ("I tested 8 Taplio alternatives: here are the best"), one H2 per entry with the same sub-structure, a how-I-chose section, a comparison and an FAQ; every entry is researched first (from the notebook when notebook_id is set, else one web search per entry) and only sourced facts are used, so it takes longer. Match it to target_query. Omitted on a new article = guide. | |
| target_query | No | The exact search query the article is trying to rank for, e.g. "what is an impression on linkedin". Steers the writer's retrieval and prompts, and is the keyword the app's rankings report tracks. Sets it on a new article, or updates it on an existing one. | |
| research_mode | No | source: ground only on the Brain (or on notebook_id when given). online: also research the web. With notebook_id, source keeps the article to that notebook with no web search at all; online adds fresh web stats and, for a roundup, web research for whatever the notebook does not cover (entries, the tool being replaced). A roundup with no notebook should use online: its entries need live pricing and features. |