mcpField
B
blog-generation

blog-generation

github.com/hyperfx-ai营销与增长107139 次安装2 天前更新
代码仓库

关于 blog-generation

面向企业的定期或按需博客写作技能,结合品牌指南与持久化发布记录。它研究选题、每次撰写一篇文章,并记录结果以避免重复覆盖。

主要功能

  1. 01维护品牌策略和发布历史
  2. 02选择尚未覆盖的主题
  3. 03研究搜索结果和 AI 引用
  4. 04撰写符合品牌风格的答案优先文章
  5. 05检查质量并更新发布记录

适用场景

  1. 01为企业定期生成博客文章
  2. 02根据搜索或客户信号起草文章
  3. 03改进现有文章的标题、结构或 Schema

MCP 相关

需要 Hyper MCP 以连接 Firecrawl、HyperSEO 和 Google Search Console 等研究集成。技能使用可用的 MCP 工具进行网站调研、主题验证、搜索分析和效果信号收集,并通过文件工具保存持久化策略与发布记录。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill blog-generation

安装后在 Claude Code 中输入/blog-generation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
ai-citation-playbook.md
blog-archetypes.md
blog-playbook.md
brand-voice-and-quality.md
on-page-and-technical.md

详细介绍

博客生成

每次运行只做好一件事:产出一篇出色、符合品牌调性的博客文章,既针对 Google 排名进行优化,也能获得 AI 搜索引用,而且绝不重复已写过的内容。此工具专为定期运行而设计(例如每天发布一篇),也可按需为任何行业的企业生成内容:牙医、珠宝商、B2B SaaS 或 DTC 品牌。

整个方法归结为两点。第一,提升 AI 搜索可见度,就是做好 SEO:创作独特、真正有用、以人为本且观点鲜明的内容,并以机器能够提取明确答案的方式组织内容。没有什么 AEO 秘诀。第二,引擎具备记忆:一个保存在持久存储中的 blog-strategy.md 文件,记录品牌背景信息以及每篇已发布文章的日志。正是这份日志确保它永不重复。

记忆约定(本技能中最重要的规则)。 日志保存在一个能在多次运行之间留存的真实文件中。首次运行时,该文件不存在,因此需要创建。之后每次运行时,该文件都已存在,因此在执行任何操作前都必须将其读入上下文,然后在结束前将新文章追加到文件中。每次都使用同一品牌、同一文件路径。如果没有先读取日志就撰写文章,或在运行结束前没有将文章追加到日志中,引擎就会出问题:它会陷入循环并重复主题。先读日志、最后追加日志,这两步绝不能跳过。

要求

  • 已连接 Hyper MCP。 https://app.hyperfx.ai/mcp
  • 品牌策略文档(blog-strategy.md),存放在持久文件中。如果尚不存在,引擎会在首次运行时创建(步骤 0)。这样才能以品牌真实的语气撰写内容并避免重复。
  • 推荐工具包,在 https://app.hyperfx.ai/apps 启用:Firecrawl(读取品牌网站)、HyperSEO(验证主题、查看哪些内容排名靠前以及 AI 引用了哪些内容)、Google Search Console(挖掘真实信号并衡量效果)。没有这些工具包仍可起草内容,但必须说明主题和排名判断未经验证。
如何运行本技能中的工具

本技能中的每个工具都使用其标准工具名称。请使用当前界面提供的调用方式运行:

界面查找工具运行工具
MCP 客户端(Claude、Cursor、Codex、ChatGPT)search("<what you want to do>"),然后 describe("<name>")call("<name>", {...})
Hyper CLIhyperai search "<what you want to do>",然后 hyperai describe <name>hyperai call <name> --json '{...}'

如果找不到某个工具,说明其集成尚未连接或未在工作区中启用:停止操作,并告知用户需要连接哪个集成。

工具界面

工作工具
读取和写入 blog-strategy.md 及文章草稿文件工具(read_file、create_file、edit_file)
从品牌网站了解品牌(步骤 0)firecrawl_urls_scrape、web_pages_scrape
验证主题并研究 SERP / AI 答案hyperseo_search_volume_get、hyperseo_keyword_difficulty_get、hyperseo_intents_search、hyperseo_ai_search_volume_get、hyperseo_serp_results_get、hyperseo_ai_overviews_get
挖掘真实信号并衡量影响google_search_console_performance_get
检查 AI 是否推荐该品牌hyperseo_mentions_track

超出范围:转交给其他技能

请求转交给
关键词研究、SERP / AI 概览分析、竞争对手基准分析、网站审核、AI 可见度跟踪seo-research
将 YouTube 视频改写成文章youtube
用真实客户评价(Reddit、评论)为文章提供依据customer-research
发布到社交渠道linkedin、instagram、tiktok

每次任务触发时都要执行的流程

步骤 0(仅首次运行):构建策略文档。 如果 blog-strategy.md 不存在,请在编写任何内容之前创建该文件。阅读品牌网站(使用 firecrawl_urls_scrape 抓取首页、关于页面、表现最佳的现有文章、产品和定价页面),并按照 references/brand-voice-and-quality.md 中的方法填写品牌简介。在主题待办列表中加入 8 到 15 个候选主题(条件允许时使用 HyperSEO 验证)。然后继续执行步骤 1。如果有任何关键信息未知(真实的证明材料、品牌的实际定位),请询问用户,不要凭空编造。

步骤 1:加载记忆(阅读日志)。 打开品牌保存路径中的 blog-strategy.md,并将其全部内容读入上下文:品牌简介(每篇草稿都必须遵循的约定)以及完整的已发布日志(所有已撰写的内容)。首次运行后的每次运行都必须执行此步骤,没有例外。未读取该文件前,不得选择新主题。

步骤 2:规划今天的文章。 选择一个未出现在已发布日志中且与日志内容确实不同的主题(参见下文“选择新主题”)。写一行计划,准确涵盖以下四项,并将其记录到策略文档中:

  • 标题/主题:暂定标题及其目标核心查询。
  • 主题来源:来源或触发因素(待办列表项目、GSC 缺口、客户问题、关键词缺口、新闻切入点、品牌自身的专业知识或数据)。
  • 文章要做什么:采用 references/blog-archetypes.md 中的一种文章类型(清单、比较、操作指南、概念介绍、替代方案、支柱文章、痛点/诊断、原创研究、案例研究、术语表)。
  • 需要开展的研究:针对这篇文章的具体检查(SERP 调研、AI Overview 检查、需查阅的来源、要重点展示的品牌证明材料)。

步骤 3:研究。 执行计划。验证目标(hyperseo_search_volume_get、_keyword_difficulty、_search_intent、_ai_search_volume)。研究排名靠前的内容(hyperseo_serp_results_get)以及 AI 已引用的内容(hyperseo_ai_overviews_get)。阅读排名靠前的页面,找出它们共同遗漏的角度。收集要引用的真实事实、统计数据和具名来源。绝不编造。

步骤 4:撰写文章。 按照 references/blog-archetypes.md 中的文章类型规范,使用 references/blog-playbook.md 中的先给答案结构和可直接复制的内容块,根据 references/brand-voice-and-quality.md 中的要求采用品牌语气,并遵循 references/ai-citation-playbook.md 中的引用方法。按照 references/on-page-and-technical.md 处理页面优化和 Schema。

步骤 5:通过质量关卡。 在文章完成前,确保通过 references/brand-voice-and-quality.md 中发布前检查的每一项:符合品牌调性、不留 AI 痕迹、不编造、采用先给答案的结构、完成页面优化和 Schema、记录基线数据。任何一项未通过,都必须修正。

步骤 6:更新记忆(追加日志)。 在 blog-strategy.md 的已发布日志中追加一行,记录已完成的文章(日期、标题、slug、文章类型、目标查询、来源、链接),并将文件保存回相同路径。从待办列表中移除该主题,并加入研究过程中发现的新想法。下一次运行会读取这条新增记录,以避免重复。每次运行结束前都必须完成此步骤。

步骤 7:交付。 输出文章(如果该品牌已配置发布流程,则同时发布)。告知用户,排名变化需要几天到几周,AI 引用则需要几周。

选择新鲜主题(杜绝循环)

每次运行都必须产出新内容。选择主题时:

  1. 排除「已发布日志」中的所有内容,以及任何只是换种说法的内容(标题不同但意图相同,也算重复)。
  2. 优先选择优先级最高且未受阻的待办事项,并确保符合品牌调性且确有需求。
  3. 变换内容形式。 如果最近几篇都是清单类文章,就写一篇操作指南、痛点诊断文章或原创数据文章。健康的博客应混合多种文章类型。
  4. 尽可能利用实时信号:GSC 中品牌排名位于搜索结果第二页的查询(google_search_console_performance_get)、关键词缺口(以 seo-research 为准)、反复出现的客户问题,或品牌所在领域的时事话题。
  5. 充分利用品牌自身的素材。 最值得引用、最难重复的文章,往往用到了品牌专有数据、真实客户成果或一手专业经验。应经常优先采用这些素材。

策略文档(blog-strategy.md)——引擎的记忆

每个品牌对应一个 Markdown 文件,保存在持久化存储中的固定路径(例如 /files/<brand-slug>/blog-strategy.md),并在每次运行时沿用同一个路径。第 0 步创建,第 1 步读取,第 6 步追加内容。「已发布日志」部分用于防止重复,并且只会不断增长。模板:

# Blog Strategy: [Business name]

## Brand brief
- Business: [what they do, one sentence]
- Sells: [products / services]
- Audience / ICP: [the specific customer]
- Category + one-liner: "[Brand] is a [category] for [audience] that [core value]."
- Voice: [tone, reading level, point of view]
- Words we use / words we avoid: [...]
- Proof assets: [real numbers, customers, credentials, data, stories]
- Primary site: [url]
- Target topics / seed keywords: [themes]
- Publishing: [where posts go, cadence]

## Topic backlog (planned, prioritized)
| Priority | Working title | Archetype | Target query | Source / angle | Status |
| --- | --- | --- | --- | --- | --- |
| 1 | ... | ... | ... | ... | planned |

## Published log (do NOT repeat anything here)
| Date | Title | Slug | Archetype | Target query | Source | Link |
| --- | --- | --- | --- | --- | --- | --- |

每次运行都必须遵守的原则

  • 独特、以人为本,胜过一切取巧手段。 如果模型只凭常识就能写出这篇文章,或者已有十个页面都在说同样的内容,就不要发布。应以品牌的真实视角为切入点。
  • 先给答案,再作解释。 文章开头和每个章节都要直接给出答案。AI 会提取这些内容;Google 也会给予更高评价。
  • 符合品牌调性、有人情味,否则适得其反。 偏离品牌调性、满是 AI 痕迹或带有强烈推销意味的内容会损害信任,也会被 AI 引擎降低优先级。品牌真实的声音就是资产。参见 references/brand-voice-and-quality.md。
  • 具体、可核验,绝不含糊或捏造。 提供数字、姓名、日期和真实来源。绝不编造统计数据、引言、客户或资质。
  • 每次运行都产出一篇新文章,并始终记录。 正是这份日志,让引擎持续运转,而不是陷入循环。

还可用于:优化现有文章

同一组参考资料也适用于改进已有页面(为曝光量高但点击率低的页面重写乏力的标题和开篇、增加结构和 schema、强化品牌建议的上下文)。使用 references/on-page-and-technical.md 和 references/brand-voice-and-quality.md,并在策略文档中记录更改。

参考资料

  • references/blog-archetypes.md:10 种博客类型的权威规范,分别说明结构、长度、schema、AI 引用切入点和常见问题。清单类文章的说明最为详尽。
  • references/blog-playbook.md:先给答案的结构;可直接复制粘贴的内容块模板;经过验证的 GEO 写作规则;主题集群;改进现有文章。
  • references/brand-voice-and-quality.md:从品牌网站提炼声音特征;明确定位;避免 AI 痕迹和尴尬表达的规则;发布前质量检查。
  • references/ai-citation-playbook.md:Princeton GEO 因素排序;E-E-A-T 和作者/实体信号;站外提及;各引擎说明;对 Google 的客观立场。
  • references/on-page-and-technical.md:页面优化检查清单;JSON-LD schema 和弃用项;可抓取性/AI 机器人/服务器渲染检查;如何衡量影响。

评论

支持 Markdown