claude-blog全站博客审计指南:/blog audit一键生成网站健康度综合评估报告
【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blog
claude-blog 是面向 Claude Code 的开源博客技能套件,内置 30+ 子技能与 5 个专业代理。其中的/blog audit命令可对全站博客执行一键健康度审计,自动扫描质量评分、孤儿页面、关键词内耗与过时内容,最终生成一份带优先级行动队列的网站健康度综合评估报告,帮助新手快速定位并修复博客问题。
什么是 claude-blog 博客审计功能
简单来说,/blog audit就像给你的整个博客做一次"全面体检":
- 逐篇打分:每篇文章按 100 分制评分(内容、SEO、E-E-A-T、技术、AI 引用就绪)
- 发现问题:找出孤儿页面、死胡同页面、互相竞争关键词的文章、过时的旧文
- 给出方案:按"分数从低到高"排出行动队列,告诉你先修哪篇、怎么修
审计逻辑定义在 skills/blog-audit/SKILL.md 中,完整命令速查表见 docs/COMMANDS.md。下面是/blog命令在 Claude Code 中运行的演示:
快速安装:3 步上手
前置要求:已安装 Claude Code CLI,并装有 Python 3.11+(评分脚本依赖)。完整说明见 docs/INSTALLATION.md。
1️⃣ 克隆仓库:
git clone https://gitcode.com/gh_mirrors/cl/claude-blog cd claude-blog2️⃣ 运行一键安装脚本(install.sh):
chmod +x install.sh ./install.sh脚本会自动把所有技能、代理和评分脚本安装到~/.claude/对应目录,并尝试安装 Python 依赖。
3️⃣ 重启 Claude Code,进入你的博客项目目录,即可使用/blog系列命令。
/blog audit 审计流程:7 步生成健康度报告
在 Claude Code 中输入以下任一指令即可开始:
/blog audit /blog audit content/blog/ /blog audit posts/ --format markdown整个审计过程分为 7 个步骤,全部自动完成:
1. 自动发现博客文件
递归扫描content/、posts/、blog/、src/content/、_posts/等常见博客目录,自动过滤node_modules/、.git/、构建产物等无关路径,并报告"共发现 N 篇博客文章"。
2. 批量质量评分(核心)
调用官方分析脚本 scripts/analyze_blog.py 进行标准化批量分析:
python3 scripts/analyze_blog.py <blog-root> --batch --format json每篇文章按 100 分制打分,五个维度一目了然:
| 评分维度 | 满分 | 考察内容 |
|---|---|---|
| 内容质量 | 30 | 覆盖度、可读性、结构、原创性 |
| SEO 优化 | 25 | 标题、H1、关键词、内链、Meta、URL |
| E-E-A-T 信号 | 15 | 作者信息、引用来源、可信度 |
| 技术元素 | 15 | Schema、图片、结构化数据 |
| AI 引用就绪 | 15 | 证据支撑、实体清晰度、爬虫访问 |
分数区间参考:90+ 优秀 / 80-89 良好 / 70-79 及格 / 60-69 待改进 / <60 建议重写。
3. 关键词内耗检测(Topic Cannibalization)
从每篇文章的标题、H1、Meta 描述和首段中提取主题关键词,识别"多篇文章抢同一个关键词"的情况,并给出三种处理建议:
- Merge(合并):把两篇弱文合成一篇强文
- Redirect(重定向):弱文 301 到强文
- Differentiate(差异化):调整各自定位,避免互相竞争
4. 孤儿页面检测
构建全站内部链接图,找出两类"断链"页面:
- 孤儿页面:没有任何其他文章链接指向它(搜索引擎很难发现)
- 死胡同页面:它不链接到任何其他文章
对每个孤儿页面,审计会推荐 2-3 篇主题相关的文章来建立反链。
5. 内容过时检测
读取每篇文章 frontmatter 中的lastUpdated/dateModified,计算距上次更新的天数,并按刷新优先级分类:
- 高:主题时效性强、引用数据陈旧,或搜索表现下滑
- 中:常青内容但示例/链接/截图老化
- 低:近期已验证或稳定参考类内容
同时估算刷新工作量(轻刷新 1-2 小时 / 中度 3-4 小时 / 重度重写 5 小时+)。
6. 技术爬取与 AI 引用就绪检查
在最终建议前,还会做整站技术体检:sitemap 覆盖、robots.txt、noindex 指令、canonical 标签、重定向、hreflang 等;并检查 GPTBot、ClaudeBot、PerplexityBot 等 AI 爬虫的访问策略。若配置了 Google 凭据,可进一步调用/blog google获取 Core Web Vitals 与 GSC 数据;未配置时相关项会标记SKIPPED: credentials unavailable,不影响其余审计。
7. 生成并保存审计报告
所有结果汇总为一份综合报告,自动保存到项目下的reports/目录:
reports/blog-audit-YYYY-MM-DD.md reports/blog-audit-YYYY-MM-DD.json📌 注意:每次审计生成带日期的新文件,不会覆盖之前的报告,方便对比历次体检结果。
读懂审计报告:4 个关键区块
报告生成后,重点看这四张表:
| 区块 | 看什么 |
|---|---|
| 总览仪表盘 | 文章总数、平均分、各分数段分布、孤儿页面/内耗/过时内容数量 |
| 逐篇评分表 | 每篇文章的五维得分与问题数 |
| 优先级行动队列 | 按分数从低到高排列,标明"先修哪篇 + 修什么" |
| 内耗/孤儿/过时明细 | 每个问题对应的具体处理建议(合并/重定向/补内链/刷新) |
审计之后:推荐的后续动作
审计完成后,claude-blog 会自动给出下一步建议:
- 对分数最低的文章运行
/blog analyze <文件>做单篇深度分析 - 对重点文章运行
/blog flow optimize做 AI 引用与 SEO 专项检查 - 用
/blog rewrite <文件>自动应用修复,或/blog calendar把审计发现排进内容日历
常见问题
Q:我的博客文件不在标准目录,能审计吗?A:可以。直接/blog audit 你的目录指定内容目录即可;若标准路径下没找到文件,审计会请求你确认允许扫描的根目录,而不会默认扫描整个项目。
Q:audit 和 analyze 有什么区别?A:/blog analyze是单篇(或目录)质量评分,/blog audit是全站体检——在评分基础上额外做内耗检测、孤儿页面、过时内容和技术检查,适合定期整站体检。
Q:必须配置 Google API 才能审计吗?A:不是。Google 相关检查属于可选项,未配置凭据时自动跳过并注明原因,核心审计完全本地完成。
小结
/blog audit把整站博客体检变成了"一条命令":自动发现文章、逐篇百分制打分、揪出孤儿页面和关键词内耗、标记过时内容,最后输出一份按优先级排序的网站健康度综合评估报告。配合 claude-blog 的 rewrite、calendar 等子技能,从发现问题到修复排期都能一站式完成——对新手和个人博主来说,这是提升博客 SEO 与 AI 引用表现最省力的起点。
【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blog
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考