knowledge-work-plugins 中的 /seo-audit 技能实战:关键词研究、内容缺口与技术 SEO 全面审计指南
2026/9/13 16:20:29 网站建设 项目流程

knowledge-work-plugins 中的 /seo-audit 技能实战:关键词研究、内容缺口与技术 SEO 全面审计指南

【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins

/seo-audit是 knowledge-work-plugins 仓库 marketing 插件中内置的一项 SEO 审计技能,面向 Claude Cowork / Claude Code 等 Agent 环境,用于对一个网站开展端到端的 SEO 健康度评估——涵盖关键词研究、站内优化、内容缺口、技术检查与竞争对手对比五个环节,并最终产出一份营销人员可立即执行的优先级行动清单。读完本文,你将掌握该技能完整的输入约定、五步审计流程、七类标准输出交付物,以及如何借助仓库内的连接器配置(Ahrefs、Similarweb、Amplitude 等 MCP 服务器)与相邻营销技能,把一次 SEO 审计从"人工整理"升级为"可复现、可执行的 Agent 工作流"。

技能概览与定位

/seo-audit定义在 marketing/skills/seo-audit/SKILL.md,属于 marketing 插件中的一项 slash command 型技能。在 marketing/README.md 的命令清单中,它的描述为:"Run a comprehensive SEO audit — keyword research, on-page analysis, content gaps, technical checks, and competitor comparison",即覆盖关键词研究、站内分析、内容缺口、技术检查与竞争对手对比五个维度的全面审计。

该技能文件的 YAML frontmatter 包含三个关键字段:

字段含义
nameseo-audit技能标识符(小写、连字符,与目录名一致)
description一段以第三人称书写的长描述描述"何时使用"并内嵌触发短语,供 Agent 自动匹配
argument-hint"<url or topic> [audit type]"声明期望参数格式,用于输入提示与自动补全

按照仓库中 create-cowork-plugin 的组件规范,description字段采用第三人称触发式写法,正文采用命令式(imperative)语气,且 SKILL.md 正文长度建议控制在 1500–2000 词以内、深层细节放入references/目录。本技能正是这一规范的典型实践:单文件即可承载完整的审计方法论,无需额外的 references 与 scripts 目录。

安装方式

在 marketing/README.md 中给出了该插件的安装命令:

claude plugins add knowledge-work-plugins/marketing

安装后,/seo-audit即作为 slash command 在会话中可用。根据仓库根目录 README.md 对插件机制的说明,skills 属于"Claude 在相关内容触发时自动调用的领域知识",commands 则是"用户显式触发的动作";Cowork 的 UI 已把命令与技能统一呈现为单一"Skills"概念。因此当用户输入/seo-audit或提出"做一次 SEO 审计""帮我做关键词研究""分析内容缺口"等诉求时,该技能便会激活并按下面的流程执行。

触发条件(Trigger)

当用户出现以下任一行为时,技能即被触发:

  • 直接运行/seo-audit命令;
  • 请求做一次 SEO 审计(SEO audit);
  • 请求进行关键词研究(keyword research);
  • 请求进行内容缺口分析(content gap analysis);
  • 请求进行技术 SEO 检查(technical SEO check);
  • 请求进行竞争对手 SEO 对比(competitor SEO comparison)。

由于 frontmatter 的description覆盖了上述全部触发短语,Agent 可以在对话中自动识别用户意图,无需用户记住确切的命令格式。

输入约定(Inputs)

技能要求在执行前收集四类输入,缺少必要信息时应先向用户询问再继续:

  1. URL 或域名——待审计的站点;若处于关键词研究模式,也可提供主题或关键词。

  2. 审计类型(Audit type)——五选一:

    • Full site audit(全站审计)——端到端 SEO 审查,覆盖下文全部环节;
    • Keyword research(关键词研究)——为主题或域名识别关键词机会;
    • Content gap analysis(内容缺口分析)——找出竞争对手有排名而你没有的主题;
    • Technical SEO check(技术 SEO 检查)——检查可抓取性、速度、结构化数据与基础设施问题;
    • Competitor SEO comparison(竞争对手 SEO 对比)——针对指定竞争对手进行头对头 SEO 基准对比。

    若用户未指定,默认执行全站审计

  3. 目标关键词或主题(可选)——用户已经瞄准或希望排名的具体关键词。

  4. 竞争对手(可选)——用于对比的域名或公司。若未提供但审计类型需要竞争对手数据,Agent 应根据用户的域名与关键词空间,通过网络搜索识别 2–3 个可能的竞争对手。

值得注意argument-hint"<url or topic> [audit type]"的格式约定:URL(或主题)是必填的第一个参数,审计类型是可选参数,这与上述输入约定一一对应。

五步审计流程(Process)

技能将审计过程划分为五个环节,从"发现关键词机会"到"与对手横向对比",形成完整的证据链。

1. 关键词研究(Keyword Research)

围绕用户的域名、主题或目标关键词展开研究,并根据当前连接的工具有三种数据路径:

  • 若已连接 SEO 工具(~~SEO:自动拉取关键词数据、搜索量、关键词难度分数与排名位置;识别站点当前排名的关键词,以及哪些关键词正在上升或下滑。
  • 若已连接产品分析工具(~~product analytics:将关键词目标与真实自然流量数据交叉比对,验证哪些关键词真正驱动了访问与转化。
  • 若未连接任何工具:使用网络搜索研究关键词格局,并提示用户:"如需更精确的搜索量与难度数据,可通过 MCP 连接 Ahrefs 或 Semrush 等 SEO 工具,审计将自动填充排名数据。"

对每一个关键词机会,需要评估七个维度:

  • Primary keywords(主关键词)——与用户产品或服务直接相关的高意图词;
  • Secondary keywords(次关键词)——支撑性词与变体;
  • Search volume signals(搜索量信号)——基于可得数据的相对需求(高/中/低);
  • Keyword difficulty(关键词难度)——该词的竞争程度(容易/中等/困难);
  • Long-tail opportunities(长尾机会)——意图明确、竞争度低的特定短语;
  • Question-based keywords(问句式关键词)——"how to""what is""why does"等与 People Also Ask(人们还搜了)结果对应的查询;
  • Intent classification(意图分类)——信息型(informational)、导航型(navigational)、商业型(commercial)或交易型(transactional)。

这一环节体现了技能对数据源的分层策略:优先利用 MCP 连接的 SEO 工具获取量化数据,其次用产品分析验证转化价值,最后以网络搜索兜底,始终保证"有数据可依"而非凭空估计。

2. 站内 SEO 审计(On-Page SEO Audit)

对每个关键页面(首页、核心落地页、近期博客文章),逐项评估八个要素:

  • Title tags(标题标签)——存在、唯一、长度在 50–60 字符内、包含目标关键词;
  • Meta descriptions(元描述)——存在、有吸引力、长度在 150–160 字符内、包含行动号召(CTA);
  • H1 标签——每页恰好一个,包含主关键词;
  • H2/H3 结构——逻辑层次清晰,自然融入次关键词;
  • Keyword usage(关键词使用)——主关键词出现在前 100 词内、全文自然分布、不堆砌;
  • Internal linking(内部链接)——页面链接到相关内容,识别孤立页(orphan pages),锚文本描述性明确;
  • Image alt text(图片替代文本)——所有图片具有描述性 alt 属性,相关处融入关键词;
  • URL structure(URL 结构)——干净、可读、包含关键词,无过多参数或过深层级。

这套站内检查标准与仓库中 content-creation 技能 的 "On-Page SEO Checklist" 高度一致(如 title 60 字符、meta 160 字符、H1 每页一个、URL slug 包含主关键词),说明两个技能共享同一套 SEO 最佳实践基线:审计发现问题后,可直接用content-creation生成符合规范的改写稿。

3. 内容缺口分析(Content Gap Analysis)

识别用户内容策略中缺失的部分,六个检查方向:

  • Competitor topic coverage(竞争对手主题覆盖)——对手有排名而你的站点未覆盖的主题与关键词;
  • Content freshness(内容新鲜度)——超过 12 个月未更新的页面,可能正在流失排名;
  • Thin content(薄内容)——深度不足以参与排名的页面(信息型查询少于 300 词、缺乏实质内容);
  • Missing content types(缺失的内容类型)——对手使用而你未使用的格式(指南、对比页、术语表、工具、模板);
  • Funnel gaps(漏斗缺口)——在特定买家旅程阶段(认知 awareness、考虑 consideration、决策 decision)缺失的内容;
  • Topic clusters(主题集群)——构建支柱页(pillar page)并配套支撑内容的主题集群机会。

缺口分析的产出不仅是一份"缺少什么"的清单,还直接衔接了输出阶段的内容缺口建议表与优先行动计划,形成"发现→建议→执行"的闭环。

4. 技术 SEO 检查清单(Technical SEO Checklist)

评估影响可抓取性与排名的技术基础,八个检查项:

  • Page speed(页面速度)——识别加载缓慢的页面及可能原因(大图、阻塞渲染的脚本、过多的重定向);
  • Mobile-friendliness(移动端友好度)——响应式设计、点击目标、字号、viewport 配置;
  • Structured data(结构化数据)——schema 标记机会(FAQ、HowTo、Product、Article、Organization、Breadcrumb);
  • Crawlability(可抓取性)——robots.txt 配置、XML sitemap 的存在与准确性、canonical 标签、noindex/nofollow 的使用;
  • Broken links(死链)——内外部 404、重定向链;
  • HTTPS——安全连接、混合内容(mixed content)问题;
  • Core Web Vitals signals(核心网页指标)——基于可观察页面行为的 LCP、FID/INP、CLS 指标;
  • Indexation(收录)——本应被收录却可能未被收录的页面、重复内容风险。

注意技能对性能类指标的态度是"基于可观察的页面行为进行指标判断"(indicators based on observable page behavior),而非声称直接读取 CrUX API 数据——这是一种对 Agent 能力边界保持诚实的写法,避免编造精确数值。

5. 竞争对手 SEO 对比(Competitor SEO Comparison)

对每个竞争对手,从七个维度进行头对头比较:

  • Keyword overlap(关键词重叠)——双方都有排名的关键词,以及各自排名更高的部分;
  • Keyword gaps(关键词缺口)——对手有排名而你没有的词;
  • Domain authority signals(域名权威信号)——基于外链画像、引用域名与内容深度的相对站点强度;
  • Content depth(内容深度)——平均内容长度、主题覆盖广度、发布频率;
  • Backlink profile observations(外链画像观察)——链接到对手的站点类型、他们产出的值得链接的内容;
  • SERP feature ownership(SERP 特性占有)——哪些对手出现在精选摘要、People Also Ask、图片包或知识面板中;
  • Technical advantages(技术优势)——站点速度差异、移动端体验、结构化数据使用情况。

本环节可与仓库中 competitive-brief 技能 的方法论互补:后者提供消息对比矩阵、内容审计对比表(Topic/Theme × 各竞争对手 × Gap)、内容类型覆盖矩阵等框架,可用于把 SEO 层面的关键词缺口扩展为完整的竞争情报简报(battlecard)。

标准输出交付物(Output)

技能规定审计完成后必须输出七类结构化的交付物,确保结论可执行、可引用。

Executive Summary(执行摘要)

以 3–5 句话开篇总结整体 SEO 健康度,突出:

  • 站点最大的优势;
  • 影响最大的 3 个优先事项;
  • 整体评估结论:基础扎实(strong foundation)、需要改进(needs work)、或存在关键问题(critical issues)。

Keyword Opportunity Table(关键词机会表)

按机会分数排序,输出 15–25 个关键词机会:

KeywordEst. DifficultyOpportunity ScoreCurrent RankingIntentRecommended Content Type
(关键词)(易/中/难)高/中/低(当前排名)(意图类型)(推荐内容类型)

机会分数(Opportunity score)为高/中/低三档,由搜索需求、难度与用户业务相关性的组合共同决定。

On-Page Issues Table(站内问题表)

PageIssueSeverityRecommended Fix
(页面)(问题描述)(严重级别)(推荐修复方案)

严重级别定义如下:

  • Critical(致命)——直接损害排名或阻止收录;
  • High(高)——对 SEO 表现有显著影响;
  • Medium(中)——违反最佳实践,影响中等;
  • Low(低)——轻微优化机会。

Content Gap Recommendations(内容缺口建议)

对每个识别出的缺口提供五项信息:

  • 目标主题或关键词
  • 为何重要(Why it matters)——搜索需求、对手覆盖情况、所处漏斗阶段;
  • 推荐格式——博客文章、落地页、指南、对比页等;
  • 优先级——高/中/低;
  • 预估工作量——快速见效(1–2 小时)、中等(半天)、重大(多天)。

Technical SEO Checklist(技术 SEO 检查表)

CheckStatusDetails
(检查项)Pass / Fail / Warning(详情)

状态取值固定为三种:通过(Pass)、失败(Fail)、或警告(Warning)。

Competitor Comparison Summary(竞争对手对比汇总)

DimensionYour SiteCompetitor ACompetitor BWinner

行维度固定包含:关键词数量(keyword count)、内容深度(content depth)、发布频率(publishing frequency)、外链信号(backlink signals)、技术得分(technical score)、SERP 特性出现情况(SERP feature presence)。

Prioritized Action Plan(优先级行动计划)

将建议拆分为两类:

Quick Wins(本周内完成的快速见效项):

  • 耗时 2 小时以内且立竿见影的动作;
  • 示例:修复标题标签、补充元描述、修复死链、添加 alt 文本。

Strategic Investments(本季度规划的战略投资项):

  • 需要更多投入但驱动长期增长的动作;
  • 示例:构建主题集群、创建支柱页、发起外链建设活动、重构站点结构。

每个行动项都必须附带四项信息:

  • 做什么(What to do)——具体且可落地;
  • 预期影响(Expected impact)——高/中/低;
  • 工作量估算(Effort estimate)
  • 依赖项(Dependencies)——如有。

这种"快赢 + 战略投入"的二分法是该技能的实用精髓:既照顾营销团队当周就能动手的事项,也为季度规划保留了长期抓手,确保审计报告不会被束之高阁。

收尾追问(Follow-Up)

呈现审计结果后,技能规定应向用户询问后续动作:

"Would you like me to:

  • Draft content briefs for the top keyword opportunities?
  • Create optimized title tags and meta descriptions for your key pages?
  • Build a content calendar based on the gap analysis?
  • Dive deeper into any specific section of the audit?
  • Run this same analysis for a different competitor or domain?"

(你是否希望我:为排名靠前的关键词机会起草内容简报?为你的关键页面生成优化后的标题标签与元描述?基于缺口分析构建内容日历?深入审计的某个具体环节?针对不同竞争对手或域名再跑一次同样的分析?)

这一设计把单次审计扩展为可持续的服务链——审计产出天然衔接内容创作(content-creation)、内容日历规划(campaign-plan)与竞品简报(competitive-brief)等相邻技能,形成营销工作流的闭环。

与连接器(Connectors)的协同机制

技能正文中反复出现的~~SEO~~product analytics等占位符,是仓库插件体系的"工具类别占位"约定。根据 marketing/CONNECTORS.md 的说明:

Plugin files use~~categoryas a placeholder for whatever tool the user connects in that category.

插件是工具无关(tool-agnostic)的——工作流按类别(SEO、产品分析、营销自动化等)描述,而不是绑定特定产品;.mcp.json只是预配置了具体 MCP 服务器,同类别的任意 MCP 服务器都可用。

marketing 插件中与本技能直接相关的连接器类别如下:

类别占位符内置服务器其他可选
SEO~~SEOAhrefs、SimilarwebSemrush、Moz
Product analytics~~product analyticsAmplitudeMixpanel、Google Analytics

这解释了技能正文的分支逻辑:当用户在 Cowork 中接入了 Ahrefs 或 Similarweb 的 MCP 服务器,~~SEO就会被替换为具体工具,关键词研究环节便能自动填充搜索量、难度与排名数据;接入 Amplitude 后,~~product analytics分支会用真实自然流量数据校验关键词的价值。若未接入任何工具,技能则回退到网络搜索模式并给出明确的连接建议。完整配置方式可参见 marketing/CONNECTORS.md。

小结:从审计报告到可执行的增长引擎

总结而言,/seo-audit技能的价值不在于"生成一份报告",而在于其严格的结构化约定:五步审计流程保证了评估维度的完整性(关键词机会、站内要素、内容缺口、技术地基、对手对比);七类输出交付物(执行摘要、机会表、问题表、缺口建议、技术检查表、对手对比表、优先级行动计划)把发现转化为可执行的决策依据;快赢/战略投入二分法则让营销团队拿到报告后即可行动。配合 marketing/README.md 的安装命令、marketing/CONNECTORS.md 的 MCP 连接器配置,以及同仓库中 content-creation、competitive-brief 等相邻技能,一次 SEO 审计即可无缝延伸为内容创作、竞品情报与增长规划的完整工作流——这也是 knowledge-work-plugins 所倡导的"让 Claude 按你的方式完成专业工作"理念在 SEO 场景下的具体落地。

【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询