12 KiB
AI博客创作技能
博客 AI写作 SEO Claude Code 内容管理
claude-blog - Claude Code 的 AI 博客创作技能
claude-blog 是一个 Claude Code 技能生态系统，用于大规模创建、优化和管理博客内容。它能生成完整文章、内容简报、编辑日历和结构化数据，同时针对 Google 排名和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）进行双重优化。
目录
演示
快速开始
插件安装（Claude Code 1.0.33+）：
# 添加插件市场（一次性操作）
/plugin marketplace add AgriciDaniel/claude-blog
# 安装插件
/plugin install claude-blog@AgriciDaniel-claude-blog
一键安装（Unix/macOS）：
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/install.sh | bash
或克隆后手动安装：
git clone https://github.com/AgriciDaniel/claude-blog.git
cd claude-blog
chmod +x install.sh && ./install.sh
Windows（PowerShell）：
.\install.ps1
安装后重启 Claude Code 以激活。
命令
| 命令 | 说明 |
|---|---|
/blog write <主题> |
从头开始撰写新博客文章 |
/blog rewrite <文件> |
优化现有博客文章 |
/blog analyze <文件> |
质量审计，输出 0-100 分 |
/blog brief <主题> |
生成详细的内容简报 |
/blog calendar |
生成编辑日历 |
/blog strategy <领域> |
博客策略与选题创意 |
/blog outline <主题> |
基于 SERP 数据的内容大纲 |
/blog seo-check <文件> |
写作后的 SEO 验证 |
/blog schema <文件> |
生成 JSON-LD 结构化数据 |
/blog repurpose <文件> |
改编为社交媒体、邮件、YouTube 内容 |
/blog geo <文件> |
AI 引用就绪性审计 |
/blog image [generate|edit|setup] |
通过 Gemini 生成 AI 图像 |
/blog audit [目录] |
全站博客健康度评估 |
/blog cannibalization [目录] |
检测文章间关键词重叠 |
/blog factcheck <文件> |
核实引用来源中的统计数据 |
/blog persona [create|list|apply] |
管理写作人设和风格档案 |
/blog taxonomy [sync|audit|suggest] |
标签/分类 CMS 管理 |
/blog notebooklm <问题> |
通过 NotebookLM 进行来源可靠的研究查询 |
/blog audio [generate|voices|setup] |
通过 Gemini TTS 生成音频旁白 |
/blog google [命令] [参数] |
Google API 数据：PSI、CrUX、GSC、GA4、NLP、YouTube、关键词 |
共 22 个子技能：上方 20 个面向用户的命令 +
blog-chart（内部 SVG 图表生成）+blog-image（也可由 write/rewrite 内部调用）。
功能
12 种内容模板
根据主题和意图自动选择：操作指南、列表文章、案例研究、对比评测、支柱页面、产品评测、思想领导力、资源汇总、教程、新闻分析、数据研究、FAQ 知识库。
5 维度质量评分（满分 100 分）
| 维度 | 分值 | 关注点 |
|---|---|---|
| 内容质量 | 30 | 深度、可读性、原创性、吸引力 |
| SEO 优化 | 25 | 标题、标题标签、关键词、链接、元描述 |
| E-E-A-T 信号 | 15 | 作者、引用、可信度、经验 |
| 技术要素 | 15 | 结构化数据、图片、速度、移动端、OG 标签 |
| AI 引用就绪性 | 15 | 可引用性、问答格式、实体清晰度 |
评分等级：卓越（90-100）、优秀（80-89）、合格（70-79）、不达标（60-69）、需重写（<60）。
AI 内容检测
突发性评分、已知 AI 用语检测（17 个短语）、词汇多样性分析（TTR）。标记具有 AI 生成特征的内容。
人设驱动写作
可配置的写作人设，采用 NNGroup 四维语气框架。支持按博客或作者管理风格档案，包含可读性层次（消费者/专业/技术）和风格规范。
事实核查流程
统计数据验证，获取引用来源 URL 并评估声明可信度（精确匹配、释义、未找到）。确保内容中每个数据点均准确可溯源。
关键词蚕食检测
使用本地 grep 分析或 DataForSEO API 识别博客文章间的关键词重叠。提供严重程度评分及合并/差异化建议，防止文章间相互竞争。
CMS 分类法管理
标签和分类管理，支持 WordPress REST、Shopify GraphQL、Ghost、Strapi 和 Sanity。包含标签建议、同步和审计工作流。
双重优化
每篇文章同时针对 Google 排名和 AI 引用平台进行优化：
- Google：符合 2025 年 12 月核心更新要求、E-E-A-T、结构化数据、内链
- AI 引用：答案优先格式（引用率提升 340%）、引用胶囊、段落级可引用性、FAQ 结构化数据（引用率提升 28%）
视觉媒体
- Pixabay/Unsplash/Pexels 图片来源及 alt 文本
- 通过 Gemini 生成 AI 图像（题图、正文插图、社交卡片），可选，需免费 Google AI API 密钥
- 内置 SVG 图表生成（条形图、分组条形图、棒棒糖图、环形图、折线图、面积图、雷达图）
- YouTube 视频嵌入，支持 srcdoc 懒加载、noscript AI 爬虫回退及质量评分
- 按内容类型设定图片密度目标
- 图片 URL 验证（嵌入前检查 HTTP 200 状态）
Google API 集成（v1.6.5 新增）
跨 4 个凭据层级的 13 个命令，正常使用均免费：
- 第 0 层（API 密钥）：PageSpeed Insights、CrUX 核心 Web 指标（25 周历史数据）、YouTube 视频搜索、NLP 实体分析
- 第 1 层（OAuth）：Search Console 效果数据、URL 检查、Indexing API
- 第 2 层（GA4）：自然流量报告
- 第 3 层（Ads）：Google Ads 关键词规划工具
NotebookLM 研究
查询 Google NotebookLM，从用户上传的文档中获取来源可靠的研究内容。第 1 层数据质量，零幻觉风险。
音频旁白
通过 Gemini TTS 生成音频旁白。三种模式：摘要（200-300 字）、完整文章和双人对话。支持 30 种声音、80 余种语言。
平台支持
Next.js/MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 及静态 HTML。
架构
claude-blog/
├── .claude-plugin/
│ └── plugin.json # 插件元数据（名称、描述、作者）
├── skills/
│ ├── blog/ # 主编排器
│ │ ├── SKILL.md # 路由全部 21 个命令
│ │ ├── references/ # 13 个按需参考文档
│ │ └── templates/ # 12 种内容类型模板
│ ├── blog-write/SKILL.md # 子技能（21 个面向用户 + 1 个内部）
│ ├── blog-rewrite/SKILL.md
│ ├── blog-analyze/SKILL.md
│ ├── blog-brief/SKILL.md
│ ├── blog-calendar/SKILL.md
│ ├── blog-strategy/SKILL.md
│ ├── blog-outline/SKILL.md
│ ├── blog-seo-check/SKILL.md
│ ├── blog-schema/SKILL.md
│ ├── blog-repurpose/SKILL.md
│ ├── blog-geo/SKILL.md
│ ├── blog-audit/SKILL.md
│ ├── blog-chart/SKILL.md # 内部：SVG 图表生成
│ ├── blog-image/ # 通过 Gemini 生成 AI 图像
│ │ ├── SKILL.md
│ │ ├── references/ # 3 个参考文档（模型、工具、提示词）
│ │ └── scripts/ # MCP 设置和验证脚本
│ ├── blog-cannibalization/SKILL.md # 关键词重叠检测
│ ├── blog-factcheck/SKILL.md # 统计数据验证
│ ├── blog-persona/SKILL.md # 写作人设管理
│ ├── blog-taxonomy/SKILL.md # CMS 分类法管理
│ ├── blog-notebooklm/ # NotebookLM 来源可靠研究
│ │ ├── SKILL.md
│ │ ├── references/
│ │ └── scripts/ # 10 个 Python 脚本 + venv 包装器
│ ├── blog-audio/ # 通过 Gemini TTS 生成音频旁白
│ │ ├── SKILL.md
│ │ ├── references/
│ │ └── scripts/ # 5 个 Python 脚本 + venv 包装器
│ └── blog-google/ # Google API 集成（v1.6.5 新增）
│ ├── SKILL.md # 13 个命令，4 个凭据层级
│ ├── references/ # 3 个参考文档（认证、API、配额）
│ ├── scripts/ # 11 个 Google API 脚本 + venv 包装器
│ └── assets/templates/ # 3 个报告模板
├── agents/ # 4 个专用智能体
│ ├── blog-researcher.md
│ ├── blog-writer.md
│ ├── blog-seo.md
│ └── blog-reviewer.md
├── scripts/
│ └── analyze_blog.py # Python 质量分析（5 维度评分）
├── tests/ # pytest 测试套件
│ ├── conftest.py
│ └── test_analyze_blog.py
├── docs/ # 6 个文档文件
├── .github/workflows/ci.yml # CI 流水线
├── install.sh # Unix/macOS 安装程序（备用）
├── install.ps1 # Windows PowerShell 安装程序
├── pyproject.toml # Python 项目配置
├── requirements.txt # Python 依赖
├── CONTRIBUTING.md
├── CHANGELOG.md
├── LICENSE
└── README.md
环境要求
- 已安装并配置 Claude Code CLI
- Python 3.11+（用于
analyze_blog.py质量评分脚本） - 可选：
pip install -r requirements.txt用于高级分析（可读性评分、结构化数据检测）
卸载
Unix/macOS：
chmod +x uninstall.sh && ./uninstall.sh
Windows（PowerShell）：
.\uninstall.ps1
集成
图表生成和 YouTube 视频嵌入为内置功能。Google API 数据需要免费 API 密钥（参见 /blog google setup）。
可选配套技能（用于对已发布页面进行深度分析）：
| 技能 | 集成说明 |
|---|---|
/seo |
对已发布博客页面进行深度 SEO 分析 |
/seo-schema |
结构化数据验证与生成 |
/seo-geo |
AI 引用优化审计 |
/seo-google |
Google API 数据（与 blog-google 共享配置） |
文档
详细文档位于 docs/ 目录：
- 安装指南：Unix、macOS、Windows、手动安装
- 命令参考：完整命令参考及示例
- 架构说明：系统设计与组件概览
- 模板参考：模板参考与自定义说明
- 故障排查：常见问题与解决方案
- MCP 集成：可选 MCP 服务器设置
贡献
欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。
许可证
MIT 许可证。详情请参阅 LICENSE。
由 AgriciDaniel 使用 Claude Code 构建。