Communitygithub.com

astudio · 结构化数据标记

编写面向2026年仍有效的Schema.org结构化数据(JSON-LD),涵盖Organization、LocalBusiness、Product等核心类型,并提供校验与淘汰类型提醒。

astudio · 结构化数据标记 是什么?

该技能帮助AI代理为网站生成并维护Schema.org结构化数据(JSON-LD格式),专注于2026年仍对搜索结果有影响的类型,例如Organization、LocalBusiness、Product(含Offer和AggregateRating)、Article、BreadcrumbList、VideoObject、Event、JobPosting、Course及QAPage。其核心原则是数据必须与页面可见内容一致,避免隐藏评分、自卖自夸评论或虚假价格。技能包含自动化校验脚本(schema_lint.py),并支持通过Google富媒体搜索结果测试、Yandex微数据验证器等工具进行验证。同时,它明确列出了已失效或不再产生效果的富媒体搜索结果类型,如FAQPage(2026年5月起)、HowTo(2023年起)等,避免用户投资无效优化。该技能是astudio-ai-seo工具集的一部分,适用于“микроразметка”、“schema.org”、“JSON-LD”、“rich snippets”等场景。工作流包括清单盘点、校验、按模板编写、数据源对齐、验证及差异对比部署。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whoamnesia/ai-seo/tree/HEAD/skills/schema-markup

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

astudio · 结构化数据标记 是做什么的?

<root> = 此技能基础目录的上两级。校验脚本: <root>/scripts/schema_lint.py。类型状态: <root>/reference/facts.md § 富媒体搜索结果状态。

结构化数据对AI回答并非必需(Google如是说),但它能明确陈述事实:你是谁、产品价格多少、你的位置、文章作者是谁。这有助于富媒体搜索结果、知识面板以及所有读取JSON-LD的消费者。只有当数据与页面显示内容一致时才有效。

工作流程

  1. 盘点页面模板(首页、分类、产品、文章、联系页面、活动、职位空缺)。
  2. 校验现有数据: 对每个模板执行 schema_lint.py <url>。
  3. 为每个模板选择类型(见下表)。每页一个 @graph;为实体赋予稳定的 @id 值(例如 https://site.ru/#organization)并在@graph 内引用,避免重复。
  4. 从与页面相同的数据源(CMS字段)生成JSON-LD,绝不能手动复制数字。
  5. 验证: 先用 schema_lint.py,然后使用Google富媒体搜索结果测试和Schema Markup验证器,在俄罗斯还需使用Yandex站长工具微数据验证器。将结果粘贴到报告。
  6. 展示差异;确认后部署。

按模板分类的类型

模板类型必须与页面匹配的内容
首页Organization(或LocalBusiness子类型)、WebSite名称、Logo、联系方式;sameAs 指向官方主页(VK、Telegram、Яндекс Карты、2ГИС、Wikipedia)
产品Product + Offer(+ AggregateRating、Review,如果显示)价格、货币 RUB、库存状态、评分值和数量
分类BreadcrumbList、ItemList(可选)面包屑导航文字
文章/博客Article/BlogPosting + Person(作者)标题、作者姓名及个人主页、日期
联系方式/分店带地址、地理坐标、营业时间、电话的LocalBusiness子类型与地图和目录一致的NAP信息
视频页面VideoObject缩略图、上传日期、时长
活动/课程/职位Event、Course、JobPosting日期、价格、地点、薪资
问答论坛页面QAPage真实的用户问题和回答

已淘汰或无效的类型(不要将其作为卖点)

FAQPage(自2026-05-07起无Google富媒体搜索结果)、HowTo(2023年起)、ClaimReview、EstimatedSalary、Learning Video、SpecialAnnouncement、Vehicle Listing、Book Actions(2025-06-12起)。仅当FAQPage/HowTo反映可见内容且被其他消费者使用时才保留,并明确说明没有Google SERP效果。

规则

  • 只标记用户能看见的内容。隐藏的评分、自卖自夸的评论以及与页面不符的价格违反Google政策,可能导致手动惩罚。
  • 价格: price 中使用不带空格的数字("4990"),priceCurrency: "RUB";HTML中显示相同价格。
  • 日期使用ISO 8601格式并带时区(例如 2026-11-06T10:00:00+03:00)。
  • 每个站点一个组织实体,通过 @id 引用。

示例:LocalBusiness

{"@context":"https://schema.org","@graph":[{"@type":"CafeOrCoffeeShop","@id":"https://zerno.ru/#org",
"name":"Кофейня «Зерно»","url":"https://zerno.ru/","logo":"https://zerno.ru/logo.svg","telephone":"+7 843 000-00-00",
"address":{"@type":"PostalAddress","streetAddress":"ул. Баумана, 1","addressLocality":"Казань","postalCode":"420111","addressCountry":"RU"},
"geo":{"@type":"GeoCoordinates","latitude":55.7887,"longitude":49.1221},
"openingHoursSpecification":[{"@type":"OpeningHoursSpecification","dayOfWeek":["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"],"opens":"08:00","closes":"22:00"}],
"sameAs":["https://vk.com/zerno","https://yandex.ru/maps/org/000"]}]}

相关技能