example-petstore.com

示例域名 · 并非真实服务 · 浏览器访问显示此页面 · API 请求返回 410 Gone

指南 · 结构化数据

站点链接搜索框与网站名称

成千上万的网站复制了 Google 的站点链接搜索框示例，并以 query.example-petstore.com 作为搜索地址。这项功能已经取消，但相关标记依然随处可见。本指南将说明它当初的作用，以及现在应改用什么。

该标记的作用

Google 可以直接在网站的搜索结果下方显示一个搜索框。网站通过一个包含 SearchAction 的 WebSite 代码块来申请该功能。搜索者输入的内容会替换 target 中的 {search_term_string}，然后 Google 会将其引导至该地址，即网站自己的搜索结果页。

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "url": "https://www.example-petstore.com/",
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://query.example-petstore.com/search?q={search_term_string}",
    "query-input": "required name=search_term_string"
  }
}

在 Google 的示例中，query.example-petstore.com 是虚构的宠物商店搜索页地址，从未真实存在过。早在 2014 年，Google 就要求目标地址必须与网站位于同一域名，因此这个示例目标对任何其他网站都不可能生效。

时间线

  1. 2014年9月 — Google 文档的第一个版本使用 host.example-petstore.com/search?q={search_term}，一直沿用到 2014年9月底。
  2. 2014年10月至 2015年年中 — 流传最广的版本使用 query.example-petstore.com/search?q={search_term_string}，被 SEO 博客、论坛软件和主题大量复制。
  3. 2015年 — Google 文档改用 example.com（最晚在 2015年9月）。
  4. 2024年11月21日 — Google 在全球范围内停止显示站点链接搜索框。残留的标记不会在 Google 搜索或 Search Console 中导致错误。

现在应使用什么

SearchAction 在 Google 搜索中已不再产生任何可见效果。但包含您自己的名称和地址的 WebSite 代码块仍有助于 Google 选择在搜索结果中显示的网站名称。请只将其放在首页上：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "Your site name",
  "url": "https://www.example.com/"
}
</script>

您可以为常用的简称添加 alternateName。请省略 potentialAction；如果仍有其他使用方依赖它，也可以将其指向您自己的搜索页。

修复方法

  1. 打开首页的源代码，搜索 example-petstore。
  2. 如果该代码块来自您的主题或“自定义 head 代码”字段，请在那里修改。如果来自 SEO 插件，请检查插件设置：Yoast SEO、Rank Math 和 All in One SEO 都是根据您自己的地址生成标记。
  3. 将 url 替换为您自己的首页，并将 name 设为您的网站名称。删除 SearchAction。
  4. 如需同时删除插件生成的搜索操作：Yoast add_filter( 'disable_wpseo_json_ld_search', '__return_true' );，Rank Math 过滤器 rank_math/json_ld/disable_search，All in One SEO 在 Search Appearance › Advanced 中关闭 Enable Sitelinks Search Box。SEOPress 已在 8.4 版（2024年12月）中将其移除。
  5. 在 Search Console 中，对您的首页使用 URL Inspection › Request indexing。

验证

  • 网页源代码中只有一个 WebSite 代码块，其中包含您自己的 name 和 url。
  • Schema Markup Validator 显示该项且没有错误。富媒体搜索结果测试不涵盖网站名称。
  • 您网站上没有任何网页提及 example-petstore.com。

来源