Back to Details

seo-onpage

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

On-Page SEO

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

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

工作流程

  1. Confirm the target query. If unclear, ask. Do not optimize without one.
  2. Render the page. View it as a user would. Read the content top to bottom.
  3. View the rendered HTML. Inspect the actual served markup, not just the visual page. Check 
    <title>
    , 
    <meta>
    , headers, and schema in the source.
  4. Run the 8-dimension framework. Score each, note specific fixes.
  5. Prioritize. Group fixes into Critical (broken or missing), Important (suboptimal), and Nice-to-have (polish).
  6. Write the report. Use the template in 
    references/audit-template.md
    .
  7. Offer to draft fixes. If the user wants, draft the new title, meta, headers, or copy directly.
  1. 确认目标查询：若不明确，询问用户。无目标查询则不进行优化。
  2. 渲染页面：以用户视角查看页面，自上而下阅读内容。
  3. 查看渲染后的HTML：检查实际返回的标记代码，而非仅视觉页面。在源码中查看
    <title>
    、
    <meta>
    、标题和Schema。
  4. 执行8维度框架：为每个维度评分，记录具体修复方案。
  5. 优先级排序：将修复分为“紧急（缺失或失效）”“重要（次优）”“锦上添花（优化）”三类。
  6. 撰写报告：使用
    references/audit-template.md
    中的模板。
  7. 提供修复草稿：若用户需要，直接撰写新的标题、元描述、标题或文案。

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:
  1. Page summary (URL, target query, role)
  2. Score across 8 dimensions
  3. Critical fixes
  4. Important fixes
  5. Nice-to-have polish
  6. 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审计报告，结构如下：
  1. 页面摘要（URL、目标查询、定位）
  2. 8个维度评分
  3. 紧急修复项
  4. 重要修复项
  5. 锦上添花优化项
  6. 修复草稿（若用户要求）
审计报告字数控制在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
     - 撰写优质标题与元描述的模板。