项目背景

写博客这么多年，一直在找一种方式让 AI 能直接帮我管理内容。市面上有不少方案，但要么太重（WordPress REST API），要么跟 Typecho 这种轻量博客不兼容。

Typecho Agent API 就是为解决这个问题诞生的——一个纯 HTTP 接口的博客控制平面，专门给 LLM Agent 调用。

核心能力

项目提供 14 个 HTTP 工具，覆盖博客管理的全部场景：

文章管理

• 新增文章 — POST /v1/posts，支持标题/正文（HTML/Markdown）/标签/分类/自定义字段
• 编辑文章 — PATCH /v1/posts/{cid}，局部更新，只传要改的字段
• 删除文章 — DELETE /v1/posts/{cid}，物理删除，同步清理关联
• 列表/搜索 — GET /v1/posts，分页/状态筛选/关键词搜索

分类与标签

• 完整的分类/标签增删查
• 支持 slug、描述、层级（子分类）

图片管理

• 上传图片到腾讯云 COS（支持 base64 和 multipart）
• 返回 CDN URL，直接在文章里引用
• 支持删除 COS 上的文件

架构设计

+------------------+   HTTP + X-API-Key    +-----------------------------+
|  LLM Agent       | --------------------> |  typecho-agent-api 服务     |
|  (Hermes/OpenAI) | <-------------------- |  - 直读 typecho_* MySQL    |
|  不需要装任何东西  |                      |  - 调腾讯云 COS             |
+------------------+                        +-----------------------------+

关键设计决策：

• Agent 端零依赖 — 只配 2 个环境变量，不装任何 Python 包
• 服务端独立部署 — 跑在 Typecho 服务器上，不修改 Typecho 本身
• Key 鉴权 — X-API-Key 预共享密钥，不走 OAuth 等复杂流程
• OpenAI 兼容 — 提供完整的 function-calling schema，任何 LLM 框架都能用

技术栈

AI Agent 使用示例

用 curl 发一篇文章：

curl -X POST "$TYPECHO_API_BASE_URL/v1/posts" \
  -H "X-API-Key: $TYPECHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "文章标题", "content": "<p>正文</p>", "tags": ["tag1"], "status": "publish"}'

上传配图：

curl -X POST "$TYPECHO_API_BASE_URL/v1/images/upload_base64" \
  -H "X-API-Key: $TYPECHO_API_KEY" \
  -d '{"base64_data":"<BASE64>","filename":"cover.png"}'

快速部署

git clone https://github.com/chapaofan/typecho-server-and-skill
cd typecho-server-and-skill
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env：Typecho 数据库连接、COS 密钥、API Key
python run.py

生产环境建议：

gunicorn -w 2 -b 0.0.0.0:8000 run:app

应用场景

• AI 写作助手直接发布文章到博客
• 自动从 Obsidian/Notion 同步内容到 Typecho
• 批量管理文章（标签分类、状态调整）
• 在聊天机器人里创建/编辑/删除博客内容

开源地址

项目完全开源：github.com/chapaofan/typecho-server-and-skill

欢迎 Star、Fork、提 Issue。如果你有 Typecho 也想接 AI，这个项目可以直接用。