Build SEO pages from real conversations

Build one page, fully researched — never batch-generate. This is the
condensed version of our open-source seo-page-builder skill
(github.com/octolens/seo-page-builder); install that for the full
methodology.

Hard rules, non-negotiable:
- Real quotes only: verbatim, from public posts, with working links.
  Never fabricate, never paraphrase-as-quote. Verify every URL resolves.
- Verify every fact at write time — pricing and plan limits from the
  official page, fetched today. Stale pricing is the #1 defect.
- Honesty ranks: credit competitors' genuine strengths, include your own
  product's cons, disclose vendor affiliation on the page.
- Draft for review. Never publish.

Phase 0 — Scope:
The page targets "{TARGET_TOPIC}" on {SITE_URL}. Determine the page type
(alternatives roundup / best-of listicle / vs comparison / pricing guide /
how-to) — it decides what to mine: complaints for alternatives pages,
recommendations for listicles, head-to-head experiences for vs pages,
"is it worth it" threads for pricing guides.

Phase 1 — Keyword research with real numbers:
If an SEO tool is connected (Ahrefs, DataForSEO), pull volume, difficulty,
and CPC for the modifier family: [topic], best [topic], [topic] tools,
[topic] pricing, question forms. Never guess numbers — if no tool is
available, ask the user for them. Then fetch the live SERP for the primary
keyword and read it like an editor: what format ranks, how long the
ranking lists are, what the People Also Ask questions are (they become
the FAQ), and where the ranking pages are weak (stale dates, no pricing,
no primary sources). If {SITE_URL} already has a nearby page, flag
possible cannibalization and recommend refresh-vs-new before continuing.

Phase 2 — Primary-source mining (the moat):
Use Octolens to collect 6–10 verbatim quotes matched to the page type:
call list_keywords, then list_mentions across topic, category, and
competitor keywords (last 12 months, sorted by relevance). Select quotes
that name specific pain — price figures, missing features, wasted time —
in searcher language. Dedupe by author. Verify every URL is live. The
dominant pattern across quotes (e.g. "pricing requires a sales call")
becomes the page's opening hook.

Phase 3 — Fact verification:
For every product on the page, fetch the current official pricing page.
Record entry price, tier gates, API access. One figure used consistently.

Phase 4 — Write:
Match the SERP-winning format. Open with the Phase 2 hook and a citable
2–3 sentence direct answer. Put the quote wall early — each quote linked,
attributed. Roundups get a comparison table plus per-tool sections with
verified pricing, pros/cons, and "Best for". Add a decision framework
that recommends competitors where they honestly win, an FAQ built from
the real People Also Ask questions, and JSON-LD (Article always; ItemList
for roundups; FAQPage matching the rendered FAQs exactly).

Phase 5 — QA and handoff:
Check: every quote URL opens a real post, all prices verified today,
schema matches rendered content, competitor strengths and own-product
cons present. Write the draft to {OUTPUT_FILE_PATH} and post a summary:
target keyword and volume, format decision and why, the quotes used, and
anything stale you discovered on the rest of the site. Do not publish.