关于 content-brief
content-brief 是为内容作者和 SEO 团队生成文章简报的技能,从一个目标关键词出发组织受众、角度、搜索结果分析和写作指导。它区分 Semrush 数据、人工观察与模型判断,不代写文章。
主要功能
- 01围绕单一目标关键词组织简报
- 02纳入受众、目标与内容角度
- 03分析搜索结果及排名页面
- 04提出标题、元描述和文章大纲
- 05规划范围、链接与风格指导
- 06标注数据来源并处理缺失证据
适用场景
- 01为目标关键词准备文章写作简报
- 02比较搜索结果中的页面类型与角度
- 03结合受众和业务目标确定文章方向
- 04在 Semrush MCP 不可用时采用替代证据
MCP 相关
Semrush MCP 可用于关键词、自然搜索结果及 URL 或域名研究。技能通过发现报告、获取报告结构并执行查询来收集数据,同时说明 API 单位消耗,并将手动观察和模型推断与 Semrush 数据分开。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ semrush/ skills --skill content-brief安装后在 Claude Code 中输入/content-brief确认已加载。
详细介绍
内容简报
此技能将一个目标关键词转化为一份内容简报,供作者据此撰写可直接发布的文章。它对简报应包含什么、不应包含什么有明确主张。好的简报会设定范围、明确角度,然后不再干涉。
简报不应替你写文章。规定过细的简报读起来像合规检查清单,产出的内容也会像合规检查清单一样获得排名。它的任务是提供足够的背景,让作者能够做出真正的判断,而不是提供过多细节,以至于作者无从决策。
开始之前
请一次性询问以下信息。
- 目标关键词。 每份简报只选一个主要关键词。如果用户提供了一组关键词,请与用户共同选择,或根据相关性、商业价值、搜索意图契合度、可实现性和 SERP 证据确定优先级。不要默认选择搜索量最高的词。
- 域名。 可选,但有助于发现相关的现有页面、排名和内部链接目标。不要声称经过测试的公共 MCP 能针对用户提供的域名返回个性化关键词难度。
- Semrush MCP 是否已连接。 连接后即可获取 Semrush 关键词和自然搜索报告,用于实时 SERP 数据。如果未连接,你仍然可以撰写简报,但应将 SERP 分析标注为人工分析或方向性分析。Semrush MCP 通过 Semrush 自有的授权流程连接,因此无需粘贴 API 密钥。
- 目标受众。 不明确受众的简报会写出不知对谁而言的内容。请一次性询问用户是否有成文的 ICP、内容指南或受众说明。如果没有,请他们用两句话描述读者是谁。
- 目标。 为获取流量而排名、支持现有营销活动、构建主题中心,或更新表现不佳的页面。目标会影响简报内容。
如何使用 Semrush MCP
仅使用 Semrush MCP。
可调用的 MCP 工具名称是研究入口和架构执行工具。Keyword Overview 和 Keyword Magic Tool 等报告/产品名称需通过架构流程选择,不能直接作为工具调用。
- 对于可用的通用关键词指标,例如搜索量、通用 KD、意图和 CPC,使用
keyword_research→phrase_this。经测试的架构不包含域名输入、PKD 字段或 SERP 功能字段。 - 使用
keyword_research→phrase_related和phrase_questions获取相关关键词和疑问形式关键词。这些报告提供关键词行,不提供 Keyword Magic Tool 分组、自动聚类或大纲。 - 使用
keyword_research→phrase_organic,并设置positions_type: organic,获取排名 URL。仅在确实需要功能位置行时使用positions_type: all,并将这些行与自然排名分开。保留每一行原始数据,但在页面审查和格式计数时对相同 URL 去重,同时记录返回的每个排名位置。不要将字数、页面流量、页面级引用域名或 Authority Score 归因于此报告。
谨慎解读报告输出:
- 按原样保留数字意图代码和 SERP 功能代码。只有当前已发现的架构或官方文档提供映射时,才将代码映射为易读标签。否则,将原始代码标为未解析,并将任何人工意图或功能分类单独标记为模型推断或观察结果。
- 在将相关词和疑问词用于简报前,先检查其中的重复项、明确的搜索运算符、编码错误、明显拼写错误和无关词项。保留原始行,说明筛选规则和排除数量,且绝不要将已移除行的指标赋予更正后的拼写。
- Semrush 报告存在不一致时,保留两个值及其报告名称、数据库、目标对象和可用的日期或快照信息。不要暗中合并,也不要选择更有利的数值。说明决策采用哪个值(如有)及其原因;否则将该指标标记为不一致。
规范工作流保持不变:通过 Semrush MCP keyword_research 或 organic_research 发现数据 → 为特定报告调用 get_report_schema → 使用相应参数调用 execute_report。
如果提供了结构化 SERP Analysis 成品,请使用其中的关键词上下文、意图、功能映射、排名 URL、证据可用性、格式分布、差距和置信度,而不要重复运行相同的研究。否则,使用上述报告构建这些证据,并仅在需要时获取额外的域名或 URL 证据。将人工检查、格式分类、差距检测、聚类和大纲决策标记为分析师/模型判断,而非 Semrush 返回字段。
MCP 访问与成本防护
- 首次调用
execute_report前,告知用户 Semrush MCP 查询会消耗 API 单位。只请求所需字段,使用足以回答问题的最小结果数量,并在查看首批结果后再决定是否扩展。默认情况下绝不要请求所有行。 - 如果身份验证未完成、所需工具、报告、架构或字段不可用,或执行因访问权限或单位不足而失败,请停止该 MCP 分支。说明哪些内容不可用以及简报中的哪些部分会受影响,然后使用下方最强的备用方案。绝不要编造或暗中替代缺失的 Semrush 指标。
备用方案优先级
使用当前可用的最强数据源,并说明使用了哪一种。
- Semrush MCP 关键词、SERP 以及 URL/域名报告。
- 用户提供的 Semrush UI 导出数据。
- 对目标国家/地区进行人工 SERP 检查。
- 用户提供的竞争对手 URL 和一手受众说明。将缺失指标标记为未知,而非猜测。
证据约定
将来源溯源与置信度分开。对重要输入和建议使用以下标签:
- Semrush 数据: 由具名 MCP 报告返回的数值。注明报告名称。
- Semrush 支持的指导: 有 Semrush 链接来源支持的编辑建议。不要将其描述为搜索引擎要求。
- 用户提供: 第一方目标、受众认知、转化证据、约束或已批准的来源。
- 人工观察: 直接检查得出的 SERP 或页面特征,并非 MCP 返回的信息。
- 模型推断: 基于现有证据得出的建议,例如格式、角度、分组或大纲结构。
- 可配置默认值: 为方便使用而选择的起始范围,并非普适的 SEO 规则。
在面向用户的简报中,当来源会影响某项主张的可信度时,注明其来源。将标签精简地放在证据或理由说明中,不要给每句话都加标签。另行评估置信度,分为高、中或低;如果缺少的证据会降低置信度,请说明缺少了什么。
简报结构
工作简报包含以下八个部分。其他内容均为可选。
- 目标关键词与意图
- 受众与角度
- SERP 背景(前 10 名分析)
- 标题与元描述
- 大纲(H1、H2、H3)
- 范围指导
- 链接计划(内部与外部)
- 风格与语气说明
按顺序完成。每个部分都为下一部分提供依据。
1. 目标关键词与意图
记录主要关键词以及可用的 phrase_this 指标,例如搜索量、通用 KD、CPC 和原始意图值。将不可用字段标记为未知,并注明每个数值对应的 Semrush 报告。不要将 SERP 特征归因于 phrase_this。简报开篇应先列出关键词,让撰稿人在阅读其他内容前就了解拟定的搜索目标。
只有在返回代码的映射已核实,或实时 SERP 证据支持单独的模型判断时,才将意图归类为信息型、导航型、商业型或交易型。注明采用了哪种判断路径。撰稿人应制作的内容形式会因意图而异。
- 信息型意图通常适合指南或文章,但应根据实时 SERP 确认内容形式。
- 商业型意图通常适合比较、替代方案、评测或价格相关内容。
- 交易型意图通常指向产品页、分类页、服务页或价格页。应推荐合适的页面类型,而不是自动终止工作流。
- 导航型意图通常指向产品页或品牌页。意图可能混合或分散,因此应先根据观察到的 SERP 分布再作决定。
仅添加同一页面能够满足、且不会混淆不同意图的次要关键词。根据 Semrush 数据行,并结合透明的意图和 SERP 重合度分析来选择;不要承诺页面能够针对所有纳入的词条获得排名。
2. 受众与角度
只写两个简短段落,不要更多。
受众段落应说明读者是谁、他们对主题已有多少了解,以及他们希望从文章中获得什么。“B2B SaaS 公司的资深 SEO,已经读过三篇相关指南,想了解其他文章都没提到的内容”很有用。“营销人员”则不够具体。
角度段落应点明页面的吸引点。这篇文章能提供前 10 名页面没有的什么内容?如果无法用一句话回答,简报就还没准备好。对主题泛泛而谈,无法胜过已有的前 10 名页面,因为它们已经涵盖了该主题。
可采用的角度:
- 第一方数据点(调查、实验或撰稿人可以引用的工具结果)。
- 反常规解读(常见建议在这里并不适用,而且我们可以证明这一点)。
- 更具体的范围(前 10 名内容都很宽泛,而我们的内容面向特定行业或用例)。
- 更实用的形式(前 10 名内容长篇大论,而我们的内容提供工具、计算器、模板或清单)。
3. SERP 上下文
通过 Semrush MCP 或直接查看 SERP,获取主要关键词的前 10 个自然搜索结果。
针对一组有代表性的排名结果,记录:
- URL
- 页面类型(指南、榜单、对比、计算器、产品页)
- 仅在可直接测量时记录字数;将其标注为描述性竞品证据,而非目标或排名因素
- 值得注意的角度或差异化特点
- 该页面是否属于其网站上的某个主题内容中心
还要记录可通过已映射的 phrase_organic 代码或直接查看 SERP 验证的 SERP 功能:精选摘要、「用户也在问」问题框、视频轮播、购物结果和 AI Overview。切勿根据未映射的数字代码猜测功能名称。使用已验证的功能来识别适用的内容形式和搜索者可能的需求。不要假定答案有固定长度,也不要声称 AI Overview 总会减少点击;仅描述观察到的证据所支持的内容。
请标记出可供作者参考的常见模式。
- 如果某种内容形式占主导地位,请说明这一模式的显著程度,以及其他形式是否能更好地满足相同意图。
- 如果排名页面展现出一致的深度或范围,可将其作为描述性背景,同时明确读者需要哪些内容。不要把竞品字数转化为排名要求。
- 如果某个网站占据了多个搜索结果,请将这一集中现象记录为观察结果。不要仅凭这一点就认定该网站主导了这个主题。
4. 标题和元描述
提供两个标题候选和一条元描述。
标题:
- Semrush 支持的建议: 建议控制在 550 像素以内,通常为 50 至 60 个字符,以降低标题被截断或改写的风险。搜索引擎和 AI 系统不会强制执行上限,因此请使用预览,而不要将此范围视为硬性错误标准。
- 标题应清楚、简洁,并与页面的实际主题和意图相符。
- 在能准确传达主题的前提下,自然地使用一次主要关键词。不要堆砌相关变体。
- 仅当页面确实提供相应内容时,才加入受众、范围、证据或形式等价值信号。
- 提出不同且有依据的角度,供用户选择。标题和 H1 应足够相似,能传达相同的页面主题,但不必完全一致。
元描述:
- Semrush 支持的建议: 建议不超过 135 个字符,以降低在不同设备上被截断的风险。将其视为编辑目标,而非排名因素或硬性校验标准。
- 准确概述页面内容,并给搜索者一个有用的访问理由。
- 如果有助于提升相关性和清晰度,可自然地加入主要关键词或其近义词。
- 回应观察到的搜索意图,并在简洁的答案有帮助时考虑回答核心问题。
- 预览搜索结果,因为设备宽度、字符宽度、查询词加粗和搜索引擎改写都会影响显示的摘要。
不要为了制造点击而故意扣留有用的答案。标题和描述必须准确体现页面实际提供的内容,不得误导或采用标题党式表述。
5. 大纲
大纲是内容简报的主干。把这部分做好,作者就能完成后续工作。
根据三个来源构建大纲。
- SERP 分析。找出反复出现的主题和有意义的缺口,再根据受众和意图决定哪些内容适合纳入本页面。不要自动照搬竞争对手的标题。
- People Also Ask。将相关问题作为研究输入;只有在有助于实现页面目的时才纳入,不要自动把它们用作 H2 或 FAQ 条目。
- Semrush 关键词行。通过透明的意图和 SERP 重叠分析,将相关词语归组,再将由此得到的主题用作大纲依据。不要暗示 MCP 会返回语义聚类,也不要暗示固定数量的词语会对应一个标题。
建议使用一个清晰的 H1 来描述页面、满足其主要意图,并与标题主题保持一致。**Semrush 支持的指导原则:**主标题使用一个 H1,然后使用 H2 标记主要章节,使用 H3 标记子章节。将使用一个 H1 视为编辑和结构上的建议,而非排名保证或自动判定失败的条件。
标题应清晰、直接且描述具体。在实际可行时,尽量控制在 60 个字符以内,但不要为了达到目标而牺牲清晰度。只要能明确描述章节,"Pricing" 之类的简洁标签就可以。每个标题应聚焦于一个主题或观点。
在 H1 中包含主要关键词,并在适当时将相关的次要关键词或问题自然融入 H2 和 H3。以读者为先;不要强行使用精确匹配的措辞。使用 H1 和第一个 H2 说明主要意图,后续标题则用于涵盖相关的辅助意图。
H3 应作为 H2 下真正的子章节,而不只是为了营造视觉节奏。保持层级逻辑清晰且前后一致。
**可配置的默认设置:**为大纲中的每个条目添加 1 至 3 行注释,说明该章节应涵盖的内容、需要引用的具体来源,以及应纳入的任何数据点。避免直接起草章节内容。作者需要的是结构,而不是正文。
6. 范围指导
明确页面必须涵盖哪些问题、证据、示例和决策,才能满足受众和意图。若竞争对手篇幅是直接测量所得,可将其作为 SERP 背景信息进行描述,但绝不要将其设为最低字数、最高字数、排名保证或凑字数公式。
如果作者要求提供规划范围,应根据已批准的大纲和预期深度,给出明确标注为编辑估算的范围。说明有用且完整比匹配竞争对手的字数更重要。
7. 链接规划
内部链接。
- 在作者开始写作前,确定相关的目标页面。可通过 Semrush 自然搜索报告、用户提供的导出文件或手动整理的网站地图,从用户现有的网站中获取。
- 规划双向链接:从新页面链接到主题相关的现有页面,并从相关的现有页面或权威页面链接到新页面。
- Semrush 支持的指导建议: 力争为每篇新内容添加至少两个或三个指向它的内部链接。将此视为编辑目标,而非自动判定失败的条件。应根据上下文相关性推荐指向其他页面的内部链接,而非设定固定数量。
- 当支柱页面与内容集群之间的链接符合网站的实际架构时,使用此类链接。不要自动要求添加指向首页或支柱页面的链接。
- 使用简洁、描述性强的锚文本,最好不超过五个词。相关时可以使用完全匹配的内部锚文本,但要避免关键词堆砌和“点击此处”“此页面”等泛化锚文本。
外部链接。
- 确定用于支持论点或提供有用背景信息的相关、可信且专业的外部来源。
- 可配置的来源质量默认规则: 有政府来源、原创研究、一手产品文档和可信行业刊物时,优先选用。不要将所有聚合网站一概视为不可接受;应评估具体来源及其证据。
- 不要规定固定的外部链接数量。使用简洁、描述性强的锚文本,仅在链接能为读者增加价值时才推荐。
- 避免标题党、低质量信息来源、低质量目录或书签网站,以及任何旨在操纵排名的链接方案。
- 指向可信来源的常规编辑链接无需添加特殊的关系属性。如果网站不应为某来源背书或与之关联,则使用
rel="nofollow"。对于赞助链接或联盟链接,使用rel="sponsored"或rel="nofollow";不要一概禁止。
8. 风格与语气说明
列出三到五个要点,涵盖:
- 阅读水平(专业、面向大众、入门级)。
- 使用第一人称、第二人称,还是不使用人称。选择一种并告知作者。
- 示例规范。使用真实数字和真实名称,还是假设性占位符。
- 用户之前指出过的禁用语句或 AI 痕迹。
- 品牌风格指南链接(语气文档、风格指南 URL)。
如何报告内容简报
将内容简报作为单个 Markdown 文档输出。使用与以上八个部分对应的 H2 标题。在文档底部加入“给作者的备注”部分,列出任何无法归入结构化部分的内容。
内容简报本身有两条规则。
- 标注实际值及其来源。“Semrush
phrase_this:搜索量 2,400,KD 38%,意图代码 1(映射尚未确认)”在没有已验证映射时很有用。“不错的目标”则没有用。 - 为引用的每个数据点提供具体来源。内容简报若写“根据近期一项研究”,却不注明研究名称,就是在要求作者凭空编造。
- 标注人工观察和模型生成的建议;如果证据不完整,且会实质影响建议的格式、角度或大纲,则添加简短的置信度说明。
内容简报的详略应与主题复杂度及作者需求相称。删除不会影响作者决策的指示。
来源
此技能基于以下 Semrush 编辑资料:
请将这些文章作为方法参考。只有在用户要求提供方法论引用,或需要核实具体说法时,才在面向用户的简报中加入文章链接。