Skill/搜索优化/Schema
搜索优化 57.6k 仓库 Star

Schema

让页面信息有清楚的标记

Schema 用来为页面编写结构化数据,帮助搜索系统识别商品、文章、组织或导航路径等信息。它先核对页面实际内容与现有标记,再选择适合的类型和字段,输出便于维护的 JSON-LD,并安排验证,减少重复或相互矛盾的声明。

你需要准备:页面地址或源码、页面类型与真实商品或文章信息

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Schema 能帮你做什么?

  • 选择合适类型

    依据页面的主要内容判断适合标记什么,而不是把所有可选类型都加上。

  • 编写关联字段

    把实际名称、地址、文章信息等组织为一致的实体,避免不存在的评价或数据。

  • 验证与维护

    检查语法、字段要求和页面一致性,内容变化后提醒同步相关标记。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 完善商品详情标记

    示例场景:根据页面已有名称、价格和库存信息编写标记,缺少的字段不凭空补齐。

  • 整理文章与面包屑

    示例场景:为有明确作者、发布日期和栏目路径的文章核对标记及实体之间的关系。

怎么开始使用?

从材料到结果流程示意,非实测结果

你提供的材料

准备这些材料结构化数据

页面地址或源码、页面类型与真实商品或文章信息

处理流程示意

  1. 01

    确认页面内容与类型

  2. 02

    编写或修正标记

  3. 03

    验证字段与页面一致性

准备什么,会得到什么?

准备的材料
页面地址或源码、页面类型与真实商品或文章信息
交付的结果
  • 适合当前页面的 JSON-LD 及修改说明。
  • 验证结果与内容更新时的同步检查项。

使用前要知道

标记必须与真实页面一致,不保证搜索富结果或星级展示。动态注入内容需浏览器检查,不能只看抓取文本;本站未实测。

常见问题

加 FAQ 标记就能多占搜索位置吗?

Google 已于 2026 年 5 月 7 日停止展示 FAQ 富结果,不能靠 FAQ 标记获得这种搜索展示。问答内容仍可帮助读者理解页面,是否添加标记要看目标使用方;词汇有效不等于能获得搜索展示。

网站已经有结构化数据怎么办?

先检查现有实现、重复实体和冲突字段,再做有依据的修改,避免盲目新增第二份相同标记。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • Schema · Skill 源文件 ↗2026-10-31 核对
  • Google Search 官方更新:FAQ 富结果停止展示 ↗2026-10-31 核对
来源与使用条件
原始项目
coreyhaines31/marketingskills ↗
Skill 名称
schema
Skill 目录
skills/schema
仓库 Star
57,612 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
MIT
使用条件
需要读取页面源码及真实内容。动态页面应在浏览器渲染后检查;验证标记需可用的结构化数据测试工具,查看收录反馈需相应站点权限。
注意事项
项目 README 明确支持 Codex,采用 MIT 许可。安装时保留对应目录内的 references 等资源;本站未安装或运行实测。 标记必须对应页面可见事实,不能保证搜索富结果。
查看安装与使用提示词
请帮我准备并使用 Schema Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/coreyhaines31/marketingskills
所选目录:skills/schema
参考分支:main
原始目录 frontmatter name:schema
安装后的目标调用名:schema
来源页面:https://github.com/coreyhaines31/marketingskills/tree/main/skills/schema
安装路线核对日期:2026-11-01
当前 SKILL.md(已重新核对名称与资源引用):https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/SKILL.md
上游安装说明:https://github.com/coreyhaines31/marketingskills/blob/main/README.md
Codex 官方 Skill 目录与自动发现规则:https://learn.chatgpt.com/docs/build-skills
可选集成工具与凭据条件:https://github.com/coreyhaines31/marketingskills/blob/main/tools/SETUP.md

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是完整目录安装路线。优先使用当前 Codex 自带的 $skill-installer,明确传入仓库 coreyhaines31/marketingskills、目录 skills/schema、分支 main、安装名 schema,并把 --dest 设为已解析的目标 .agents/skills 绝对路径。目录为“.”时表示仓库根目录,仍要传入安装名。不要猜测安装器在本机的固定路径。如果没有内置安装器,按下列项目说明从原仓库获取完整目录,保留全部配套文件。

所选 Skill 的具体安装步骤:
1. 先解析当前项目根目录,以该项目的 .agents/skills 为本次目标;查找已有 schema,已有本地修改时保留,避免覆盖或在用户目录重复安装。
2. 使用 Codex 自带 skill-installer 的 install-skill-from-github.py;参数明确为 --repo coreyhaines31/marketingskills --path skills/schema --ref main --name schema --dest <project>/.agents/skills;<project> 要先解析为当前项目绝对路径。完整保留所选目录,不只下载 SKILL.md。
3. 首次使用先查当前业务项目 .agents/product-marketing.md;兼容读取 .claude/product-marketing.md 或旧 product-marketing-context.md。它是项目产品资料,不是安装文件,不覆盖已有内容;缺失时只补本任务必要事实,不强制安装所有 Related Skills。
4. 确认目标目录 schema/SKILL.md 的 frontmatter name 为 schema,并按 resources 保留引用资源和许可文件。
5. Codex 会自动发现项目 .agents/skills;在当前项目查看 Skill 列表。只有未出现时才新建聊天或重载,不把强制重启写成每次安装步骤。

必须保留的资源:
- skills/schema/SKILL.md
- skills/schema/evals
- skills/schema/references
- 当前业务项目可选的 .agents/product-marketing.md(兼容旧路径);保留现有内容,不复制上游示例冒充真实产品资料
- 仓库 MIT LICENSE 与来源记录

已知依赖:需要读取页面源码及真实内容。动态页面应在浏览器渲染后检查;验证标记需可用的结构化数据测试工具,查看收录反馈需相应站点权限。
原项目许可:MIT
特别条件:项目 README 明确支持 Codex,采用 MIT 许可。安装时保留对应目录内的 references 等资源;本站未安装或运行实测。 标记必须对应页面可见事实,不能保证搜索富结果。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 只读检查 references/schema-examples.md 和目标页面现有 JSON-LD,不修改站点作为安装检查。
2. 只读检查已安装 SKILL.md 的 name、所列引用文件与目录存在,元数据调用名使用 schema。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $schema;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 先确定页面类型与用户可见的真实信息,查看已有结构化数据,再给适用的 JSON-LD 与字段说明。
- 对实际页面和生成标记做一致性校验;没有真实评分、价格或问答时不补造字段,部署与验证按用户目标页面执行。

我想完成的任务:
检查我页面现有的结构化数据,依据真实内容选择适合的类型,补齐或修正 JSON-LD。保留有效标记,检查字段、实体关联和动态渲染结果;只报告实际完成的验证。

需要我提供的材料:
页面地址或源码、页面类型与真实商品或文章信息

期望得到:
适合当前页面的 JSON-LD、修改说明与验证结果。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • SEO Audit站点 SEO 检查
  • AI SEOAI 搜索优化
  • Programmatic SEO批量长尾页面

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。