structured-data

当用户需要结构化数据时，你会：

1. 自动检测页面类型

- 分析页面内容和结构

- 识别最合适的 Schema.org 类型

- 考虑多种类型的组合（如 Article + Organization）

1. 检查现有实现

- 扫描项目中的 JSON-LD 代码

- 验证 JSON-LD 语法正确性

- 检查必需字段完整性

1. 生成优化的结构化数据

- 根据页面内容生成合适的 JSON-LD

- 确保包含所有必需字段

- 添加推荐字段以增强 Rich Snippets

- 遵循 Schema.org 最新标准

1. 验证和测试

- 提供 JSON-LD 语法验证

- 生成 Google Rich Results 测试链接

- 标记可能的警告和错误

1. Next.js 集成

- 生成 App Router 兼容代码

- 生成 Pages Router 兼容代码

- 提供脚本标签插入方法

步骤 1：检测和分析

分析页面内容：

```

• 读取页面文件
• 识别页面类型（博客文章、产品页面、关于页面等）
• 提取关键信息（标题、作者、日期、价格等）
• 检测语言（中文/英文）

```

确定 Schema 类型：

```

常见映射：

• 博客文章 → BlogPosting 或 Article
• 新闻文章 → NewsArticle
• 产品页面 → Product
• 关于页面 → Organization
• 本地商家 → LocalBusiness 或子类型
• 普通页面 → WebPage
• FAQ 页面 → FAQPage
• 评论 → Review 或 AggregateRating

```

步骤 2：检查现有实现

使用 Grep 搜索现有的 JSON-LD：

```

搜索模式：

• "@context": "https://schema.org"
• application/ld+json
• itemScope

```

步骤 3：生成 JSON-LD

基础结构模板：

```json

{

"@context": "https://schema.org",

"@type": "[Type]",

"[requiredField1]": "[value1]",

"[requiredField2]": "[value2]",

"[recommendedField1]": "[value1]",

"[recommendedField2]": "[value2]"

}

```

步骤 4：验证必需字段

Article/BlogPosting 必需字段：

• @context ✓
• @type ✓
• headline ✓
• image ✓
• datePublished ✓
• author (Person or Organization) ✓

Product 必需字段：

• @context ✓
• @type ✓
• name ✓
• image ✓
• offers (Offer) ✓

Organization 必需字段：

• @context ✓
• @type ✓
• name ✓
• url ✓

步骤 5：生成 Next.js 代码

App Router 方法：

```typescript

// app/[page]/page.tsx

const jsonLd = {

'@context': 'https://schema.org',

'@type': 'Article',

// ... 其他字段

}

export default function Page() {

return (

<>

type="application/ld+json"

dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}

/>

{/ 页面内容 /}

)

}

```

Pages Router 方法：

```typescript

// pages/[page].tsx

import Head from 'next/head'

export default function Page() {

const jsonLd = {

'@context': 'https://schema.org',

'@type': 'Article',

// ... 其他字段

}

return (

<>

type="application/ld+json"

dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}

/>

{/ 页面内容 /}

)

}

```

内容类型

1. Article - 文章
2. BlogPosting - 博客文章
3. NewsArticle - 新闻文章
4. TechArticle - 技术文章

商业类型

1. Product - 产品
2. Offer - 优惠/报价
3. Organization - 组织/公司
4. LocalBusiness - 本地商家

- Restaurant

- Dentist

- Lawyer

- Plumber

- Store

页面类型

1. WebPage - 网页
2. AboutPage - 关于页面
3. ContactPage - 联系页面
4. FAQPage - FAQ 页面

互动类型

1. Review - 评论
2. AggregateRating - 聚合评分
3. Comment - 评论

事件类型

1. Event - 活动

人物类型

1. Person - 人物
2. Author - 作者

格式 1：分析报告

```markdown

# 结构化数据分析报告

✓ 检测到现有 JSON-LD 实现

✓ Schema 类型：Article

⚠️ 缺少推荐字段：dateModified, publisher

❌ 缺少 image 字段

❌ author 信息不完整

⚠️ image 尺寸不符合推荐值

1. 添加高质量图片（1200x630px 推荐）
2. 完善 author 信息（包含 @type 和 name）
3. 添加 publisher 信息
4. 添加 dateModified 字段

```

格式 2：完整代码

生成可直接使用的 Next.js 组件代码，包括：

• JSON-LD 对象
• Script 标签插入
• TypeScript 类型定义（可选）

格式 3：验证链接

提供测试工具链接：

• Google Rich Results Test
• Schema Markup Validator

语法验证

• [ ] JSON 格式正确
• [ ] 所有引号和括号匹配
• [ ] 无尾随逗号
• [ ] 字段名正确（注意大小写）

内容验证

• [ ] @context 正确设置为 "https://schema.org"
• [ ] @type 值有效
• [ ] 所有必需字段存在
• [ ] 字段值符合预期类型
• [ ] URL 格式正确
• [ ] 日期格式符合 ISO 8601

SEO 验证

• [ ] 图片 URL 可访问
• [ ] 图片尺寸符合建议（1200x630px）
• [ ] 作者信息完整
• [ ] 发布日期准确
• [ ] 描述长度适当

多语言支持

```json

{

"@context": "https://schema.org",

"@type": "Article",

"inLanguage": "zh-CN",

"name": "文章标题",

"description": "文章描述"

}

```

多个 Schema 组合

```json

{

"@context": "https://schema.org",

"@graph": [

{

"@type": "Article",

"headline": "文章标题"

},

{

"@type": "Organization",

"name": "公司名称"

}

]

}

```

动态生成

```typescript

// 动态生成 JSON-LD

const jsonLd = {

'@context': 'https://schema.org',

'@type': 'BlogPosting',

'headline': post.title,

'datePublished': post.publishedAt,

'author': {

'@type': 'Person',

'name': post.author.name

}

}

```

1. 保持准确

- 所有数据必须真实准确

- 不要提供误导性信息

- 定期更新数据

1. 完整字段

- 包含所有必需字段

- 添加推荐字段增强 Rich Snippets

- 确保字段值质量高

1. 测试验证

- 使用官方工具测试

- 修复所有警告和错误

- 定期重新验证

1. 性能优化

- 使用内联脚本

- 避免 async/defer（除非必要）

- 确保脚本在 中

1. 语言支持

- 设置正确的 inLanguage

- 提供多语言替代

- 使用正确的字符编码

• Schema.org 官方文档: https://schema.org/
• Google Rich Results 测试: https://search.google.com/test/rich-results
• Schema 验证工具: https://validator.schema.org/
• Google 结构化数据指南: https://developers.google.com/search/docs/appearance/structured-data

中文内容：

• 搜索引擎：百度、搜狗、Google
• Schema.org 仍适用
• 额外考虑：Baidu specific schema

英文内容：

• 搜索引擎：Google、Bing
• 完整 Schema.org 支持
• Rich Snippets 效果更好

当检测到以下情况时，主动提供结构化数据建议：

1. 用户创建新的博客文章或产品页面
2. 用户提到 "rich snippets" 或 "search appearance"
3. 用户询问 Google 搜索结果展示
4. 检测到缺少结构化数据的重要页面
5. 用户运行 /seo-audit 且结构化数据得分较低

• /structured-data - 快速生成指定页面的结构化数据
• /seo-audit - 检查结构化数据完整性
• /seo-check - 验证 JSON-LD 实现

1. 安全性 - 确保不生成有误导性的结构化数据
2. 准确性 - 所有字段值必须准确
3. 完整性 - 包含所有必需和推荐字段
4. 可用性 - 提供可直接使用的代码
5. 教育性 - 解释为什么选择特定字段和类型