Contentful SEO:无头 CMS 设置与更快的 LCP
简短回答 Contentful 只负责存放您的内容;开发者在它之上搭建的网站才决定您的 SEO。请检查:每个页面都有自己的 SEO 标题、描述和 slug;页面以完整的 HTML 交给 Google;顶部图片经过缩放、以 WebP 或 AVIF 格式提供,并且绝不延迟加载。
想把这些用到您的生意上?预约一次 30 分钟的免费通话,一起聊聊。
预约通话Contentful SEO 检查清单:查什么、谁来做
Contentful 是一种无头 CMS(headless CMS):它存放您的文字和图片,再由开发者编写的独立前端把它们变成用户和 Google 看到的页面。所以 Contentful 网站上的 SEO 大多是代码,而不是某个设置选项卡。请和搭建网站的人一起逐项核对这张表。
| # | 检查项 | 在哪里 | 怎么判断已完成 |
|---|---|---|---|
| 1 | 每种页面类型都有 SEO 标题和元描述 | 内容模型中的字段,由网站代码输出 | 查看网页源代码:您的标题和描述就在靠近顶部的位置 |
| 2 | 必须唯一的 slug 字段 | 内容模型 | 两个条目不能用同一个 slug 发布 |
| 3 | 页面以完整的 HTML 交给 Google | 网站代码(预构建或服务器端渲染) | 您的标题和服务介绍文字出现在网页源代码中 |
| 4 | “不在搜索中显示”开关 | 内容模型中的字段,输出为 noindex 标签 | 打开后,该页面源代码中会多一行 robots noindex |
| 5 | 指向页面自身地址的 canonical 标签 | 网站代码 | 源代码中有一个指向页面自身网址的 canonical 链接 |
| 6 | 站点地图和 robots.txt | 网站代码或托管服务 | yourdomain.com/sitemap.xml 和 /robots.txt 能打开 |
| 7 | slug 修改或页面删除时设置 301 重定向 | 网站代码或托管服务 | 旧地址会跳转到新页面 |
| 8 | 以结构化数据呈现商家信息 | 网站代码,从 Contentful 字段读取 | Google 的富媒体搜索结果测试能找到它 |
| 9 | 经过缩放、采用新格式的图片 | 网站代码中的 Images API 设置 | 图片地址中包含 w= 和 fm=webp 或 fm=avif |
| 10 | 发布后网站随之更新 | 发送给托管服务的 Contentful webhook | 已发布的修改会出现在线上网站 |
| 11 | 已连接 Google Search Console | 您的 Google 账号 | “网页”报告中列出了您的页面 |
第 1、2、4 项是开发者一次性添加的字段;之后由您逐页填写。其余都是代码。站点地图、robots.txt 和重定向都在您自己的域名上,所以它们来自网站代码或托管服务,而不是 Contentful 编辑器。
Contentful 对 SEO 好吗?
它是中性的。Contentful 并不生成 Google 读取的页面,所以它本身既不会帮助也不会损害您的排名。它的文档把这项工作交给了前端:
"To ensure that search engines can consume the SEO metadata, the frontend application needs to render the values in the corresponding HTML meta-tags." (Contentful Docs: Compose content model and SEO) 译文:“为确保搜索引擎能够读取 SEO 元数据,前端应用需要把这些值输出到对应的 HTML meta 标签中。”
在 Wix 或 Squarespace 这类托管建站工具上,SEO 设置是内置的。在 Contentful 上,只有有人添加了 SEO 字段,这些字段才会存在。即使是用 Contentful 的可视化页面构建器 Studio 做的页面,通常也只自带标题和 slug;它的指南展示的是开发者自己添加 SEO 标题和描述字段(Contentful Docs: Experience reference fields for metadata)。
取舍在于:同一套内容可以同时供给网站、应用等多个渠道,但建站工具自带的每一项 SEO 功能,都得自己搭建并持续维护。
要添加到 Contentful 内容模型中的 SEO 字段
请开发者在每一个会变成页面的内容类型上添加这些字段:
| 字段 | Contentful 字段类型 | 设置 | 在页面上变成 |
|---|---|---|---|
| SEO 标题 | Short text | 必填、唯一 | title 标签,也就是 Google 中的蓝色链接 |
| 元描述 | Short text | 必填 | 常显示在链接下方的摘要 |
| Slug | Short text | 必填、唯一 | 页面地址的结尾部分,例如 /drain-cleaning |
| 不在搜索中显示 | Boolean | 默认关闭 | 打开时输出 robots noindex 标签 |
| Canonical 网址 | Short text | 可选,默认留空 | canonical 标签;留空表示页面自身地址 |
| 分享图片 | Media | 可选 | 页面被分享时显示的图片 |
当另一个条目已有相同的值时,Contentful 的“唯一”设置会阻止发布:它“Validates that there are no other entries that have the same field value at the time of publication”(在发布时验证没有其他条目具有相同的字段值)(Contentful Docs: Content types)。请把它用在标题和 slug 上,这样不会有两个页面共用一个标题,或抢占同一个地址。Google 的 JavaScript SEO 指南说,唯一且有描述性的标题和元描述能帮助搜索者选出正确的结果。
不要添加关键词字段。Contentful 较早的 Compose SEO 模型里有这个字段,但 Google 表示:
"The meta-keyword tag is not used by Google Search, and it has no effect on indexing and ranking at all." (Google Search Central: Meta tags and attributes that Google supports) 译文:“Google 搜索不使用 meta keywords 标签,它对编入索引和排名完全没有影响。”
这些字段可以放在每种页面类型上,也可以像 Compose 那样放在一个单独的“SEO”内容类型中,再由每个页面链接过去。后一种做法能把它们集中在一处。
Google 会把 Contentful 网站编入索引吗?
会,只要页面以可读的 HTML 交给 Google。一个 30 秒的测试:打开一个服务页面,右键点击,选择“查看网页源代码”,再搜索页面上的一句话。找到了?说明页面是预构建或服务器端渲染的。大部分是围着一个空容器的脚本?说明页面是在访问者的浏览器里拼出来的,这叫客户端渲染。
Google 可以运行这些 JavaScript,但要先在渲染队列中等待。它的建议是:
"Keep in mind that server-side or pre-rendering is still a great idea because it makes your website faster for users and crawlers, and not all bots can run JavaScript." (Google Search Central: JavaScript SEO basics) 译文:“请记住,服务器端渲染或预渲染仍然是很好的做法,因为它能让您的网站对用户和抓取工具都更快,而且并非所有机器人都能运行 JavaScript。”
AI 助手就属于这些机器人。在 2024 年 12 月一项针对 Vercel 托管网络流量的研究中,Vercel 和 MERJ 发现,包括 OpenAI、Anthropic 和 Perplexity 在内,主要的 AI 抓取工具都不渲染 JavaScript;Google 的 Gemini 使用 Googlebot 的那套设施,因此可以。所以一个只在浏览器里生成的页面,在 ChatGPT 和 Claude 看来可能是空白的。
| 页面如何生成 | Google 首先拿到的内容 | AI 抓取工具(2024 年研究) | 对加载速度的影响 |
|---|---|---|---|
| 发布时预构建(静态) | 完整的 HTML | 能读取 | 通常最快 |
| 每次访问时服务器端渲染 | 完整的 HTML | 能读取 | 快;服务器处理时间会稍微增加 |
| 在浏览器中生成(客户端) | 一个几乎空白的外壳,稍后才渲染 | 没有读取 | 慢:主图要等脚本 |
| 动态渲染(机器人拿到 HTML,用户拿到脚本) | 完整的 HTML | 取决于设置 | 对用户慢,同上 |
关于最后一行,Google 表示“Dynamic rendering was a workaround and not a long-term solution”(动态渲染只是权宜之计,不是长期方案),并建议改用服务器端渲染、静态渲染或 hydration(Google Search Central: Dynamic rendering as a workaround)。
预构建的网站还需要一个 Contentful webhook,也就是有人发布时发给托管服务的一条消息,用来“trigger a website rebuild”(触发网站重新构建)(Contentful Docs: Webhooks overview)。没有它,改好的标题可能一直留在 Contentful 里,永远不会上线。
Google 的 JavaScript 指南中还有两项检查:
- 菜单使用真正的链接,带有地址,而不是点击处理程序或 # 片段。Google 表示,它只能发现带 href 的标准 HTML 链接。
- 看看 Google 渲染出了什么。 在 Search Console 中,网址检查工具会显示渲染后的 HTML。Google 表示:“If the content isn't visible in the rendered HTML, Google won't be able to index it.”(如果内容在渲染后的 HTML 中不可见,Google 就无法将其编入索引。)
页面被发现却没有进入 Google:已抓取或已发现,尚未编入索引。
如何改善 Contentful 网站的 LCP
LCP(Largest Contentful Paint,最大内容绘制)是首屏上最大的元素——通常是顶部图片或大标题——完成显示的时间。Google 的 PageSpeed Insights 把 2.5 秒或更短算作良好,4 秒以内算作需要改进,超过 4 秒算作较差。它对排名的影响有多大:Core Web Vitals 与 Google 排名。
在 Contentful 网站上,最常见的问题出在顶部图片。按顺序检查这些:
| 原因 | 解决办法 |
|---|---|
| 图片按上传时的原样提供 | 在图片地址中加上 Images API 参数:w(宽度,最大 4,000 px)、fm=webp 或 fm=avif(格式)、q(质量,1 到 100)。结尾示例:?w=1600&fm=webp&q=75 |
| 手机拿到的是桌面尺寸的文件 | 为小屏幕请求更小的宽度 |
| 顶部图片被延迟加载 | 只从这一张图片上去掉 loading="lazy" |
| 浏览器不知道它很重要 | 给这张图片设置 fetchpriority="high";web.dev 表示,把它用在一两张以上的图片上就不再有帮助 |
| 图片从另一个域名加载 | Contentful 从 images.ctfassets.net 提供图片,这需要额外建立一次连接。请预连接(preconnect)到这个域名;web.dev 表示,从您自己的域名提供图片最好 |
| 页面在浏览器中生成 | 改为预构建或服务器端渲染,让图片从一开始就在 HTML 中 |
| 服务器发送页面太慢 | 预构建页面,或在 CDN(内容分发网络)上缓存服务器端渲染的页面 |
两个事实可以纠正最常见的错误。Contentful 的默认格式“is the original image format”(就是图片的原始格式)(Contentful Docs: Images API),所以一张 5 MB 的手机 JPEG,除非代码要求更小,否则仍是 5 MB。另外,来自 Google web.dev 团队:
"Never lazy-load your LCP image, as that will always lead to unnecessary resource load delay, and will have a negative impact on LCP." (web.dev: Optimize Largest Contentful Paint) 译文:“永远不要延迟加载您的 LCP 图片,因为这总会造成不必要的资源加载延迟,并对 LCP 产生负面影响。”
web.dev 还提醒,有些工具会自动给图片加上延迟加载,所以请检查第一张图片。
Contentful 有两个限制:AVIF 转换只适用于不超过 900 万像素的源图片,超过 100 MB 的上传文件则完全不会被转换(Contentful Docs: Technical limits)。一张 1,200 万像素的手机照片(4,000 × 3,000)超出了 AVIF 限制,所以请在上传前缩小尺寸,或改用 WebP。
不要做 AMP。Google“applies the same standard to all pages, regardless of the technology used to build the page”(对所有页面采用相同标准,无论用什么技术构建)(Google Search Central: About AMP on Google Search)。
Contentful 的费用,以及您是否需要它
Contentful 的价格页面列出三个方案(以 2026 年 7 月的存档为准;线上页面阻止了自动读取):
| 方案 | 价格 | 主要限制 |
|---|---|---|
| Free | $0 | 10 个用户,2 个语言区域(locale,即语言版本),每月 100,000 次 API 调用和 50 GB 图片与文件流量,不允许超额;25 个内容类型和 10,000 条记录 |
| Lite | 每月 $300 | 20 个用户,3 个语言区域,每月 100 万次 API 调用和 100 GB |
| Enterprise | 定制 | 可视化页面构建器 Studio 和个性化功能在此方案中提供 |
托管和开发者是另外的费用。预构建的网站在重新构建时才调用 Contentful 的 API,而不是每次访问都调用;但从 Contentful 提供的图片会计入流量。
对一个 10 个页面的服务类企业网站来说,无头架构通常超出您的需要:托管建站工具无需写代码就自带上面清单中的设置。当一套内容要供给多个网站、应用或语言时,无头架构才值得。如果您的网站是代理公司搭建的,请确保 Contentful 组织、代码和托管账号都归您的企业所有:离开代理公司而不失去网站。
示例
以下为示意案例;数字均为虚构。
一家首页很慢的牙科诊所集团(美元)
首屏大图是一张 6 MB 的 JPEG,被模板设置为延迟加载,移动端 LCP 为 5 秒。开发者加上 ?w=1600&fm=webp&q=75,去掉延迟加载,并将其标记为高优先级。文件降到约 300 KB。成本:开发者两个小时,约 $300。
一家页面源代码为空白的律师事务所
代理公司搭建的是一个只在浏览器中运行的应用。“查看网页源代码”显示一个空容器,Search Console 把大多数页面列为未编入索引,ChatGPT 也说不出该所的执业领域。事务所改用预构建页面并配置重新构建的 webhook,同时保留原有的 Contentful 内容。
一位修改了 slug 的园林绿化商
老板在 Contentful 中把“services-1”改成了“lawn-care”。旧地址现在显示 404,而一个每月 $400 的广告仍然指向那里。开发者在托管服务上添加了 301 重定向,也就是 Google 建议在地址变更时使用的“permanent server-side redirect”(永久性服务器端重定向)(Google Search Central: Redirects and Google Search)。
常见问题
Contentful 会自动添加 title 标签和元描述吗?
不会。Contentful 只存放文字,网站代码必须把它输出到页面中。查看几个页面的源代码来确认。
无头 CMS 会让网站变快吗?
本身不会。速度取决于前端如何生成页面、如何处理图片;在浏览器中生成的页面可能比普通建站工具做的网站还慢。
一个小型 Contentful 网站需要站点地图吗?
Google 表示,约 500 个页面或更少、内部链接良好的网站可能不需要。在无头网站上,没有任何东西会自动生成站点地图,所以如果您想要,请开发者根据您的 slug 生成。
可以在 Contentful 中修改页面的 slug 吗?
可以,但除非在网站代码或托管服务上设置了 301 重定向,否则旧地址会失效。只在必要时修改 slug。
您的情况不同?
- 还在选择平台:Wix、Squarespace 还是 WordPress 更利于 SEO。
- 迁入或迁出 Contentful:网站改版后流量下降。
- 页面被发现但没有进入 Google:已抓取或已发现,尚未编入索引。
- 为 Google 和 AI 添加商家信息:本地商家结构化数据。
- 学习 Search Console 的其他功能:小企业的 Google Search Console 指南。
- 账号在代理公司手里:我的网站归谁所有?
- 想要一个快速的网站,并一直保持快速:网站智能体。