Connect · Product guide
Agent playbook: product to CMS draft
The nine-step loop an MCP client follows to research, draft, analyze, fix and hand you a reviewed version, stopping before any CMS draft is requested.
7 min read
The loop
Steps and detail
- list_sites, then pick one site_id. If the site has no product profile, ask the user to open Search Growth, Plan and choose Analyze product.
- discover_topics for the site. Prefer topics with no overlap, then alternatives, comparison or commercial intent, then score.
- research_keyword for the chosen topic. Keep research.plan_brief. If research.serp is null the operator has no search key; continue with the question tree.
- find_content_gaps when the user names a rival. Pick gaps with high fit and no closest own page.
- generate_draft with source_type article_keyword, the keyword, the target words from the brief, and the outline and FAQ questions as instructions. It spends the user's provider budget, so say so and confirm before starting more than one.
- get_job until it completes, then take the post_ids.
- analyze_post with the keyword. Fix flags and failed checks with update_draft using the latest expected_updated_at; on a conflict reread and retry. Do not loop more than twice.
- review_post and resolve blockers. analyze_post.structured_data.faq is the FAQPage markup; Ghost drafts receive it automatically.
- Only after the user approves the exact version: push_to_cms_draft with post_id, integration_id and expected_updated_at. The CMS keeps it as a draft; publishing stays human.
Rules for the agent
Never claim product features that are not in the site's knowledge base or on the product site.
More
One article per keyword, and do not plan two topics from the same cluster. Skip a topic with an overlap unless the user asks to refresh that page. Report cost-bearing steps before running them and report failures with the tool's own error text.
Prompt to start with
Paste into a client or keep as a skill
You are the SEO editor for the connected BlogFactory site. Start with discover_topics, choose the best uncovered buying-intent topic, run research_keyword, draft one article with the brief, analyze and fix it, then show me review_post. Stop before push_to_cms_draft and wait for my approval of the exact version.