我写了一个 Agent Skill——让博客发布全自动
TL;DR: 博客园支持一个 2002 年的古老 API——MetaWeblog API。我用它给 Claude Code 写了个 Skill，把 Markdown 文章一键发布到博客园，还自带润色检查。
先看效果
npx skills add yuwen773/cnblogs-publisher
在 Claude Code 里说「帮我发布文章到博客园」，它会引导你完成配置和发布。
为什么做这个
写博客的流程：Markdown → 复制粘贴到后台 → 手动上传图片 → 格式经常乱。一套下来 10 分钟起步。
Claude Code 的 Skill 机制出现后，我在想：能不能让它帮我发布？
调研发现：
- 博客园后台有「博客接口」，支持 MetaWeblog API
- 这个 API 2002 年就有了，XML-RPC 协议，古老但稳定
- 支持发布文章、编辑文章、上传图片、获取分类
于是有了 cnblogs-publisher。
技术方案
1. MetaWeblog API 是什么
博客发布协议，2002 年和 WordPress 一起诞生。核心 5 个方法：
| 方法 | 作用 |
|---|---|
metaWeblog.newPost | 发布新文章 |
metaWeblog.editPost | 编辑文章 |
blogger.deletePost | 删除文章 |
metaWeblog.getCategories | 获取分类 |
metaWeblog.newMediaObject | 上传图片 |
博客园完整支持。调用方式：HTTP POST 一个 XML，收到 XML 响应。Python 标准库自带 xmlrpc.client：
from xmlrpc.client import ServerProxyclient = ServerProxy("https://rpc.cnblogs.com/metaweblog/你的用户名")
post = {"title": "文章标题","description": "<p>HTML 正文</p>","dateCreated": "20260407T12:00:00",
}
post_id = client.metaWeblog.newPost(blog_id, username, token, post, True)
2. Markdown → HTML
用户写 Markdown，博客园要 HTML。用 mistune 转换：
import mistunehtml = mistune.html("**粗体** 和 `代码`")
# 输出: <p><strong>粗体</strong> 和 <code>代码</code></p>
mistune 纯 Python，无额外依赖。
3. 配置文件
首次使用提示输入四个信息，之后存到 ~/.cnblogs_config：
api_url="https://rpc.cnblogs.com/metaweblog/你的用户名"
blog_id="xxxxx"
username="你的用户名"
token="xxxxxxxxx"
这个文件在 .gitignore 里，不会被提交。
4. 完整 CLI
# 从文件发布（自动提取标题）
python scripts/publish.py new --file ./post.md --categories "技术,AI"# 直接发布
python scripts/publish.py new --title "标题" --content "内容"# 查看可用分类
python scripts/publish.py categories# 上传图片
python scripts/publish.py upload --file ./screenshot.png# 编辑文章
python scripts/publish.py edit --post-id 12345 --file ./new-post.md# 删除文章
python scripts/publish.py delete --post-id 12345# 最近文章列表
python scripts/publish.py recent --count 10
亮点：发布前润色
在文章真正发出去之前，做两步检查：
Step 0.1 作者署名检查
读取文件，检测署名格式（*by 作者*、**作者**、—— 作者 等）。检测到后询问用户：保留、修改还是删除。
Step 0.2 是否需要润色
"在发布前，是否需要先润色这篇文章？"
如果用户同意，执行：
- 结构调整：按文章类型优化段落顺序
- 语言优化：修正语法、改善表达
- 格式规范化：标题层级、代码块、列表
- TL;DR：超过 1000 字自动添加摘要
- 去除废话：删除"众所周知"、"可以看出"、"标志着"等套话
好处是：发出去的文章格式正确、署名正确，避免事后才发现问题。
代码结构
cnblogs-publisher/
├── SKILL.md # Skill 定义，Claude Code 读取这个
├── scripts/
│ └── publish.py # 核心逻辑，385 行
├── references/
│ └── MetaWeblog.md # API 参考文档
└── assets/└── .cnblogs_config # 用户配置（不提交到 Git）
核心代码一个文件，依赖只有 Python 3 标准库 + mistune。
局限性
- Token 过期：博客园 token 可能过期，报错后删配置重配即可
- 仅支持博客园：其他平台（SegmentFault、简书）需单独适配
- 无批量发布：多篇文章只能多次调用
- 图片依赖博客园：博客园挂了图片就挂了
如何安装
npx skills add yuwen773/cnblogs-publisher
首次使用会提示输入配置：
- api_url:
https://rpc.cnblogs.com/metaweblog/你的用户名 - blog_id: 博客园后台 → 管理 → 设置 → 博客接口 获取
- username: 博客园用户名
- token: 博客园后台获取的密钥
总结
MetaWeblog API 是个被遗忘的技术，但博客园还支持它。有了这个 Skill：
- Markdown 一键转 HTML 发布
- 发布前自动润色检查
- 图片上传、分类管理
如果你也在用博客园，装上试试。如果你想给自己的平台写 Skill，思路一样：找 API、写 CLI、定义 SKILL.md。
Further Reading
- cnblogs-publisher 源码
- skills.sh 上的 cnblogs-publisher
- MetaWeblog API 官方文档
- Claude Code Skill 开发文档
—— yumingwen