seo

SEO 技能 — 静态网站优化

用于静态 HTML 网站（GitHub Pages、Netlify、Vercel 等）的轻量级 SEO 审核与修复工具。无需构建工具。读取 HTML，报告缺少的内容并补上。

设置

首次使用前，告诉 Claude 关于你的网站的信息，以便它填写正确的值：

• 域名（例如 https://yourname.com）
• 页面（例如 index、about、resume、projects/foo）
• 社交资料（LinkedIn、GitHub、Twitter 等）
• 希望获得排名的关键词（例如“jane doe software engineer”“jane doe portfolio”）

Claude 会在当前会话中保存这些信息。只需告知一次。

---

调用时要执行的操作

读取网站源目录中的所有 HTML 文件。检查以下各项。输出通过/未通过表格，然后提出修复缺失项。

---

1. 每个页面 <head> 中的必备项

每个 HTML 页面都需要在 <head> 中包含以下内容：

<title>[Page Title] — [Your Name]</title>
<meta name="description" content="[unique, 150-160 chars, includes target keywords]">
<link rel="canonical" href="https://yourdomain.com/[path]/">


<meta property="og:title" content="[same as title or shorter]">
<meta property="og:description" content="[same as meta description]">
<meta property="og:image" content="https://yourdomain.com/[path-to-image]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://yourdomain.com/[path]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Your Name]">


<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[same as og:title]">
<meta name="twitter:description" content="[same as og:description]">
<meta name="twitter:image" content="https://yourdomain.com/[path-to-image]">

指南：

• 标题：50–60 个字符。姓名 + 差异化特点。
• Meta 描述：150–160 个字符，每个页面都应不同，并包含你的姓名 + 相关关键词。
• OG 图片：建议尺寸为 1200x630px。如果页面没有专属图片，则使用一张共享图片。使用网站中的真实图片，不要使用占位图。
• 规范 URL：必须与实际部署的 URL 完全一致（包括结尾斜杠的一致性）。

2. 结构化数据（JSON-LD）

在主页添加 Person + WebSite 架构：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "[Your Name]",
  "url": "https://yourdomain.com",
  "jobTitle": "[Your Title/Role]",
  "affiliation": {
    "@type": "Organization",
    "name": "[School or Company]"
  },
  "sameAs": [
    "[GitHub URL]",
    "[LinkedIn URL]"
  ],
  "knowsAbout": ["[skill1]", "[skill2]", "[skill3]"]
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "[Your Name] — [Portfolio Tagline]",
  "url": "https://yourdomain.com"
}
</script>

项目页面使用 CreativeWork：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreativeWork",
  "name": "[Project Name]",
  "author": { "@type": "Person", "name": "[Your Name]" },
  "description": "[Brief project description]",
  "url": "https://yourdomain.com/[project]/"
}
</script>

**规则：**仅使用 JSON-LD（不使用 Microdata/RDFa）。不要使用 FAQPage（仅限政府/医疗保健领域）。不要使用 HowTo（已弃用）。架构字段中不要包含占位文本。

3. robots.txt

在网站根目录创建：

User-agent: *
Allow: /

Sitemap: https://yourdomain.com/sitemap.xml

4. sitemap.xml

在网站根目录创建：

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://yourdomain.com/</loc>
    <lastmod>[YYYY-MM-DD]</lastmod>
    <priority>1.0</priority>
  </url>
  
</urlset>

将 lastmod 设为实际的最后编辑日期。页面变更时更新站点地图。

5. 图片 SEO

• 所有 <img> 标签都需要描述性 alt 文本（不要使用“image1”或“screenshot”）
• 尽可能使用 WebP，并将图片控制在 200KB 以下
• 为首屏以下的图片添加 loading="lazy"
• OG 图片应使用真实文件，不要使用占位图

6. 内容与关键词信号

• **H1 标签：**每页一个，包含姓名或项目名称 + 关键词
• **标题层级：**h1 > h2 > h3，不要跳过层级
• **正文中的姓名：**每个页面都应自然地出现你的姓名
• **内部链接：**页面之间应互相链接（主页链接到项目页、关于页面链接到项目页等）
• **外部链接：**在关于页面/主页中链接到社交资料

7. 技术检查

• **HTTPS：**确认所有内部链接和资源都使用 https://
• **结尾斜杠一致性：**选择一种格式，并在所有链接、规范 URL 和站点地图中保持一致
• **没有失效链接：**检查所有 href 和 src 属性是否可正常访问
• **适配移动设备：**所有页面都包含 viewport meta 标签
• **页面速度：**延迟加载非关键脚本。对于静态网站，尽量减少 JS 是良好的基础做法。

8. 部署后验证

部署后：

1. 直接访问 /robots.txt 和 /sitemap.xml，确认它们可以正常访问
2. 在 Discord/Slack/Twitter 上分享链接并检查预览卡片，以测试 OG 标签
3. 在 Google Search Console 中提交站点地图
4. 几天后搜索 site:yourdomain.com，确认页面已编入索引
5. 搜索目标查询词并跟踪排名变化

9. 设置 Google Search Console

1. 前往 Google Search Console，为你的域名添加资源
2. 通过 DNS TXT 记录或 HTML 文件方式验证
3. 提交站点地图 URL
4. 查看覆盖率报告中的索引问题

---

快速审核输出

执行审核时，读取所有 HTML 文件并输出：

检查项	状态	备注
Meta 描述	...	...
OG 标签	...	...
JSON-LD 架构	...	...
robots.txt	...	...
sitemap.xml	...	...
图片 alt 文本	...	...
H1 标签	...	...
内部链接	...	...
规范 URL	...	...

然后提出修复缺失项。