关于 seo-content-brief
seo-content-brief 面向 SEO 研究人员和内容写作者,可根据关键词或现有页面生成研究型内容简报。它结合竞争差距分析、网站相关性检查、页面模板和具体编辑建议。
主要功能
- 01为新页面或现有页面制作简报
- 02分析排名结果与竞争差距
- 03提供搜索意图和页面类型建议
- 04制定关键词布局与元标签规则
- 05建议内链与信任信号
适用场景
- 01围绕目标关键词规划新页面
- 02针对性改进现有页面而非全面重写
- 03按搜索意图制作内容大纲
- 04找出可信的内链目标与内容缺口
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ agricidaniel/ claude-seo --skill seo-content-brief安装后在 Claude Code 中输入/seo-content-brief确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtreferences/excluded-domains.mdkeyword-density.mdpage-type-templates.md详细介绍
SEO 内容简报生成器
生成有研究依据的内容简报,帮助作者创作出有望超越当前排名靠前页面的内容。简报包括竞争对手分析及差距评分、各章节的字数分配、关键词布局规则,以及针对不同页面类型的模板。
流程
1. 确定简报模式
改进模式(提供了现有页面 URL):
- 获取现有页面的内容和结构
- 找出已有的优势内容(予以保留)
- 找出缺失、内容单薄或过时的章节
- 在大纲中区分“保留/强化”和“新增”章节
- 如果有针对性的改进就能取得更好的效果,不要建议彻底重写
新页面模式(提供了关键词或主题,且没有现有页面):
- 仅使用目标网站的首页或站点地图了解业务背景
- 从零开始为新页面编写简报
- 聚焦新页面可以填补的竞争差距
2. 获取背景信息
- 获取目标 URL 或首页,了解业务情况
- 获取站点地图,查找所有现有页面、类别和服务
- 这些背景信息对于遵循网站相关性规则(见下文)至关重要
3. 分析搜索结果页
- 找出目标关键词排名靠前的 5 个页面
- 排除非竞争对手(Wikipedia、Reddit、Pinterest、Amazon、YouTube、政府网站、SEO 工具页面、招聘网站、目录网站、新闻聚合网站、社交平台)。完整列表请参阅
references/excluded-domains.md。 - 为每个真正的竞争对手评分:内容深度(1-10)、格式(1-10)、SEO(1-10)、用户体验(1-10)
- 找出三类差距:
- **主题差距:**竞争对手完全没有涉及的子主题
- **深度差距:**有所涉及但内容浅显的主题
- **质量差距:**信息过时、缺乏专家视角或格式不佳
- 计算差距优先级:
影响 x 竞争优势 / 所需投入
4. 判断搜索意图
- **信息型:**用户想要了解信息(指南、操作方法、定义)
- **商业型:**用户正在购买前做研究(对比、评测、“最佳 X”)
- **交易型:**用户准备采取行动(购买、预订、咨询、注册)
- **导航型:**用户正在查找特定网站或页面
判断 Google 会针对该查询优先展示哪种搜索结果格式:长篇指南、列表文章、对比表、落地页、常见问题、视频或本地商家列表。
5. 编写简报
应用 references/page-type-templates.md 中的页面类型模板,然后根据竞争差距和搜索意图进行定制。
重要规则
网站相关性规则
你建议的每个标题、子主题、关键词和常见问题,都必须与目标网站实际提供的服务或产品相符,且网站有能力围绕这些内容进行可信的创作。
- 阅读网站首页和站点地图,了解网站提供的内容
- 如果竞争对手的某些章节涉及该网站不提供的内容,不要照搬其结构
- 提出每项建议前,先问:“这个网站是否真的能兑现这项内容所作的承诺?”如果不能,就删除该建议。
网站结构覆盖规则
为中心页、概览页、类别页或“类型”页面编写简报时:
- 大纲必须涵盖网站上所有相关的产品类别、服务或子页面
- 不要虚构不存在的类别,也不要遗漏现有类别
- 每个类别都应作为独立章节出现,并附上内部链接建议
- 这样可以确保该页面成为恰当的中心页,链接到所有子页面
对于非中心页(单项服务页面、博客文章),可根据网站结构推荐相关的内部链接,但不要强行将所有类别都纳入大纲。
输出语言规则
- 输出中绝不要提及研究人员姓名、框架名称或工具名称(例如“Ben Goodey 方法”“Frase.io 公式”“Princeton GEO”“Clearscope”“Backlinko”)
- 这些仅供内部思考时使用。输出应采用平实、专业的建议表述。
- 面向企业主或内容作者撰写,而不是面向 SEO 学术人士
关键词密度与布局
完整规则请参阅 references/keyword-density.md。摘要:
主要关键词的使用: 在高价值位置自然地使用主要关键词。
- 不要为了达到固定密度而优化。密度检查仅作为可选的内部可读性/关键词堆砌启发式规则。
- 前 1-2 次提及有助于确立主题背景;之后效果递减。
- 对于 1,000 字的文章,避免在标题、正文和替代文本中强行重复。
主要关键词必须出现在:
- 标题标签中(尽量靠前)
- H1 标签中(尽量靠前)
- URL 路径中
- Meta 描述中
- 第一段/前 100 个词中
- 至少一处图片替代文本中
主要关键词不必出现在:
- 每个 H2 或 H3 中(如果 H1 涵盖了主题,子主题本身就能自然承载相关背景)
- 每个段落或章节中
次要关键词:
- 在正文中分布 5-8 个密切相关的辅助词
- 覆盖相关概念的 10-15 个更广泛的语义词
- 自然地用于 H2-H6 小标题中
- 同义词可提升可读性,且不计入关键词密度
各章节的关键词指南: 对大纲中的每个章节,说明:
- 标题中应使用哪个关键词(主要或次要)
- 正文是否应包含主要关键词或其变体
- 示例:“在 H2 中使用次要关键词‘structural drafting services’。正文:提及一次主要关键词。”
分布: 均匀分布主要关键词。不要在开头过度集中,也不要让它们聚集在某一个章节中。
Meta 标签规则
标题标签:
- 50-60 个字符(不得少于 50 个,也不得超过 60 个)
- 主要关键词置于开头,品牌名称置于结尾
- 用竖线或短横线分隔品牌(与网站现有格式一致)
- 尽可能以成果、数字或具体信息开头
Meta 描述:
- 130-150 个字符(不得少于 130 个,也不得超过 150 个)
- 使用主动语态,通过独特卖点和具体信息扩展标题内容
- 以行动号召结尾
- 结尾处不写品牌名称(标题中已有)
- 不要使用引号(Google 会在引号处截断)
信息增益(不可妥协)
每份内容简报都必须明确说明内容提供了哪些当前排名页面均未提供的新价值。必须具体说明:
- 专有数据或原创研究
- 具有真实成果的案例研究
- 专家引语或第一手经验
- 原创综合分析或独特框架
- 不能只写“更多细节”或“更好的格式”
E-E-A-T 要求
列出内容所需的确切信任信号:
- 与主题相关的作者资历和简介
- 专家引语或权威来源的引用
- 注明日期的研究、数据或统计信息
- 最近更新日期
- 对 YMYL 主题(健康、金融、法律、安全)尤为重要
内部链接
- 提出 3-5 个具体的内部链接机会,并提供锚文本
- 说明页面属于中心页(链接到主题集群页面)还是分支页(链接到支柱页面)
- 使用站点地图中的网站结构查找真实的链接目标
输出格式
始终使用以下确切结构输出:
## Content Brief: [Primary Keyword]
### Search Intent
[Intent type, SERP format rewarded, target audience and knowledge level. 3-4 lines.]
### Competitor Analysis
| # | URL | Key H2 Sections | Est. Words | Score | Main Gap |
|---|-----|-----------------|------------|-------|----------|
| 1 | ... | ... | ... | X/40 | ... |
### Content Gaps and Opportunities
[Bullet list: topic gaps, depth gaps, quality gaps with specifics]
### Winning Outline
**H1:** [H1 with primary keyword]
**URL Slug:** /[slug]
**Target Word Count:** ~[X] words (competitor avg: ~[X] words)
[Full H2/H3 outline with:
- Word count per section
- Content format notes (bullet list, table, definition box, etc.)
- Featured Snippet targets marked with "FS target"
- Per-section keyword guidance]
### Recommended Meta Tags
**Title**
[title, 60 chars max]
**Meta Description**
[description, 150 chars max]
### Unique Angle and Information Gain
[Specific paragraph: what exact new value this piece adds]
### E-E-A-T Requirements
[Bullet list of exact trust signals needed]
### Internal Linking Opportunities
[3-5 suggestions with anchor text and target URL]
仅输出大纲模式
当用户要求“仅提供大纲”或“内容大纲”,而不是完整简报时,跳过竞争对手分析表、内容差距、信息增益和 E-E-A-T 部分。仅输出:
## Content Outline: [Primary Keyword]
**H1:** [H1 with primary keyword]
**URL Slug:** /[slug]
**Target Word Count:** ~[X] words (competitor avg: ~[X] words)
[Full H2/H3 outline with word counts, format notes, FS targets, keyword guidance, and a 1-2 sentence writing note per section]
DataForSEO 集成(可选)
如果有 DataForSEO MCP 工具可用,请使用 serp_organic_live_advanced 获取真实 SERP 数据并分析竞争对手,使用 kw_data_google_ads_search_volume 获取关键词搜索量,使用 dataforseo_labs_bulk_keyword_difficulty 获取难度评分,使用 dataforseo_labs_search_intent 判断搜索意图,并使用 on_page_content_parsing 提取竞争对手内容。
Ahrefs 集成(可选)
如果有 Ahrefs MCP 工具可用,请使用 keywords-explorer-overview 获取关键词搜索量和难度,使用 serp-overview 分析 SERP,使用 site-explorer-organic-keywords 查看现有关键词排名,并使用 site-explorer-top-pages 了解竞争对手页面表现。
错误处理
| 场景 | 操作 |
|---|---|
| 目标 URL 无法访问 | 报告错误。不要猜测页面内容。请用户核实 URL。 |
| 筛选后未找到竞争对手 | 扩大搜索范围,将部分匹配的竞争对手也纳入其中。在简报中注明竞争格局较为有限。 |
| 未找到站点地图 | 在缺少网站结构背景的情况下继续。注明内部链接建议可能不完整。 |
| 未指定页面类型 | 根据关键词意图和 SERP 格式自动检测。在简报中说明检测到的类型。 |
| 未指定目标字数 | 以竞争对手的平均字数为基准。在大纲中注明这一点。 |