Communitygithub.com

个人网站:SEO 让别人搜名字就找到你

轻量级 Claude Code SEO Skill,专为静态作品集和个人站:对 meta 标签、Open Graph、Twitter 卡片、JSON-LD、robots.txt、sitemap、图片、标题层级和链接做 9 项审计,并把所有修复直接写进 HTML。

个人网站:SEO 让别人搜名字就找到你 是什么?

「个人网站」配方第 3 步(让人搜得到),来自 aevans-eng/seo-skill。输入 /seo,或者直接问「为什么搜我的名字找不到我的网站」。Agent 读取你部署在 GitHub Pages、Netlify 或 Vercel 上的 HTML,执行 9 项审计:title、description 与 canonical;Open Graph 和 Twitter Card;首页的 Person 与 WebSite JSON-LD、项目页的 CreativeWork;robots.txt 与 sitemap.xml;图片 alt、懒加载和体积;每页一个 H1、标题层级和内链;HTTPS 与失效链接;以及上线后的 Search Console 步骤。它输出通过/失败表格并主动补齐全部内容,分享卡片直接复用站内已有图片。无需构建工具,也不调用 API。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SEO技能 — 静态网站优化

轻量级SEO审计与修复工具,适用于静态HTML网站(GitHub Pages、Netlify、Vercel等)。无需构建工具。读取您的HTML,报告缺失内容,并自动添加。

设置

首次使用前,请告知Claude您的网站信息,以便填充正确的值:

  • 域名(例如 https://yourname.com)
  • 页面(例如 index、about、resume、projects/foo)
  • 社交媒体资料(LinkedIn、GitHub、Twitter等)
  • 您希望排名的关键词(例如 “张三 软件工程师”、“张三 作品集”)

Claude会在会话内存储这些上下文。您只需说明一次。


调用后的操作

读取网站源目录中的所有HTML文件。检查以下每一项。输出通过/失败的表格,然后提供修复缺失项的功能。


1. 每个页面的 <head> 必备元素

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

<title>[页面标题] — [您的名字]</title>
<meta name="description" content="[唯一描述,150-160字符,包含目标关键词]">
<link rel="canonical" href="https://yourdomain.com/[路径]/">

<!-- Open Graph -->
<meta property="og:title" content="[与标题相同或更短]">
<meta property="og:description" content="[与meta描述相同]">
<meta property="og:image" content="https://yourdomain.com/[图片路径]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://yourdomain.com/[路径]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[您的名字]">

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[与og:title相同]">
<meta name="twitter:description" content="[与og:description相同]">
<meta name="twitter:image" content="https://yourdomain.com/[图片路径]">

指南:

  • 标题: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": "[您的名字]",
  "url": "https://yourdomain.com",
  "jobTitle": "[您的职位/角色]",
  "affiliation": {
    "@type": "Organization",
    "name": "[学校或公司]"
  },
  "sameAs": [
    "[GitHub URL]",
    "[LinkedIn URL]"
  ],
  "knowsAbout": ["[技能1]", "[技能2]", "[技能3]"]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "[您的名字] — [作品集标语]",
  "url": "https://yourdomain.com"
}
</script>

对于项目页面,使用 CreativeWork:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreativeWork",
  "name": "[项目名称]",
  "author": { "@type": "Person", "name": "[您的名字]" },
  "description": "[项目简要描述]",
  "url": "https://yourdomain.com/[项目]/"
}
</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://
  • 尾斜杠一致性: 选择一个模式并在所有链接、规范和站点地图中保持一致
  • 无死链: 检查所有 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......

然后提供修复缺失项的功能。

相关技能