mcpField
C
content-brief

content-brief

github.com/semrush营销与增长1374 次安装1 周前更新
代码仓库

关于 content-brief

content-brief 是为内容作者和 SEO 团队生成文章简报的技能,从一个目标关键词出发组织受众、角度、搜索结果分析和写作指导。它区分 Semrush 数据、人工观察与模型判断,不代写文章。

主要功能

  1. 01围绕单一目标关键词组织简报
  2. 02纳入受众、目标与内容角度
  3. 03分析搜索结果及排名页面
  4. 04提出标题、元描述和文章大纲
  5. 05规划范围、链接与风格指导
  6. 06标注数据来源并处理缺失证据

适用场景

  1. 01为目标关键词准备文章写作简报
  2. 02比较搜索结果中的页面类型与角度
  3. 03结合受众和业务目标确定文章方向
  4. 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 指标。

备用方案优先级

使用当前可用的最强数据源,并说明使用了哪一种。

  1. Semrush MCP 关键词、SERP 以及 URL/域名报告。
  2. 用户提供的 Semrush UI 导出数据。
  3. 对目标国家/地区进行人工 SERP 检查。
  4. 用户提供的竞争对手 URL 和一手受众说明。将缺失指标标记为未知,而非猜测。

证据约定

将来源溯源与置信度分开。对重要输入和建议使用以下标签:

  • Semrush 数据: 由具名 MCP 报告返回的数值。注明报告名称。
  • Semrush 支持的指导: 有 Semrush 链接来源支持的编辑建议。不要将其描述为搜索引擎要求。
  • 用户提供: 第一方目标、受众认知、转化证据、约束或已批准的来源。
  • 人工观察: 直接检查得出的 SERP 或页面特征,并非 MCP 返回的信息。
  • 模型推断: 基于现有证据得出的建议,例如格式、角度、分组或大纲结构。
  • 可配置默认值: 为方便使用而选择的起始范围,并非普适的 SEO 规则。

在面向用户的简报中,当来源会影响某项主张的可信度时,注明其来源。将标签精简地放在证据或理由说明中,不要给每句话都加标签。另行评估置信度,分为高、中或低;如果缺少的证据会降低置信度,请说明缺少了什么。

简报结构

工作简报包含以下八个部分。其他内容均为可选。

  1. 目标关键词与意图
  2. 受众与角度
  3. SERP 背景(前 10 名分析)
  4. 标题与元描述
  5. 大纲(H1、H2、H3)
  6. 范围指导
  7. 链接计划(内部与外部)
  8. 风格与语气说明

按顺序完成。每个部分都为下一部分提供依据。


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 编辑资料:

请将这些文章作为方法参考。只有在用户要求提供方法论引用,或需要核实具体说法时,才在面向用户的简报中加入文章链接。

评论

支持 Markdown