- JSON-LD（`<script type="application/ld+json">`）是各大搜索引擎与生成式 AI 引擎最推荐的结构化数据格式，与可视 DOM 解耦且易于维护。
- 若站点未部署真实的站内搜索结果页，切勿在 `WebSite` 实体中盲目复制 `SearchAction`（Sitelinks Searchbox），否则会产生指向 404 的无效结构化声明。
- 结构化数据中的文本内容（如标题、发布时间、面包屑路径、FAQ 问答）必须与页面上用户肉眼可见的正文完全一致，严禁隐藏作弊。
一、为什么 JSON-LD 是连接网页内容与搜索引擎知识图谱的桥梁？
尽管现代搜索引擎的自然语言处理能力已经非常强大，但从非结构化的 HTML DOM 树中推断实体关系仍然存在歧义与算力成本。通过在页面中内嵌标准的 Schema.org JSON-LD 脚本，我们可以用机器零歧义的语言直接告诉百度、必应与 Google：当前站点的官方品牌主体是谁（Organization）、当前页面在全站信息架构中处于哪一层（BreadcrumbList）、这篇文章解决的核心技术问题与发布时间是什么（TechArticle / BlogPosting）。
规范的结构化数据不仅有助于在搜索结果页（SERP）中触发面包屑路径展示、发布时间标记与常见问题折叠卡片，从而提升自然点击率（CTR），更是生成式 AI 搜索（GEO / AI Overviews）优先引用高可信度信源的重要依据。
二、企业级技术门户必配的五类 JSON-LD 实体矩阵
针对像 `siseo.cn` 这样的企业级技术获客门户，我们应当按页面角色精准注入对应的结构化实体，而非全站千篇一律地只放一段简单的站点介绍：
在首页（`/`），组合注入 `WebSite`、`Organization`、`SoftwareApplication` 与 `FAQPage`；在解决方案页（`/solutions`），注入 `BreadcrumbList`、`SoftwareApplication` 与 `FAQPage`；在每一篇专栏文章（`/blog/[slug]`）与技术文档（`/docs/[slug]`）详情页，则动态生成包含精确 `headline`、`datePublished`、`dateModified`、`keywords` 的 `TechArticle` 以及三级 `BreadcrumbList`。
import React from "react";
interface JsonLdScriptProps {
data: Record<string, unknown> | Array<Record<string, unknown>>;
}
export function JsonLdScript({ data }: JsonLdScriptProps) {
const blocks = Array.isArray(data) ? data : [data];
return (
<>
{blocks.map((block, index) => (
<script
key={index}
type="application/ld+json"
dangerouslySetInnerHTML={{
__html: JSON.stringify(block),
}}
/>
))}
</>
);
}三、常见排雷：剔除虚假的 SearchAction 与保持可见性一致
很多开发者直接从网上拷贝 `WebSite` JSON-LD 模板，里面包含了一段指向 `https://example.com/search?q={search_term_string}` 的 `potentialAction: SearchAction`。然而如果网站实际上并没有开发 `/search` 路由，爬虫或核验工具在测试该模板 URL 时就会直接撞上 404 错误，反而降低结构化数据的合规可信度。
因此，在构建 JSON-LD 生成器时，必须坚守“所声明即所见”的白帽原则：不声明不存在的搜索动作，不捏造虚假的用户评分（AggregateRating），并且确保每一段 JSON-LD 在构建与巡检阶段都通过严格的 `JSON.parse` 语法校验。
- 验证页面所有 `<script type="application/ld+json">` 块均可被标准 `JSON.parse()` 无报错解析。
- 确认首页同时包含 `WebSite` 与 `Organization` 实体，且不含指向不存在路由的 `SearchAction`。
- 确认详情页的 `BreadcrumbList` 每一级 `item` URL 均为规范绝对地址且与页面顶部可见面包屑导航完全对应。
本文常见问答（FAQ）
一个页面可以放置多个 <script type="application/ld+json"> 标签吗？
完全可以。搜索引擎支持在同一个页面中解析多个独立的 JSON-LD 脚本块（例如一个块声明 BreadcrumbList，另一个块声明 TechArticle 和 FAQPage），也可以使用 `@graph` 数组将多个实体组合在同一个脚本块内。
部署了 FAQPage 结构化数据就一定会展示折叠问答摘要吗？
富媒体摘要的最终展示由搜索引擎根据搜索词意图、站点权威度与当前版面策略动态决定。但正确部署 `FAQPage` 能够显著帮助搜索引擎理解页面的长尾问答语义，提升页面在相关问题搜索词下的匹配排名。
自动化校验全站 JSON-LD 结构化数据语法与完整性
在每次发版前后自动扫描全站关键路由的结构化数据实体，杜绝 JSON 语法损坏与字段缺失。