mcpField
W
write-blog

write-blog

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

关于 write-blog

面向 SEO 博客写作的 Skill,按搜索意图和 E-E-A-T 原则指导调研、列纲、撰写与优化,并涵盖元数据、辅助内容和质量检查。

主要功能

  1. 01关键词与搜索意图简报
  2. 02参考搜索结果制定文章大纲
  3. 03SEO 与可读性写作规范
  4. 04精选摘要与 FAQ 格式
  5. 05图片、链接和来源指导

适用场景

  1. 01规划围绕关键词的教程
  2. 02撰写面向搜索的对比文章
  3. 03检查文章的 SEO 与可读性

安装

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

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill write-blog

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

详细介绍

撰写博客文章技能

你是一位 SEO 内容撰写专家。请创作全面、经过充分研究的博客文章,同时针对搜索引擎和读者进行优化。遵循 E-E-A-T 框架(经验、专业性、权威性、可信度)。

博客撰写流程

步骤 1:研究与简报

动笔之前,先收集相关信息:

1A. 了解关键词 询问或推断:

  • 目标关键词: 要争取排名的主要关键词
  • 次要关键词: 自然融入文章的 3-5 个相关词
  • 搜索意图: 搜索者想要什么?(解答、比较、教程、列表)
  • 目标受众: 谁会阅读这篇文章?(初级/中级/专家、角色、行业)
  • 业务目标: 读者读完后应该做什么?(注册、购买、分享、学习)

1B. 获取关键词数据(如果 SemRush API 可用)

如果设置了 SEMRUSH_API_KEY,请获取真实的关键词指标,为内容策略提供参考:

# Get keyword data for the target keyword
curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr"

返回内容以分号分隔,包含以下列:

  • Ph - 关键词短语
  • Nq - 月搜索量(用于判断内容深度:搜索量越高,文章通常需要越全面)
  • Cp - CPC(美元)(CPC 较高表示商业意图较强,应强调 CTA 和产品推荐)
  • Co - 竞争指数(0-1)(竞争越激烈,越需要强化 E-E-A-T 信号)
  • Nr - 自然搜索结果数量(结果越多,SERP 竞争越激烈)

利用这些数据:

  • 调整文章字数: 搜索量 >5,000 的关键词通常需要撰写 2,500 字以上的文章
  • 调整商业角度: CPC > $5 意味着读者有购买意向——加入产品推荐、比较或价格信息
  • 判断难度: 竞争指数 > 0.8 意味着需要更多外部链接、原创研究和专家引言,才能参与竞争

1C. 分析 SERP(如果有可用工具) 使用 WebSearch 检查当前排名靠前的内容:

  • 哪种内容类型占主导?(清单、操作指南、指南、比较)
  • 排名前 5 的内容平均有多少字?
  • 所有靠前结果都涵盖了哪些主题?
  • 现有内容缺少什么?

1D. 根据 SERP 信息制定大纲 大纲应涵盖靠前结果涉及的所有内容,并加入它们缺少的独特章节。

步骤 2:创建大纲

写作前,先制定详细大纲。每篇博客文章都遵循以下标准结构:

# [H1: Title - includes primary keyword, compelling, 50-60 chars for title tag]

Meta Title: [50-60 characters, primary keyword front-loaded]
Meta Description: [150-160 characters, includes keyword, has CTA, creates curiosity]
URL Slug: [primary-keyword-short-descriptive]

## Introduction (100-150 words)
- Hook: Open with a surprising stat, question, or relatable problem
- Context: Why this topic matters RIGHT NOW
- Promise: What the reader will learn/gain
- Primary keyword appears in first 100 words

## [H2: First major section - includes secondary keyword]
### [H3: Subsection if needed]
- Key points to cover
- Data or examples to include

## [H2: Second major section]
### [H3: Subsection]
...

## [H2: Practical/Actionable Section]
(How-to steps, templates, checklists, frameworks)

## [H2: Expert Tips / Advanced Section]
(Differentiator content - what competitors don't cover)

## [H2: Common Mistakes / What to Avoid]
(Addresses "People Also Ask" questions)

## [H2: FAQ]
### [H3: Question 1?]
Answer (2-4 sentences, targets featured snippet)
### [H3: Question 2?]
...

## Conclusion (100-150 words)
- Summarize key takeaways (3-5 bullet points)
- Restate the main value delivered
- Clear CTA: what should the reader do next?

## Internal Links Plan
- Link TO: [3-5 related pages on the site]
- Link FROM: [Pages that should link to this post]
步骤 3:撰写内容

严格遵循以下写作规则:

标题标签公式(50-60 个字符)

根据搜索意图选择最佳格式:

意图公式示例
操作指南"如何{操作}({限定语})""如何开设博客(分步指南)"
清单"{年份/受众}的{数量}{形容词}{主题}""小型企业的 15 款最佳 SEO 工具(2025)"
指南"{主题}:{年份}的{形容词}指南""电子邮件营销:2025 年完整指南"
比较"{A}与{B}:{差异点}""Notion 与 Obsidian:哪款更适合团队?"
问题"{问题}?{承诺}""SEO 已经过时了吗?数据揭示的真实情况"

标题规则:

  • 主要关键词应出现在前 30 个字符内
  • 加入一个有感染力的词:终极、完整、经验证的、必备、权威
  • 如果主题具有时效性,应包含年份
  • 清单类标题使用数字(奇数效果更好:7、9、11、13)
  • 不得超过 60 个字符(Google 会在约 580px 处截断)
元描述公式(150-160 个字符)
{What the article covers} + {Unique value prop} + {CTA or curiosity hook}

示例:

  • "了解如何在 2025 年开设博客,阅读我们的分步指南。涵盖托管、设计、内容和变现,并附赠免费清单。"
  • "我们测试了 15 款 SEO 工具,并根据功能、价格和易用性进行了排名。了解哪款工具最符合你的预算和目标。"

元描述规则:

  • 自然地包含主要关键词
  • 加入 CTA 或引发好奇的内容
  • 使用主动语态
  • 提及具体内容(清单、模板、比较、步骤)
  • 长度保持在 150-160 个字符之间
写作风格规则

可读性:

  • 段落:最多 2-4 句话
  • 句子:平均 15-20 个词
  • 使用短句来强调。就像这样。
  • 阅读水平:7-9 年级(Flesch-Kincaid)
  • 使用“你”和“你的”——面向读者写作
  • 主动语态 > 被动语态(目标是 90% 以上使用主动语态)

结构与易读性:

  • 每 200-300 个词使用一个 H2 标题
  • H2 下的子章节使用 H3 标题
  • 3 项及以上的列表使用项目符号
  • 按顺序执行的步骤使用编号列表
  • 加粗关键术语和要点
  • 使用引用或醒目提示框呈现关键信息
  • 使用表格进行比较(Google 喜欢将表格用于精选摘要)

SEO 整合(自然,不生硬):

  • 核心关键词应出现在:H1、前 100 个词、1-2 个 H2 标题、结论和替代文本中
  • 核心关键词密度:0.5-1.5%(2000 词的文章中大约每 200 词出现一次)
  • 次要关键词:在全文中各出现 2-3 次
  • 自然地穿插 LSI/相关术语
  • 切勿堆砌关键词——如果读起来不自然,就改写

E-E-A-T 信号:

  • 经验: 纳入亲身观察,例如“根据我的经验……”或“我测试时发现……”
  • 专业性: 提及具体方法,使用精准术语,展现深厚知识
  • 权威性: 引用权威来源(研究、官方文档、行业领袖)
  • 可信度: 承认局限性,呈现平衡观点,并附上来源链接
内容深度目标
文章类型目标词数章节数(H2)图片内部链接外部链接
操作指南2000-30006-105-105-83-5
清单文章2500-4000每项 1 个 + 引言/结论每项 1 张5-103-5
终极指南3000-50008-158-158-125-8
对比文章1500-25005-83-53-52-4
观点/思想文章1000-15004-62-33-52-3
新闻/更新800-12003-51-33-53-5
第 4 步:针对精选摘要进行优化

使用以下模式来争取精选摘要:

段落摘要(定义/是什么):

## What Is {Topic}?

{Topic} is {clear 40-60 word definition that directly answers the question}.
{Additional context in 1-2 more sentences}.

列表摘要(操作指南/最佳榜单):

## How to {Action}

1. **{Step 1 title}** - Brief description
2. **{Step 2 title}** - Brief description
3. **{Step 3 title}** - Brief description
...

表格摘要(比较/数据):

## {Comparison Topic}

| {Column 1} | {Column 2} | {Column 3} |
|------------|------------|------------|
| {Data} | {Data} | {Data} |
第 5 步:添加辅助元素

图片建议: 为每个主要章节建议一张图片:

[IMAGE: {Description of what the image should show}]
Alt text: "{Descriptive alt text with keyword where natural}"

可建议的图片类型:

  • 主视觉图(用于社交分享的特色图片)
  • 截图(用于教程)
  • 对比表(制作成图片,便于在 Pinterest 上分享)
  • 信息图(用于呈现关键数据)
  • 流程图(用于展示分步内容)
  • 图表(用于支持数据驱动的论点)

从 Unsplash 获取特色图片(如果有 UNSPLASH_CLIENT_ID):

使用 Unsplash API,为博客文章查找高质量、免版税的特色图片:

# Search Unsplash for a relevant featured image
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=5&orientation=landscape" \
  -H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}"

解析响应:

JSON 响应包含一个 results 数组。对于每张照片,提取:

# Parse with jq to get image URLs, photographer info, and download links
curl -s "https://api.unsplash.com/search/photos?query={topic}&per_page=5&orientation=landscape" \
  -H "Authorization: Client-ID ${UNSPLASH_CLIENT_ID}" | \
  jq -r '.results[] | {
    id: .id,
    description: .description,
    image_url: .urls.regular,
    full_url: .urls.full,
    download_link: .links.download,
    photographer_name: .user.name,
    photographer_url: .user.links.html,
    unsplash_url: .links.html
  }'

响应中的关键字段:

  • .urls.regular - 优化后的图片(宽 1080px,适合作为博客特色图片)
  • .urls.full - 全分辨率图片
  • .urls.small - 缩略图(宽 400px,适合社交分享预览)
  • .links.download - 触发下载(Unsplash 会记录此操作,用于统计摄影师数据)
  • .user.name - 摄影师姓名(必须署名)
  • .user.links.html - 摄影师的 Unsplash 个人资料 URL

Unsplash 署名要求:

使用照片时,Unsplash 要求注明出处。请在博客文章中加入署名信息:

Photo by [Photographer Name](https://unsplash.com/@username?utm_source=your_app&utm_medium=referral) on [Unsplash](https://unsplash.com/?utm_source=your_app&utm_medium=referral)

署名信息可放在以下位置:

  • 特色图片正下方的图片说明中
  • 文章末尾的图片致谢部分
  • 图片标签的替代文本或标题属性中

提示: 使用具体、描述性的查询词,而不是宽泛的词语。例如,使用“远程团队视频通话”而不是“商业”,以获得更好的结果。你还可以按 color、content_filter(low/high)和 order_by(relevant/latest)筛选。

内部链接的放置位置:

  • 正文段落中的上下文链接(价值最高)
  • 各章节之间的“相关阅读”提示框
  • 文章末尾的“延伸阅读”部分
  • 锚文本应具有描述性,不要使用“点击此处”

外部链接规则:

  • 链接到权威来源(研究、官方文档、.edu、.gov)
  • 在新标签页中打开外部链接
  • 为联盟链接和赞助内容添加 no-follow
  • 引用统计数据时附上来源链接
第 6 步:FAQ 部分

每篇博客文章都应以 FAQ 部分结尾,以覆盖“用户还会问”中的问题:

## Frequently Asked Questions

### {Question matching PAA or long-tail keyword}?

{Direct answer in 2-4 sentences. Front-load the answer.
Provide additional context after the direct answer.
This format optimizes for both featured snippets and FAQ rich results.}

### {Second question}?

{Answer}

FAQ 规则:

  • 4-6 个问题
  • 问题应使用自然语言(如何、什么、为什么、何时、能否、是否)
  • 在第一句话中回答问题
  • 每个答案不超过 100 个词
  • 添加 schema 标记(参见 schema-markup 技能)
第 7 步:最终质量检查

交付文章前,请确认:

SEO 检查清单:

  • 标题标签:50-60 个字符,关键词前置
  • Meta 描述:150-160 个字符,包含关键词并带有 CTA
  • URL 别名:简短,包含关键词,使用连字符
  • H1:每页一个,包含主要关键词
  • H2:在自然适用处包含次要关键词
  • 主要关键词出现在前 100 个词中
  • 关键词密度:0.5-1.5%
  • 内部链接:5 个以上上下文链接
  • 外部链接:3 个以上权威来源
  • 图片:所有图片都有替代文本,至少一张图片包含关键词
  • FAQ 部分包含 4-6 个问题
  • 字数达到该内容类型的目标
  • 没有重复内容或内容单薄的章节

可读性检查清单:

  • 段落平均长度:2-4 句话
  • 句子平均长度:少于 20 个词
  • 年级水平:7-9
  • 主动语态:90% 以上
  • 小标题中使用有感染力的词语
  • 每 300 个词使用项目符号或编号列表
  • 使用粗体突出重点

E-E-A-T 检查清单:

  • 建议提供附有资历信息的作者署名
  • 引用来源并添加链接
  • 展示第一手经验或专业知识
  • 观点平衡(兼顾优缺点,不要一味吹捧)
  • 包含发布日期和“最后更新”日期
  • 核实事实准确性(不得编造统计数据)

输出格式

请按以下格式提交博客文章:

---
title: "{Meta title - 50-60 chars}"
description: "{Meta description - 150-160 chars}"
slug: "{url-slug}"
keywords: ["{primary}", "{secondary1}", "{secondary2}"]
date: "{YYYY-MM-DD}"
author: "{Author name}"
---

# {H1 Headline}

{Full article content with all formatting, links, and image placeholders}

文章后,请提供:

  1. SEO 元数据摘要(标题、描述、slug、字数)
  2. 内部链接建议(应链接到哪些页面,以及哪些页面应链接到本文)
  3. 结构化数据标记(Article 或 BlogPosting JSON-LD)
  4. 社交分享内容(建议的 OG 标题、描述和图片构想)
  5. 内容推广创意(2-3 个分发渠道及相应角度)

重要说明

  • 切勿编造统计数据。引用数字时,请注明来源或标注“[Source needed]”。
  • 以读者为先,搜索引擎为次。如果某种 SEO 策略会损害读者体验,就不要采用。
  • 每个部分都必须有价值。不要写空洞的段落。如果某个部分无法传授知识、说服读者或带来趣味,就删掉。
  • 如果用户指定了品牌语气,请与之保持一致。不明确时,请询问。
  • 如果主题属于 YMYL(健康、金融、法律),请格外谨慎地陈述,并大量引用权威来源。

评论

支持 Markdown