Creating posts

Overview

Obsurfable helps you create AEO-ready posts in two places:

• /content/new — Start a blank draft or pull in sources (opportunities, actions, matched prompts, cited pages) and generate an AI draft.
• /content/[id] — Edit an existing draft or published post: title, slug, description, markdown body, and publish status.

Both pages use a markdown editor with live preview, plus Post content refine to iteratively improve the draft with AI (for example, add links or adjust tone).

Paid gate. Creating and publishing posts requires an active Pro or Agency subscription. Trial accounts cannot generate or publish.

Who it's for

• Content writers turning gaps in Opportunities into publishable articles
• Product marketers drafting comparison pages, FAQs, and positioning-correction content from matched evidence
• Anyone on Pro or Agency who wants AI-assisted drafts grounded in their company and matched corpus

Prerequisites

1. A paid subscription and a completed company profile.
2. For the Pull in sources flow, at least one of: an open opportunity (especially content_opportunity, citation_gap, or positioning_accuracy), an action of kind create_content, or a matched prompt with a stored answer.
3. Optional: cited pages you want the draft to learn from.

Step-by-step

Start a new post

1. From /content, click New post (/content/new).
2. Choose your starting path.

Option A — Start with blank document

1. Click Start with blank document.
2. Optionally enter a topic or idea in the free-text field.
3. Configure generation options (article type, tone, length, CTA, competitors, structure toggles).
4. Click Generate draft or write directly in the editor.
5. Edit title, description, and markdown content.
6. Click Save as draft to open the post detail page.

Option B — Pull in sources

1. Click Pull in sources (/content/new?start=sources).
2. Step 1 — Generation options: Set article type (standard, listicle, how-to, comparison, FAQ, thought leadership), target reader, tone, length, CTA mode, linking behavior, company mention intensity, and structure toggles (comparison table, FAQ, pros/cons).
3. Select sources: Choose any combination of opportunities, actions, and matched prompts. At least one source is required before generating.
4. Matched prompts: Pick a prompt and a specific model answer. Optionally select cited URLs for additional context.
5. Finalize: Review selected sources and adjust generation options if needed.
6. Click Generate draft. The AI streams title, description, and markdown content into the editor.
7. Refine with Post content refine, then Save as draft.

Generation uses your company profile and the matched Explorer corpus only — it does not browse the open web.

Deep-link from an opportunity or action

• Open an opportunity or create_content action and choose Create content to land in the source flow with that item pre-selected.
• Recommended posts on /content link directly into this flow.

Edit an existing post

1. Open /content/[id] from the post list.
2. Update Title, Slug (URL path), Description (SEO and social preview), and Content (markdown).
3. Use Post content refine to ask for targeted edits without rewriting the whole post.
4. Set Status to draft or published. Publishing sets a publish timestamp.
5. Click Save.
6. Export via Copy, Download Markdown, or Download HTML if you are not using the hosted blog.

Publish and distribute

1. Set status to published and save.
2. With a connected and verified subdomain, the post appears on your hosted blog at https://<subdomain>/<slug>.
3. Optionally extend reach through the Circuit partner network (an external partner link; see Actions).
4. Mark the related action done, then watch Coverage and Metrics over the coming observation cycles.

Tips

• Positioning fixes work best when you select the matched prompt where the model answered inaccurately — the generator adapts framing from the stored answer.
• Citation gaps: include the cited competitor pages as context so your draft answers the same question more directly.
• Source usage counts show how many posts already used a given opportunity — avoid over-indexing on one angle.
• Slug defaults from the title; keep it short and keyword-friendly before publishing.
• Description feeds Open Graph and meta tags on the hosted blog — write a clear one- to two-sentence summary.
• Use ?start=blank or ?start=sources in the URL to bookmark your preferred starting point.

FAQ

Can I create a post without AI generation?

Yes. Choose Start with blank document, skip Generate draft, and type directly in the markdown editor. You still need a paid subscription to save and publish.

What generation options matter most?

Article type and length target shape structure. Company mention intensity controls how prominently your brand appears. Include competitors is useful for comparison content. Linking behavior controls outbound references.

Does generating overwrite my edits?

Generating a new draft replaces title, description, and content in the new-post flow. On the edit page, saves are explicit — use Save to persist changes.

What is Post content refine?

A secondary AI pass on the current markdown. Enter instructions like "add more internal links" or "make the tone more conversational" without re-running source-based generation.

Where are sources stored on the post?

Sources used badges appear on the post list and detail view — for example opportunity, action, matched prompt, or Search Console query. They are saved when you generate from sources.

Can I publish without a connected subdomain?

Yes. Set status to published inside Obsurfable for tracking, or export Markdown or HTML to publish elsewhere. Live URLs on your domain require Connected subdomains.