Open Graph 检查器

下一步

粘贴页面的 HTML(仅 <head> 部分即可),这个检查器会解析它找到的每一个 og:twitter: 元标签,然后报告六个必需标签中哪些存在、哪些缺失,以及每个标签的确切值。由于它读取的是你粘贴的标记,而非抓取线上 URL,因此在测试服务器、localhost 以及登录后才能访问的页面上也能使用,而这些地方是在线抓取器无法触及的。

检查器如何读取你的标签

  1. 1

    打开页面源代码

    按 Ctrl+U(macOS 上为 Cmd+Option+U)查看社交爬虫实际接收到的原始 HTML。

  2. 2

    复制 head 部分

    从 `<head>` 选择到 `</head>`。正文(body)无需选取,不过粘贴整个页面也无妨。

  3. 3

    粘贴到检查器中

    每个 `<meta>` 标签都会在你输入时被解析。不会抓取任何 URL,只检查你粘贴的标记。

  4. 4

    查看检查清单

    六项检查会变绿或变红:og:title、og:description、og:type、og:url、og:image 和 twitter:card。

  5. 5

    查看找到的值

    每个 og: 和 twitter: 标签都会连同其内容一起列出,因此拼写错误、空值和相对图片路径都会一目了然。

检查器查找的 Open Graph 标签

标签 用途 是否在检查清单中?
og:title 卡片标题 是,必需
og:description 卡片副标题 是,必需
og:type websitearticlevideo 是,必需
og:url 规范(canonical)URL 是,必需
og:image 预览图片 URL 是,必需
og:site_name 标题上方的品牌行 存在时列出
og:locale en_USes_ES 存在时列出

标记中的任何其他 og: 标签也会被列出,即使它不在检查清单之列。

Twitter Card 标签

当自身标签缺失时,X(Twitter)会回退到 Open Graph,因此检查清单中只有 twitter:card。其余标签只要检查器找到就会列出。

标签 用途
twitter:card summarysummary_large_image
twitter:site 发布账号的 @用户名
twitter:creator 作者的 @用户名
twitter:title 覆盖 og:title
twitter:description 覆盖 og:description
twitter:image 覆盖 og:image

通用适配的图片规格

检查器会确认 og:image 已声明,但它绝不会下载文件,因此请手动核对以下各项:

  • 尺寸: 1200 x 630 px(Facebook、LinkedIn、大型 Twitter 卡片)。
  • 宽高比: summary_large_image 为 1.91:1。
  • 文件大小: 小于 5 MB,最好小于 1 MB,以免爬虫超时。
  • 格式: JPG 或 PNG。WebP 和 AVIF 目前仍未获得一致支持。
  • 绝对 URL: 始终使用完整的 https://... 地址,切勿使用协议相对路径或根目录相对路径。

报告揭示的常见问题

  • 缺少 og:image。 最常见的单项失败。没有图片,卡片会退化为没有样式的蓝色链接。
  • 标签存在但为空。 检查器会打印每个值,因此后面空无一物的 og:title 很容易被发现。
  • 相对图片路径。 og:image 必须是绝对 URL;/img/card.jpg 这样的路径会破坏抓取。
  • og:url 不匹配。og:url 与真实的规范 URL 不同时,平台可能拒绝抓取该页面。
  • 由 JavaScript 注入的标签。 它们不会出现在 view-source 中,因此这里也不会出现,而且大多数爬虫也看不到它们。
  • Facebook 上的过期卡片。 这不是标记问题:Facebook 会缓存其抓取结果。请在其 Sharing Debugger 中强制刷新。

常见问题

因为粘贴标记能准确显示社交爬虫在原始响应中所看到的内容,而且它在任何爬虫都无法访问的页面上也能使用:测试服务器、localhost、内网,以及登录后才能访问的一切页面。打开你的页面,按 Ctrl+U,复制源代码,粘贴到这里即可。

并非严格必需。当 twitter: 标签缺失时,X 会回退到 Open Graph 标签,这正是检查清单中只有 twitter:card 的原因。只有当你希望在 X 上使用与其他所有平台不同的标题、描述或图片时,才需要添加其余标签。

检查器(inspector)显示的是 JavaScript 运行之后的 DOM,而社交爬虫读取的是原始 HTML 响应。请使用 view-source(Ctrl+U)而非检查器,并粘贴其中的内容。如果该标签只存在于 DOM 中,请添加服务器端渲染或预渲染服务,让爬虫能够看到它。

1200 x 630 px 的 JPG 或 PNG。这是大型 Facebook 和 LinkedIn 卡片的推荐尺寸,X 也接受它,并且在 Slack、Discord 及其他链接展开应用中都能干净地缩放。检查器会确认 og:image 已声明,但不会打开文件,因此请自行核对尺寸。

Facebook 会将抓取结果缓存最长 30 天。请将 URL 粘贴到 developers.facebook.com/tools/debug 的 Sharing Debugger 中重新抓取,以使缓存失效。

相关工具

此工具还提供其他语言版本