---
slug: "blog-writer-free"
name: "blog-writer-free"
version: 1.0.1
displayName: "博客写作引擎(免费版)"
summary: "博客文章创作，覆盖选题分析、大纲生成、SEO优化与多平台适配发布。免费版。博客文章创作引擎（免费版），覆盖从选题到发布全流程。支持技术博客、产品博客、 思想领导力文章等多种类型。核心能力："
summary_zh: "博客文章创作，覆盖选题分析、大纲生成、SEO优化与多平台适配发布。免费版。博客文章创作引擎（免费版），覆盖从选题到发布全流程。支持技术博客、产品博客、 思想领导力文章等多种类型。核心能力："
license: "MIT"
description: |-
  博客文章创作引擎（免费版），覆盖从选题到发布全流程。支持技术博客、产品博客、
  思想领导力文章等多种类型。核心能力：
  - 选题分析与内容规划（趋势研究+竞品分析+SEO关键词）
  - 大纲生成与结构设计（Hook-Body-Conclusion框架）
  - 正文撰写与风格适配（技术/产品/故事风格）
  - SEO优化与多平台适配
tools:
  - read
  - exec
  - write
homepage: ""
tags:
  - 通用办公
  - 工具
  - 效率
  - 写作
  - seo
  - api
  - 平台适配
  - 优化与多
  - docker
category: "Automation"
---
# 博客写作引擎(免费版)

博客文章创作引擎，覆盖从选题到发布全流程，支持技术博客、产品博客、思想领导力文章等多种类型.
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 博客写作引擎(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux

### 依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-----|:-----|:-----|:-----|
| LLM API | API | 必需 | 由Agent内置LLM提供 |

### API Key 配置
需要配置对应API Key，详见上文环境配置章节

### 可用性分类
- **分类**: MD+EXEC（）

**API Key配置方式**:
```bash
export API_KEY="your_api_key_here"
```
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
## 核心能力

### 1. 选题分析与内容规划
- **趋势研究**：搜索当前热点话题和行业趋势
- **竞品分析**：分析同领域热门文章的选题角度和缺口
- **SEO关键词**：提取搜索量高、竞争度适中的关键词
- **选题评估矩阵**：按搜索量/竞争度/相关性/时效性评分排序

**输出**: 返回选题分析与内容规划的处理结果,包含执行状态码、结果数据和执行日志.
### 2. 大纲生成与结构设计
标准博客结构框架：
- **Hook**：开头抓注意力（数据/问题/故事/反常识）
- **Problem**：明确读者痛点
- **Solution**：核心内容（分点论述）
- **Evidence**：数据/案例/代码支撑
- **Action**：行动呼吁/总结要点
- **CTA**：引导互动（评论/订阅/分享）

**输入**: 用户提供大纲生成与结构设计所需的指令和必要参数.
**处理**: 解析大纲生成与结构设计的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回大纲生成与结构设计的处理结果,包含执行状态码、结果数据和执行日志.
### 3. 正文撰写与风格适配
按目标受众调整写作风格：
- **技术博客**：代码示例为主，严谨准确，含可运行代码
- **产品博客**：用户故事为主，情感共鸣，突出价值
- **思想领导力**：观点鲜明，数据支撑，前瞻性视角
- **教程类**：步骤清晰，截图/代码配合，可复现

**输出**: 返回正文撰写与风格适配的处理结果,包含执行状态码、结果数据和执行日志.
### 4. SEO优化与多平台适配
- **标题优化**：含关键词，60字符内，吸引点击
- **Meta描述**：155字符内，含关键词和行动呼吁
- **标题层级**：H1/H2/H3合理嵌套，含关键词
- **内链外链**：相关文章内链+权威来源外链
- **平台适配**：Markdown（GitHub/掘金）/ HTML（WordPress）/ 富文本（Medium/知乎）

**输入**: 用户提供SEO优化与多平台适配所需的指令和必要参数.
**处理**: 解析SEO优化与多平台适配的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回SEO优化与多平台适配的处理结果,包含执行状态码、结果数据和执行日志.
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

| 场景 | 输入 | 输出 |
|---:|---:|---:|
| 技术博客 | 技术主题+深度 | 大纲+正文+代码示例 |
| 产品发布博客 | 产品功能+目标用户 | 价值故事+功能说明+CTA |
| SEO文章 | 关键词+目标排名 | 优化标题+结构化正文+Meta |
| 多平台分发 | 原始文章 | 各平台适配版本 |

**不适用于**：新闻实时报道、学术论文、法律/医疗专业内容、虚假宣传.
## 使用流程

1. 确定文章类型和目标受众
2. 选题研究（趋势/竞品/SEO关键词）
3. 生成大纲并确认结构
4. 撰写正文（分段输出，保持风格一致）
5. SEO优化与多平台适配
6. 输出最终Markdown/HTML

## 示例

### 示例1：技术博客创作
```
输入: "写一篇关于Docker多阶段构建优化的技术博客，目标读者: 中级开发者"
大纲:
  Hook: "你的Docker镜像有800MB？多阶段构建能压到50MB"
  Problem: 镜像过大的问题（部署慢/安全风险/存储成本）
  Solution: 多阶段构建原理+实操示例
  Evidence: 优化前后对比（800MB→50MB）
  Action: 总结最佳实践清单
正文: [按大纲逐段撰写，含Dockerfile代码示例]
SEO: 标题"Docker多阶段构建：将镜像从800MB优化到50MB"
```

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:---:|:---:|:---:|
| 选题与已有文章高度重复 | 热门选题竞争激烈 | 寻找差异化角度（细分场景/对比分析/实战经验），或选择长尾关键词降低竞争 |
| 正文风格不统一 | 多段撰写时风格漂移 | 撰写前定义风格指南（人称/语气/句式/术语），每段撰写后检查一致性 |
| SEO关键词堆砌影响可读性 | 过度优化关键词密度 | 保持关键词密度1-2%，优先自然融入标题和首段，正文以可读性为先 |
| 代码示例无法运行 | 代码有误或环境差异 | 提供完整可运行代码（含依赖安装），标注运行环境要求，附带GitHub链接 |

## 常见问题

### Q1: 博客文章的理想长度是多少？
取决于文章类型和目标。技术教程类2000-3000字（含代码），思想领导力类1500-2000字，产品博客800-1500字。SEO角度：长文（2000字+）通常排名更好，但前提是内容质量高、不注水。建议先写完整再精简，删除每一段中不增加价值的句子.
### Q2: 如何写吸引人的标题？
好标题公式：数字+关键词+价值/悬念。如"7个Docker优化技巧让你的镜像缩小80%"。包含：具体数字（7个/80%）、核心关键词（Docker优化）、明确价值（镜像缩小）。避免标题党（与内容不符）、过长（超过60字符被截断）、无关键词（SEO劣势）。A/B测试不同标题变体的点击率.
### Q3: 多平台分发时如何适配内容？
核心内容保持一致，调整格式和语气适配平台：GitHub/掘金用Markdown+代码块（技术受众，严谨）；知乎用富文本+故事化（混合受众，通俗）；Medium用HTML+长段落（国际受众，英文）；微信公众号需短段落+小标题+配图（移动端阅读，碎片化）。每平台标题可微调以匹配平台调性.
## 已知限制

- 无法生成原创图片/图表（仅文本内容）
- SEO数据基于公开搜索结果，非实时排名数据
- 多平台适配为格式调整，不涉及平台API发布

## 升级提示

本免费版提供基础功能。升级到完整版 blog-writer 获取全部能力和高级特性.
## 输出格式

```json
{
  "success": true,
  "data": {
    "result": "博客写作引擎(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "blog-writer"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}
```