seo-onpage

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

On-Page SEO

Optimize a single page for search relevance, click-through, and crawler comprehension. Stack-agnostic. Works on any CMS, framework, or static site.

针对搜索相关性、点击率（CTR）和爬虫可读性优化单个页面。与技术栈无关，适用于任何CMS、框架或静态站点。

When to use

使用场景

Auditing or optimizing a single page (homepage, product page, article, landing page)
Writing or reviewing title tags and meta descriptions
Fixing header structure or content hierarchy
Reviewing internal links from or to a page
Improving a page's CTR from search results

审计或优化单个页面（首页、产品页、文章页、落地页）
撰写或审核标题标签与元描述
修复标题结构或内容层级
审核页面的内部入链或出链
提升页面在搜索结果中的点击率（CTR）

When NOT to use

不适用场景

Site-wide crawl, indexing, or speed issues (use
```
seo-technical
```
)
Keyword research or intent mapping (use
```
seo-keyword
```
)
Competitor SERP analysis (use
```
seo-competitor
```
)
Auditing many pages at once for prune/merge decisions (use
```
seo-content-audit
```
)

全站爬取、索引或速度问题（使用
```
seo-technical
```
）
关键词研究或意图映射（使用
```
seo-keyword
```
）
竞争对手SERP分析（使用
```
seo-competitor
```
）
批量审核页面以进行删减/合并决策（使用
```
seo-content-audit
```
）

Required inputs

必填输入

The page URL or the draft content if pre-launch
The primary target query (one phrase the page should rank for)
The page's role in the site (commercial, informational, navigational)

If the target query is unknown, run

seo-keyword

first or ask the user to name one.

页面URL，或预发布状态下的草稿内容
核心目标查询（页面需排名的单个短语）
页面在站点中的定位（商业型、信息型、导航型）

若目标查询未知，请先运行

seo-keyword

或询问用户提供。

The framework: 8 dimensions

框架：8个维度

A complete on-page audit covers eight dimensions. Score each as Pass, Needs work, or Fail. Note the specific fix.

完整的页面端SEO审计涵盖8个维度。每个维度评分分为“通过”“需改进”“不合格”，并记录具体修复方案。

1. Title tag

1. 标题标签

One unique title per URL across the site
Roughly 50 to 60 characters (longer gets truncated in SERPs)
Primary query near the front
Brand at the end if it earns inclusion
Distinct from the H1 (often very similar, but should not be identical word-for-word)

全站每个URL对应唯一标题
长度约50-60字符（过长会在SERPs中被截断）
核心查询置于标题前部
若品牌具备足够影响力，可放在标题末尾
与H1标题区分（可相似，但不可完全逐字相同）

2. Meta description

2. 元描述

One unique description per URL
Roughly 150 to 160 characters
Restates the value proposition, not the title
Includes a soft CTA where natural
Treats the description as ad copy that earns the click

每个URL对应唯一描述
长度约150-160字符
重述价值主张，而非重复标题内容
自然融入软性号召性用语（CTA）
将元描述视为吸引点击的广告文案

3. Header structure

3. 标题结构

Exactly one H1 per page
H1 contains or paraphrases the primary query
H2 sections cover the major sub-topics
H3+ used only when an H2 has genuine sub-points
No skipped levels (no H2 followed by H4)
Headers describe sections accurately enough that a reader could navigate by them alone

每页仅含一个H1标签
H1包含核心查询或其改写内容
H2标签覆盖主要子主题
仅当H2下存在真实子要点时使用H3及以上标签
不可跳过层级（如H2后直接使用H4）
标题需准确描述对应板块，确保读者仅通过标题即可导航

4. Body content

4. 正文内容

Opens with the primary user intent answered in the first paragraph
Covers the topic comprehensively (define your competition's depth, then match or exceed it)
Includes related entities and supporting concepts naturally
Avoids keyword stuffing (write for the reader, not the bot)
Reading level matches the audience (run a readability check)
Paragraphs short enough to scan on mobile (3 to 5 lines)

首段即回应核心用户意图
全面覆盖主题（明确竞品内容深度，达到或超越该标准）
自然融入相关实体与支撑概念
避免关键词堆砌（为读者写作，而非为爬虫）
阅读难度匹配目标受众（进行可读性检测）
段落长度适配移动端浏览（3-5行）

5. Internal links

5. 内部链接

At least 2 to 3 outbound internal links to closely related pages
At least 2 to 3 inbound internal links from related pages
Anchor text is descriptive, not "click here" or "learn more"
Links to canonical URLs, not redirects
No broken internal links

至少包含2-3个指向紧密相关页面的外部内部链接（出链）
至少包含2-3个来自相关页面的内部入链
锚文本具描述性，避免使用“点击此处”或“了解更多”
链接至规范URL，而非重定向链接
无失效内部链接

6. Images and media

6. 图片与媒体

Every meaningful image has descriptive alt text (skip alt for purely decorative images)
File names are descriptive ("blue-running-shoe.jpg" not "IMG_4032.jpg")
Modern format used where supported (WebP, AVIF)
Lazy loading on below-the-fold images
Width and height attributes set to prevent layout shift

所有有意义的图片均配有描述性alt文本（纯装饰性图片可省略）
文件名具描述性（如“blue-running-shoe.jpg”而非“IMG_4032.jpg”）
支持的情况下使用现代格式（WebP、AVIF）
对首屏以下图片启用懒加载
设置宽高属性以避免布局偏移

7. URL slug

Lowercase, hyphen-separated
Includes the primary query naturally (no stuffing)
Short (under 60 characters where possible)
No dates unless the page is genuinely time-bound
No session IDs, tracking parameters, or random hashes
Matches the site's URL pattern conventions

小写字母，连字符分隔
自然融入核心查询（避免堆砌）
简短（尽可能控制在60字符以内）
除非页面内容与时间强相关，否则不包含日期
无会话ID、跟踪参数或随机哈希值
符合站点URL模式规范

8. On-page schema

8. 页面Schema

Appropriate Schema.org type for the content (Article, Product, FAQPage, HowTo, Recipe, etc.)
Required properties filled (review Schema.org docs for the type)
Validates in Google's Rich Results Test or equivalent
Matches what is visible on the page (do not lie to crawlers)
Author and publisher schema linked correctly for content pages

使用与内容匹配的Schema.org类型（如Article、Product、FAQPage、HowTo、Recipe等）
填写必填属性（参考Schema.org对应类型文档）
在Google富媒体结果测试工具或同类工具中验证通过
与页面可见内容一致（不可向爬虫提供虚假信息）
内容页面需正确关联作者与发布者Schema

Workflow

工作流程

Confirm the target query. If unclear, ask. Do not optimize without one.
Render the page. View it as a user would. Read the content top to bottom.
View the rendered HTML. Inspect the actual served markup, not just the visual page. Check
```
<title>
```
,
```
<meta>
```
, headers, and schema in the source.
Run the 8-dimension framework. Score each, note specific fixes.
Prioritize. Group fixes into Critical (broken or missing), Important (suboptimal), and Nice-to-have (polish).
Write the report. Use the template in
```
references/audit-template.md
```
.
Offer to draft fixes. If the user wants, draft the new title, meta, headers, or copy directly.

确认目标查询：若不明确，询问用户。无目标查询则不进行优化。
渲染页面：以用户视角查看页面，自上而下阅读内容。
查看渲染后的HTML：检查实际返回的标记代码，而非仅视觉页面。在源码中查看
```
<title>
```
、
```
<meta>
```
、标题和Schema。
执行8维度框架：为每个维度评分，记录具体修复方案。
优先级排序：将修复分为“紧急（缺失或失效）”“重要（次优）”“锦上添花（优化）”三类。
撰写报告：使用
```
references/audit-template.md
```
中的模板。
提供修复草稿：若用户需要，直接撰写新的标题、元描述、标题或文案。

Failure patterns

错误模式

When you spot one of these, push back before delivering.

"Make it more SEO." Vague. Ask for the target query and what's broken first.
"Add the keyword 5 times in the body." Keyword density is not a real ranking signal. Prioritize relevance and topical depth instead.
Optimizing a page that is not crawlable or indexable. Check
```
seo-technical
```
first. No on-page work helps a noindexed page.
Optimizing a page with no clear user intent. A page that does not serve a real query will not rank no matter how well-tagged it is.
Targeting the same query as another page on the site. This is cannibalization. Use
```
seo-content-audit
```
to decide which page should rank.

当遇到以下情况时，需先与用户确认再交付结果。

“让它更符合SEO”：表述模糊。先询问目标查询和具体问题。
“在正文中添加5次关键词”：关键词密度并非真实排名信号。优先关注相关性与主题深度。
优化不可爬取或不可索引的页面：先使用
```
seo-technical
```
检查。页面若被标记为noindex，页面端优化毫无意义。
优化无明确用户意图的页面：若页面无法满足真实查询需求，无论标签设置多么完善都无法获得排名。
与站点内另一页面目标相同查询：这会导致关键词 cannibalization（内部竞争）。使用
```
seo-content-audit
```
决定哪个页面应获得排名。

Output format

输出格式

Default output is a markdown audit at

seo-audit-[page-slug].md

in the project root. Structure:

Page summary (URL, target query, role)
Score across 8 dimensions
Critical fixes
Important fixes
Nice-to-have polish
Drafted replacements (if requested)

Keep audits under 1500 words. If a page needs more detail, link to deeper appendices.

默认输出为项目根目录下名为

seo-audit-[page-slug].md

的Markdown审计报告，结构如下：

页面摘要（URL、目标查询、定位）
8个维度评分
紧急修复项
重要修复项
锦上添花优化项
修复草稿（若用户要求）

审计报告字数控制在1500字以内。若页面需要更多细节，可链接至深度附录。

Reference files

参考文件

```
references/audit-template.md
```
- Fillable audit template, copy and use.
```
references/onpage-checklist.md
```
- Quick-reference checklist for the 8 dimensions.
```
references/title-and-meta-patterns.md
```
- Patterns for writing strong titles and meta descriptions.

```
references/audit-template.md
```
- 可填充的审计模板，直接复制使用。
```
references/onpage-checklist.md
```
- 8维度快速参考清单。
```
references/title-and-meta-patterns.md
```
- 撰写优质标题与元描述的模板。