social-post

# Social Post

Post to Twitter and/or Farcaster with automatic character limit validation and image upload handling.

## Features

- ✅ **Multi-account support** - manage multiple Twitter accounts from one skill
- ✅ **Auto-variation** - avoid Twitter's duplicate content detection with `--vary` flag
- ✅ Post to Twitter only
- ✅ Post to Farcaster only  
- ✅ Post to both platforms simultaneously
- ✅ **Reply to tweets and casts** - respond to specific posts on both platforms
- ✅ **Draft preview** - shows exactly what will be posted before confirmation
- ✅ Character/byte limit validation
- ✅ Image upload support (for posts and replies)
- ✅ **Thread support** - automatically split long text into numbered posts
- ✅ **Link shortening** - compress URLs using TinyURL (saves characters)
- ✅ Auto-truncate on overflow (optional)

## Platform Limits

- **Twitter:** 252 characters (280 with 10% safety buffer)
- **Farcaster:** 288 bytes (320 with 10% safety buffer)

## Setup & Credentials

### X/Twitter Setup

**Required credentials** (stored in `/home/phan_harry/.openclaw/.env`):
```bash
X_CONSUMER_KEY=your_consumer_key
X_CONSUMER_SECRET=your_consumer_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
X_USERNAME=your_username
X_USER_ID=your_user_id
```

**How to get credentials:**

1. **Apply for X Developer Account**
   - Go to https://developer.twitter.com/en/portal/dashboard
   - Apply for Developer Access
   - Wait for approval (usually 1-2 days)

2. **Enable Consumption-Based Billing**
   - Set up payment method (credit card) in Developer Portal
   - **No subscription tiers** - you pay only for actual API usage
   - Charged per API request (posts, reads, etc.)
   - No monthly minimums or fees

3. **Create an App**
   - In Developer Portal, create a new App
   - Name: "Social Post Bot" (or any name)
   - Set permissions to "Read and Write"

4. **Generate Keys**
   - Consumer Key & Secret: In "Keys and tokens" tab
   - Access Token...

# Social Post

> Post and reply to X/Twitter and Farcaster from one command.

[![Version](https://img.shields.io/badge/version-1.4.0-blue.svg)](CHANGELOG.md)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-skill-orange.svg)](https://openclaw.ai)

**Multi-platform social posting and replying with automatic validation, image uploads, threads, and cost transparency.**

## Features

✅ **Multi-account support** - Manage multiple Twitter accounts from one skill  
✅ **Auto-variation** - Avoid Twitter's duplicate content detection with `--vary` flag  
✅ **Multi-platform posting** - X/Twitter, Farcaster, or both simultaneously  
✅ **Reply support** - Reply to specific tweets and casts with text and images  
✅ **Draft preview** - See exactly what will be posted before confirmation  
✅ **Cost transparency** - Clear pricing for both platforms documented  
✅ **Thread support** - Auto-split long posts into numbered threads  
✅ **Image uploads** - Attach images to posts and replies on both platforms  
✅ **Link shortening** - Compress URLs to save characters  
✅ **Character validation** - Validates limits before posting (252 chars / 288 bytes)  
✅ **Balance monitoring** - Check Farcaster wallet balance anytime  
✅ **Auto-truncate** - Optional automatic text shortening  
✅ **Dry-run mode** - Test without actually posting  

## Table of Contents

- [Features](#features)
- [Quick Reference](#quick-reference)
- [Required Credentials](#required-credentials)
  - [X/Twitter Setup](#xtwitter-setup-)
  - [Farcaster Setup](#farcaster-setup-)
- [Platform Comparison](#platform-comparison)
- [Verify Setup](#verify-setup)
- [Quick Start](#quick-start)
- [Troubleshooting](#troubleshooting)
- [Documentation](#documentation)

## Quick Reference

| Platform | Cost | Credentials Location | Setup Time |
|----------|------|---------------------|------------|
| **X/Twitter** | Pay-per-use (consumption-based) | `~/....