Guide
Build a keyword-first CSV that ranks (Ahrefs to Scribe)
The generator honours structured SEO insights, so keyword data belongs in its own columns, not buried in the topic text. The steps below turn an Ahrefs export into a rank-ready batch.
- Find winnable keywords in Ahrefs. Keywords Explorer or Site Explorer, then filter for keywords you can realistically outrank: difficulty (KD) below your domain's reach, volume worth the effort, and informational or commercial intent (not navigational).
- Read the SERP for each survivor. Note what is ranking now, the format, and the gaps in the "People also ask" box. That note is the single most valuable field for ranking: it tells Scribe what to beat.
- Cluster and pick one primary keyword per article. One row per intended blog: one
target_keyword, a handful of secondary_keywords, one topic describing the ask, one angle.
- Export from Ahrefs and rename the headers to match the columns below. Add a
topic column (the actual ask) and, if you like, an angle.
- Pick the brand and persona above, upload, Generate. Then export the batch as CSV, JSON, or a WordPress import file.
Columns
How an Ahrefs export maps in
Only topic is required. Everything else is optional. Header aliases mean a lightly edited Ahrefs export drops straight in.
Ahrefs "Keyword"→target_keyword (alias: keyword)
Ahrefs "Difficulty" (KD)→difficulty (alias: kd)
Ahrefs "Volume"→volume
Related terms in the cluster→secondary_keywords
Your SERP / PAA note→serp_notes
Anything else to honour→notes
Keyword choice stays a human step: vet the list in Ahrefs before you upload, so you only generate for keywords you actually want to rank for. Grab the starter file with Download CSV template above.