# AI博客创作技能 `博客` `AI写作` `SEO` `Claude Code` `内容管理` # claude-blog - Claude Code 的 AI 博客创作技能 ![Claude Blog - AI驱动的博客创作](assets/header.jpeg) [![CI](https://github.com/AgriciDaniel/claude-blog/actions/workflows/ci.yml/badge.svg)](https://github.com/AgriciDaniel/claude-blog/actions/workflows/ci.yml) [![GitHub release](https://img.shields.io/github/v/release/AgriciDaniel/claude-blog)](https://github.com/AgriciDaniel/claude-blog/releases/latest) ![Claude Code Skill](https://img.shields.io/badge/Claude_Code-Skill-blueviolet) ![License: MIT](https://img.shields.io/badge/License-MIT-green) ![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-blue) ![Sub-Skills](https://img.shields.io/badge/Sub--Skills-22-orange) > **博客：** [了解 claude-blog 的工作原理](https://agricidaniel.com/blog/claude-code-blog-writer) claude-blog 是一个 Claude Code 技能生态系统，用于大规模创建、优化和管理博客内容。它能生成完整文章、内容简报、编辑日历和结构化数据，同时针对 Google 排名和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）进行双重优化。 ## 目录 - [演示](#演示) - [快速开始](#快速开始) - [命令](#命令) - [功能](#功能) - [架构](#架构) - [环境要求](#环境要求) - [卸载](#卸载) - [集成](#集成) - [文档](#文档) - [贡献](#贡献) - [许可证](#许可证) ## 演示 [在 YouTube 上观看演示](https://www.youtube.com/watch?v=AeLC4iutG8w) ![博客命令演示](assets/blog-command-demo.gif) --- ## 快速开始 **插件安装（Claude Code 1.0.33+）：** ```bash # 添加插件市场（一次性操作） /plugin marketplace add AgriciDaniel/claude-blog # 安装插件 /plugin install claude-blog@AgriciDaniel-claude-blog ``` **一键安装（Unix/macOS）：** ```bash curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/install.sh | bash ``` **或克隆后手动安装：** ```bash git clone https://github.com/AgriciDaniel/claude-blog.git cd claude-blog chmod +x install.sh && ./install.sh ``` **Windows（PowerShell）：** ```powershell .\install.ps1 ``` 安装后重启 Claude Code 以激活。 ## 命令 ![博客写作命令演示](assets/blog-write-demo.gif) | 命令 | 说明 | |---------|-------------| | `/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](https://docs.anthropic.com/en/docs/claude-code) CLI - Python 3.11+（用于 `analyze_blog.py` 质量评分脚本） - 可选：`pip install -r requirements.txt` 用于高级分析（可读性评分、结构化数据检测） ## 卸载 Unix/macOS： ```bash chmod +x uninstall.sh && ./uninstall.sh ``` Windows（PowerShell）： ```powershell .\uninstall.ps1 ``` ## 集成 图表生成和 YouTube 视频嵌入为内置功能。Google API 数据需要免费 API 密钥（参见 `/blog google setup`）。 **可选配套技能**（用于对已发布页面进行深度分析）： | 技能 | 集成说明 | |-------|-------------| | `/seo` | 对已发布博客页面进行深度 SEO 分析 | | `/seo-schema` | 结构化数据验证与生成 | | `/seo-geo` | AI 引用优化审计 | | `/seo-google` | Google API 数据（与 blog-google 共享配置） | ## 文档 详细文档位于 [docs/](docs/) 目录： - [安装指南](docs/INSTALLATION.md)：Unix、macOS、Windows、手动安装 - [命令参考](docs/COMMANDS.md)：完整命令参考及示例 - [架构说明](docs/ARCHITECTURE.md)：系统设计与组件概览 - [模板参考](docs/TEMPLATES.md)：模板参考与自定义说明 - [故障排查](docs/TROUBLESHOOTING.md)：常见问题与解决方案 - [MCP 集成](docs/MCP-INTEGRATION.md)：可选 MCP 服务器设置 ## 贡献 欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。 ## 许可证 MIT 许可证。详情请参阅 [LICENSE](LICENSE)。 --- 由 [AgriciDaniel](https://github.com/AgriciDaniel) 使用 Claude Code 构建。