gblog - Blogger CLI

Manage Blogger blogs via command line. Supports posting, editing, listing, and monitoring.

Quick Start

# Authenticate with Google
gblog auth

# List your blogs
gblog list-blogs

# List posts from a blog
gblog list-posts --blog-id YOUR_BLOG_ID

# Create a new post
gblog post --blog-id YOUR_BLOG_ID --title "My Post" --content ./post.html

# Edit a post
gblog edit --blog-id YOUR_BLOG_ID --post-id POST_ID --content ./updated.html

# Delete a post
gblog delete --blog-id YOUR_BLOG_ID --post-id POST_ID

Setup

1. Google Cloud Console Setup

1. Go to Google Cloud Console
2. Create a project or select existing
3. Enable Blogger API v3
4. Go to APIs & Services → Credentials
5. Create OAuth 2.0 Client ID (Desktop application type)
6. Add redirect URIs:
   • http://localhost:8085/oauth2callback
   • http://localhost:8080/oauth2callback
7. Download credentials JSON

2. Local Setup

# Create config directory
mkdir -p ~/.config/gblog

# Save credentials
cp ~/Downloads/client_secret_*.json ~/.config/gblog/credentials.json

# Run authentication
gblog auth

3. Authentication

The first time you run gblog auth, it will:

1. Open a browser for Google OAuth
2. Request permissions for Blogger
3. Save refresh token to ~/.config/gblog/token.json

Commands

Authentication

gblog auth                    # Authenticate with Google
gblog auth --status          # Check auth status
gblog auth --logout          # Clear saved tokens

Blog Management

gblog list-blogs             # List all your blogs
gblog get-blog --id BLOG_ID  # Get blog details

Post Management

# List posts
gblog list-posts --blog-id BLOG_ID

# Create post
gblog post \
  --blog-id BLOG_ID \
  --title "Post Title" \
  --content ./content.html \
  --labels "AI, Tutorial" \
  --draft

# Edit post
gblog edit \
  --blog-id BLOG_ID \
  --post-id POST_ID \
  --title "Updated Title" \
  --content ./updated.html

# Delete post
gblog delete --blog-id BLOG_ID --post-id POST_ID

# Get post
gblog get-post --blog-id BLOG_ID --post-id POST_ID

Monitoring

# Monitor new posts (poll every 5 minutes)
gblog monitor --blog-id BLOG_ID --interval 300

# Get post statistics
gblog stats --blog-id BLOG_ID

HTML Content Format

Posts support full HTML. Example structure:

<div style="font-family: Arial, sans-serif; line-height: 1.8;">
  <h1 style="color: #27ae60;">Post Title</h1>
  
  <p>Your content here...</p>
  
  <div style="background: #f5f5f5; padding: 20px; border-radius: 8px;">
    <h3>Call to Action</h3>
    <a href="...">Subscribe</a>
  </div>
</div>

Configuration Files

File	Purpose
~/.config/gblog/credentials.json	OAuth client credentials
~/.config/gblog/token.json	Saved access/refresh tokens
~/.config/gblog/config.json	User preferences

Environment Variables

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

Error Handling

Common errors and solutions:

Error	Solution
invalid_grant	Run gblog auth again
insufficient_permissions	Check Blogger API is enabled
blog not found	Verify blog ID is correct
rate limit exceeded	Wait 60 seconds and retry

API Reference

Uses Blogger API v3:

• Base URL: https://www.googleapis.com/blogger/v3
• Documentation: https://developers.google.com/blogger/docs/3.0/reference

Scripts

• scripts/gblog.py - Main CLI script
• scripts/auth.py - OAuth authentication
• scripts/blogger_api.py - API wrapper

---

Powered by Google Blogger API v3