# Gauto Schema

> 面向 AI 可发现性的 Schema.org 结构化数据审计与生成（汽车出口版）。检测、校验并生成 JSON-LD，重点是汽车专属类型——Product+Vehicle（含 HS 码/FOB/CIF/续航/马力/舵位）、出口商 Organization、FAQPage、Article。让 AI 准确理解"你是什么实体、卖什么车、发往哪里"。

- Skill: `adiready/gauto-schema` (Agent Skill)
- Install (CLI): `npx skillmds@latest add adiready/gauto-schema`
- Raw SKILL.md: https://api.skillmd.com/api/skills/adiready/gauto-schema/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: adiready (https://skillmd.com/u/adiready)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/adiready/gauto-schema

---


# GEO Schema 与结构化数据（汽车出口版）

## 目的

结构化数据是告诉 AI"某实体**是**什么、做什么、如何与其他实体关联"的主要机器可读信号。
在 GEO 语境下，它的作用已超出"拿 Google 富结果"：**结构化数据是 AI 理解并信任你实体的方式**。
一个完整的实体图（entity graph）会显著提升各 AI 平台上的引用概率。

## 使用步骤

1. 用 `fetch_page.py` 抓目标页 HTML（见下方提示）
2. 检测所有现有结构化数据（JSON-LD、Microdata、RDFa）
3. 对照 Schema.org 规范校验
4. 按站点类型识别缺失的**汽车专属推荐 schema**
5. 生成可直接粘贴的 JSON-LD
6. 输出 `GEO-SCHEMA-REPORT.md`

---

## 步骤 1：检测

**重要：** WebFetch 会把 HTML 转 markdown 并剥离 `<head>`，导致 JSON-LD 丢失。请用 `fetch_page.py`：
```bash
python3 ~/.workbuddy/skills/geo-auto-export/scripts/fetch_page.py <url> page
```
输出中的 `structured_data` 数组含全部已解析的 JSON-LD 块。

- **JSON-LD**：找 `<script type="application/ld+json">`，逐块解析。
- **Microdata**：找 `itemscope/itemtype/itemprop`；比 JSON-LD 更难被 AI 解析，建议迁移。
- **RDFa**：找 `typeof/property/vocab`；同样建议迁移 JSON-LD。

**优先级**：JSON-LD 是 GEO 强推荐格式。

---

## 步骤 2：校验

对每个块校验：① 合法 JSON；② 合法 `@type`；③ 必需属性齐全；④ 推荐属性齐全；⑤ 有 `sameAs`；⑥ URL 可达；⑦ 嵌套正确；⑧ 是否**服务端渲染**（JS 注入的可能被延迟处理，标记出来）。

---

## 步骤 3：GEO 关键 schema 类型

### Organization（危急——每个企业站都要）
AI 识别"你是什么组织"的基座。

**必需**：`@type`、`name`、`url`、`logo`
**GEO 推荐**：`sameAs`（**全部平台 URL**）、`description`、`foundingDate`、`founder`、`address`、`contactPoint`、`areaServed`、`industry`、`knowsAbout`、`award`
> 出口商专属模板见 `schema/organization-exporter.json`。

### Product + Vehicle（汽车出口核心）
用 `@type: ["Product","Vehicle"]` 同时获得商品与车辆的语义。

**Vehicle 关键属性**：`vehicleModelDate`、`bodyType`、`fuelType`、`steeringPosition`（LHD/RHD）、`vehicleTransmission`、`vehicleEngine`（含 `enginePower`）、`mileageFromOdometer`、`numberOfPreviousOwners`、`vehicleIdentificationNumber`
**Product/Offer 关键属性**：`name`、`image`、`brand`、`offers`（`price`/`priceCurrency`/`availability`/`eligibleQuantity`/`areaServed`）
**出口专属**：用 `additionalProperty` 承载 **HS 编码、FOB 价、CIF 港、MOQ、续航 km、舵位、运输方式**。
> 完整模板见 `schema/vehicle-offer.json`。

### Article + Author（内容页）
**Article 必需**：`headline`、`datePublished`、`dateModified`、`author`、`publisher`、`image`
**Author（Person）GEO 推荐**：`name`、`url`、`jobTitle`、`worksFor`、`knowsAbout`、`sameAs`
> 模板见 `schema/article-author.json`。

### FAQPage
Google 2023-08 起将 FAQ 富结果限制在政府/医疗站，但 **FAQPage 对 AI 抽取问答依然有效**，建议保留。
> 汽车出口 FAQ 模板见 `schema/faqpage-export.json`。

### WebSite + SearchAction
站点级；提供站内搜索语义。模板见 `schema/website-searchaction.json`。

### Organization 出口商专属字段
用 `areaServed`（六大市场）、`knowsAbout`（FOB/CIF/右舵/清关等）、`hasCredential`（出口资质）、`makesOffer`/`Service`（出口服务）强化"出口商"实体。

### speakable
标记最适合语音/AI 助手消费的段落（如"关键结论""出口要点"）。

---

## 步骤 4：需标记的过时/受限 schema

| Schema | 状态 | 说明 |
|---|---|---|
| HowTo | 富结果 2023-08 弃用 | 对 AI 解析仍有用，但别承诺富结果 |
| FAQPage | 2023-08 限政府/医疗 | 对 AI 解析仍有用 |
| SpecialAnnouncement | 2023 弃用 | 若存在应移除 |
| VideoObject `contentUrl` | 2024 行为变更 | 须指向真实视频文件 |
| Review snippet | 2024 收紧 | 自用评价可能不展示 |

---

## 步骤 5：sameAs 策略（实体识别核心）

`sameAs` 是 GEO 最重要的结构化属性——告诉 AI"我站上的实体 = 这些外部平台上的同一实体"。汽车出口的 `sameAs` 优先级：

1. Wikidata 条目（机器可读实体 ID）
2. Wikipedia 词条（若有）
3. Alibaba / Made-in-China 店铺
4. LinkedIn 公司页
5. YouTube 频道
6. Facebook 主页
7. Telegram / WhatsApp 商务链接
8. 行业商会/展会名录页
9. TikTok
10. 其他（Crunchbase、贸易数据库等）

**审计**：收集实体全部网络存在 → 校验 URL 可达 → 确认 Organization 含全部 → 检查各平台信息一致 → 标记"应有但缺失"的平台。

---

## 步骤 6：JSON-LD 生成

按站点类型总是生成：① Organization（出口商版）② WebSite+SearchAction（首页）③ 类型专属（车型页→Product+Vehicle；内容页→Article；FAQ→FAQPage）④ BreadcrumbList（内页）。

### 生成规则
- 用 `@graph` 组合多 schema
- URL 用绝对地址
- 加 `@id` 交叉引用
- 日期用 ISO 8601
- Article 加 `speakable`
- JSON-LD 放 `<head>`，**不要 JS 注入**

---

## 评分（0-100）

| 标准 | 分值 |
|---|---|
| Organization 完整 | 15 |
| sameAs（5+ 平台） | 15 |
| Article + 作者 schema | 10 |
| **类型专属schema（车型页=Product+Vehicle）** | 10 |
| **出口专属附加属性（HS/FOB/CIF/MOQ）** | 5 |
| WebSite + SearchAction | 5 |
| BreadcrumbList | 5 |
| JSON-LD 格式 | 5 |
| 服务端渲染 | 10 |
| speakable | 5 |
| JSON/类型合法 | 10 |
| knowsAbout | 5 |
| 无过时 schema | 5 |

---

## 输出格式

生成 `GEO-SCHEMA-REPORT.md`：

```markdown
# GEO Schema 与结构化数据报告 — [域名]
日期：[日期]

## Schema 分：XX/100

## 已检测 schema
| 页面 | 类型 | 格式 | 状态 | 问题 |
|---|---|---|---|---|

## 校验结果
[逐 schema 按属性 pass/fail]

## 缺失的推荐 schema
[按站点类型列出应有而未有的]

## sameAs 审计
| 平台 | URL | 状态 |
|---|---|---|
| Wikidata | [URL 或 未找到] | 有/缺 |
| Alibaba | ... | |
| LinkedIn | ... | |

## 生成的 JSON-LD
[可直接粘贴的块]

## 实施说明
- 各块放置位置
- 服务端渲染要求
- 用 Rich Results Test / Schema.org Validator 自测
```

