\r \r

gblog - Blogger CLI\r

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

Quick Start\r

\r

# Authenticate with Google\r
gblog auth\r
\r
# List your blogs\r
gblog list-blogs\r
\r
# List posts from a blog\r
gblog list-posts --blog-id YOUR_BLOG_ID\r
\r
# Create a new post\r
gblog post --blog-id YOUR_BLOG_ID --title "My Post" --content ./post.html\r
\r
# Edit a post\r
gblog edit --blog-id YOUR_BLOG_ID --post-id POST_ID --content ./updated.html\r
\r
# Delete a post\r
gblog delete --blog-id YOUR_BLOG_ID --post-id POST_ID\r
```\r
\r
## Setup\r
\r
### 1. Google Cloud Console Setup\r
\r
1. Go to [Google Cloud Console](https://console.cloud.google.com/)\r
2. Create a project or select existing\r
3. Enable **Blogger API v3**\r
4. Go to **APIs & Services → Credentials**\r
5. Create **OAuth 2.0 Client ID** (Desktop application type)\r
6. Add redirect URIs:\r
   - `http://localhost:8085/oauth2callback`\r
   - `http://localhost:8080/oauth2callback`\r
7. Download credentials JSON\r
\r
### 2. Local Setup\r
\r
```bash\r
# Create config directory\r
mkdir -p ~/.config/gblog\r
\r
# Save credentials\r
cp ~/Downloads/client_secret_*.json ~/.config/gblog/credentials.json\r
\r
# Run authentication\r
gblog auth\r
```\r
\r
### 3. Authentication\r
\r
The first time you run `gblog auth`, it will:\r
1. Open a browser for Google OAuth\r
2. Request permissions for Blogger\r
3. Save refresh token to `~/.config/gblog/token.json`\r
\r
## Commands\r
\r
### Authentication\r
```bash\r
gblog auth                    # Authenticate with Google\r
gblog auth --status          # Check auth status\r
gblog auth --logout          # Clear saved tokens\r
```\r
\r
### Blog Management\r
```bash\r
gblog list-blogs             # List all your blogs\r
gblog get-blog --id BLOG_ID  # Get blog details\r
```\r
\r
### Post Management\r
```bash\r
# List posts\r
gblog list-posts --blog-id BLOG_ID\r
\r
# Create post\r
gblog post \\r
  --blog-id BLOG_ID \\r
  --title "Post Title" \\r
  --content ./content.html \\r
  --labels "AI, Tutorial" \\r
  --draft\r
\r
# Edit post\r
gblog edit \\r
  --blog-id BLOG_ID \\r
  --post-id POST_ID \\r
  --title "Updated Title" \\r
  --content ./updated.html\r
\r
# Delete post\r
gblog delete --blog-id BLOG_ID --post-id POST_ID\r
\r
# Get post\r
gblog get-post --blog-id BLOG_ID --post-id POST_ID\r
```\r
\r
### Monitoring\r
```bash\r
# Monitor new posts (poll every 5 minutes)\r
gblog monitor --blog-id BLOG_ID --interval 300\r
\r
# Get post statistics\r
gblog stats --blog-id BLOG_ID\r
```\r
\r
## HTML Content Format\r
\r
Posts support full HTML. Example structure:\r
\r
```html\r
\x3Cdiv style="font-family: Arial, sans-serif; line-height: 1.8;">\r
  \x3Ch1 style="color: #27ae60;">Post Title\x3C/h1>\r
  \r
  \x3Cp>Your content here...\x3C/p>\r
  \r
  \x3Cdiv style="background: #f5f5f5; padding: 20px; border-radius: 8px;">\r
    \x3Ch3>Call to Action\x3C/h3>\r
    \x3Ca href="...">Subscribe\x3C/a>\r
  \x3C/div>\r
\x3C/div>\r
```\r
\r
## Configuration Files\r
\r
| File | Purpose |\r
|------|---------|\r
| `~/.config/gblog/credentials.json` | OAuth client credentials |\r
| `~/.config/gblog/token.json` | Saved access/refresh tokens |\r
| `~/.config/gblog/config.json` | User preferences |\r
\r
## Environment Variables\r
\r
```bash\r
export GBLOG_CREDENTIALS_PATH=/path/to/credentials.json\r
export GBLOG_TOKEN_PATH=/path/to/token.json\r
export GBLOG_DEFAULT_BLOG_ID=your-blog-id\r
```\r
\r
## Error Handling\r
\r
Common errors and solutions:\r
\r
| Error | Solution |\r
|-------|----------|\r
| `invalid_grant` | Run `gblog auth` again |\r
| `insufficient_permissions` | Check Blogger API is enabled |\r
| `blog not found` | Verify blog ID is correct |\r
| `rate limit exceeded` | Wait 60 seconds and retry |\r
\r
## API Reference\r
\r
Uses Blogger API v3:\r
- Base URL: `https://www.googleapis.com/blogger/v3`\r
- Documentation: https://developers.google.com/blogger/docs/3.0/reference\r
\r
## Scripts\r
\r
- `scripts/gblog.py` - Main CLI script\r
- `scripts/auth.py` - OAuth authentication\r
- `scripts/blogger_api.py` - API wrapper\r
\r
---\r
*Powered by Google Blogger API v3*\r