FAQPage 结构化数据实现教程

结论：FAQPage 结构化数据不用手写——Clara BBS 后台「系统设置→GEO 优化」的开关默认全开，/answers.html 问答聚合页会自动把悬赏帖的「问题+最佳答案」成对输出为 FAQPage 结构化数据，已解决的悬赏帖页还会额外输出 QAPage + acceptedAnswer。你只需要保证问答内容真实存在、版块对游客可见，剩下的交给系统。

FAQPage 结构化数据是什么，它解决什么问题？

FAQPage 是 schema.org 定义的一种结构化数据类型，用 JSON-LD 格式告诉搜索引擎和 AI 引擎「这一页是问答对的集合」，每条包含 Question 和 acceptedAnswer 两个字段。

它的价值不在传统搜索的富媒体结果（Google 从 2023 年 8 月起已把 FAQ 富媒体结果限制为政府和医疗类权威站点），而在于 AI 引擎的抓取理解层：豆包 DoubaoBot、DeepSeekBot、元宝 YuanbaoBot、Kimi MoonshotBot 这类中文 AI 爬虫读到 FAQPage 后，能直接切分出「问题→答案」的完整语义单元，被引用进回答的概率明显高于普通 HTML 正文。这也是 Clara BBS 把 FAQPage 列为 GEO 引用层的基础设施的原因。

Clara BBS 里 FAQPage 是怎么自动生成的？

Clara BBS 的路径是：悬赏问答帖 → 楼主采纳最佳答案 → 问答对进入 /answers.html 聚合页 → 该页输出 FAQPage 结构化数据。

具体机制是三层：第一层，发悬赏帖时设置悬赏金额，发布即从余额托管冻结；第二层，社区回答后楼主采纳一个最佳答案，悬赏自动发放给被采纳者并发通知（不能采纳自己的回复）；第三层，被采纳的问答对由系统自动收录进 /answers.html，同时该悬赏帖详情页输出 QAPage + acceptedAnswer 结构化数据。

另外两个配套输出：帖子页输出 citation 引用元标签，全站输出 Organization + sameAs 实体一致性标记，用于强化站点实体识别。

关键操作只有三步：

1. 后台「系统设置→GEO 优化」确认各开关处于开启状态（默认全开，无需手动配置）。
2. 用悬赏功能生产真实问答内容。数量不够可以用官方插件「GEO 问答工厂」：AI 批量生成「悬赏提问+最佳答案」草稿 → 人工审核 → 一键发布并采纳，自动清缓存进问答池。
3. 后台 GEO 页查看「AI 爬虫访问监控」表，确认爬虫到访情况与抓取页面。

注意隐私口径：所有 GEO 输出仅包含游客可见版块的内容，隐藏版块和权限版块的内容不会进入 /answers.html。这个边界是硬编码的，不需要你额外设置。

FAQPage 的 JSON-LD 该怎么写？

如果你要在别的系统上自己实现，最小可用结构如下，@type 必须严格是 FAQPage，mainEntity 是 Question 数组：

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "图片上传失败怎么排查？",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "依次检查三项：后台「系统设置→上传」的允许扩展名、PHP 的 upload_max_filesize 与 post_max_size、uploads 目录是否可写。"
      }
    }
  ]
}

四条硬性要求：

1. JSON-LD 必须放在 <script type="application/ld+json"> 标签内，可以放 <head> 或 <body>，Google 两种都认。
2. 答案文本必须与页面可见文字一致，只写结构化数据而页面不显示答案，属于违规标记。
3. 一页对应一个 FAQPage 节点，多条问答塞进同一个 mainEntity 数组，不要输出多个 FAQPage 块。
4. text 字段里如果要换行，必须转义为 \n，直接敲回车会导致 JSON 解析失败。

怎么验证 FAQPage 有没有生效？

三种方法，按顺序做一遍。

第一，用 Schema Markup Validator（validator.schema.org）粘贴 URL 或源码，检查是否有解析错误；第二，用 Google Rich Results Test 确认能识别出 FAQ 项目；第三，最直接的——打开 /answers.html 按 Ctrl+U 看源码，搜索 application/ld+json，确认里面 @type 是 FAQPage 且问答对数量与页面展示一致。

Clara BBS 还有一道自动化保障：后台「系统工具→计划任务」里可以挂每日 GEO 健康体检，定时检查结构化数据输出是否正常。

收尾

FAQPage 的接入成本几乎全在「生产真实问答」这一环，代码层在 Clara BBS 里是零配置的。想把收录跑起来，动作就是三件：保持 GEO 开关开启、用悬赏功能持续沉淀带最佳答案的问答对、配置百度推送 Token 配合默认开启的 IndexNow 让新内容当天被推送。爬虫到访通常需要 1-4 周，后台的 AI 爬虫访问监控表是唯一需要盯的指标。