gblog - Blogger CLI

通过命令行管理 Blogger 博客。支持发布、编辑、列表查看和监控功能。

快速开始

# 使用 Google 进行身份验证
gblog auth

# 列出您的所有博客
gblog list-blogs

# 列出某博客下的所有文章
gblog list-posts --blog-id YOUR_BLOG_ID

# 创建一篇新文章
gblog post --blog-id YOUR_BLOG_ID --title "My Post" --content ./post.html

# 编辑一篇文章
gblog edit --blog-id YOUR_BLOG_ID --post-id POST_ID --content ./updated.html

# 删除一篇文章
gblog delete --blog-id YOUR_BLOG_ID --post-id POST_ID

配置

1. Google Cloud Console 配置

1. 访问 Google Cloud Console
2. 新建一个项目，或选择已有项目
3. 启用 Blogger API v3
4. 进入 APIs & Services → Credentials
5. 创建 OAuth 2.0 Client ID（选择“Desktop application”类型）
6. 添加重定向 URI：
   • http://localhost:8085/oauth2callback
   • http://localhost:8080/oauth2callback
7. 下载凭据 JSON 文件

2. 本地配置

# 创建配置目录
mkdir -p ~/.config/gblog

# 保存凭据文件
cp ~/Downloads/client_secret_*.json ~/.config/gblog/credentials.json

# 执行身份验证
gblog auth

3. 身份验证流程

首次运行 gblog auth 时，将执行以下操作：

1. 在浏览器中打开 Google OAuth 授权页面
2. 请求 Blogger 相关权限
3. 将刷新令牌（refresh token）保存至 ~/.config/gblog/token.json

命令列表

身份验证

gblog auth                    # 使用 Google 进行身份验证
gblog auth --status          # 检查当前认证状态
gblog auth --logout          # 清除已保存的令牌

博客管理

gblog list-blogs             # 列出您所有的博客
gblog get-blog --id BLOG_ID  # 获取指定博客的详细信息

文章管理

# 列出博客中的文章
gblog list-posts --blog-id BLOG_ID

# 创建文章
gblog post 
  --blog-id BLOG_ID 
  --title "Post Title" 
  --content ./content.html 
  --labels "AI, Tutorial" 
  --draft

# 编辑文章
gblog edit 
  --blog-id BLOG_ID 
  --post-id POST_ID 
  --title "Updated Title" 
  --content ./updated.html

# 删除文章
gblog delete --blog-id BLOG_ID --post-id POST_ID

# 获取文章详情
gblog get-post --blog-id BLOG_ID --post-id POST_ID

监控

# 监控新发布的文章（每 5 分钟轮询一次）
gblog monitor --blog-id BLOG_ID --interval 300

# 获取文章统计信息
gblog stats --blog-id BLOG_ID

HTML 内容格式

文章支持完整的 HTML 格式。示例结构如下：

  
Post Title
  
  
Your content here...
  
  

    
Call to Action
    Subscribe
  

配置文件

环境变量

export GBLOG_CREDENTIALS_PATH=/path/to/credentials.json
export GBLOG_TOKEN_PATH=/path/to/token.json
export GBLOG_DEFAULT_BLOG_ID=your-blog-id

错误处理

常见错误及解决方案：

API 参考

本工具基于 Blogger API v3：

• 基础 URL：https://www.googleapis.com/blogger/v3
• 官方文档：https://developers.google.com/blogger/docs/3.0/reference

脚本文件

• scripts/gblog.py — 主 CLI 入口脚本
• scripts/auth.py — OAuth 身份验证逻辑
• scripts/blogger_api.py — Blogger API 封装层

基于 Google Blogger API v3 构建