typefully

# Typefully Skill

Manage Typefully drafts via the v2 API.

## Setup

1. Set your API key via **one of**:
   - Environment variable: `export TYPEFULLY_API_KEY=your-key`
   - Password store: `pass insert typefully/api-key`
2. (Optional) Set your social set ID:
   - Environment variable: `export TYPEFULLY_SOCIAL_SET_ID=123456`
   - Password store: `pass insert typefully/social-set-id`
   - If not set, the script auto-detects (errors if multiple accounts exist — use `list-social-sets` to find yours)
3. Enable "Development mode" in Typefully **Settings → API** to see draft IDs in the UI.

## Script Usage

```bash
bash scripts/typefully.sh <command> [options]
```

### Commands

| Command | Description |
|---------|-------------|
| `list-drafts [status] [limit]` | List drafts. Status: `draft`, `scheduled`, `published` (default: all). Limit default: 10. |
| `create-draft <text> [--thread] [--platform x,linkedin,...] [--schedule <iso8601\|next-free-slot>]` | Create a draft. For threads, separate posts with `\n---\n`. Use `-` or omit text to read from stdin. Default platform: x. |
| `get-draft <draft_id>` | Get a single draft with full details. |
| `edit-draft <draft_id> <text> [--thread] [--platform x,linkedin]` | Update draft content. Supports `--thread` for thread editing. |
| `schedule-draft <draft_id> <iso8601\|next-free-slot\|now>` | Schedule or publish a draft. |
| `delete-draft <draft_id>` | Delete a draft. |
| `list-social-sets` | List available social sets (accounts). |

### Examples

**Create a simple tweet draft:**
```bash
bash scripts/typefully.sh create-draft "Just shipped a new feature 🚀"
```

**Create a thread:**
```bash
bash scripts/typefully.sh create-draft "First tweet of the thread\n---\nSecond tweet\n---\nThird tweet" --thread
```

**Create a thread from stdin (for longer content):**
```bash
cat <<'EOF' | bash scripts/typefully.sh create-draft - --thread
First tweet of the thread\n---\nSecond tweet\n---\nThird tweet with the punchline
EOF
```

**Create...

# Typefully Skill for OpenClaw

Create, schedule, and manage [Typefully](https://typefully.com) drafts from your AI agent. Supports single tweets, threads, and multi-platform posts (X, LinkedIn, Threads, Bluesky, Mastodon).

## Prerequisites

- **curl** — HTTP client
- **python3** — used for JSON escaping
- **pass** (optional) — [Unix password store](https://www.passwordstore.org/) for API key/config. Not needed if using environment variables.

## Setup

1. Get your Typefully API key from **Settings → API** in Typefully
2. Provide it via **one of**:
   - Environment variable: `export TYPEFULLY_API_KEY=your-key`
   - Password store: `pass insert typefully/api-key`
3. Install the skill:
   ```bash
   clawhub install typefully --dir ~/.openclaw/skills
   ```

## Usage

```bash
bash scripts/typefully.sh <command> [options]
```

See [SKILL.md](SKILL.md) for the full command reference and examples.

### Quick Examples

```bash
# Simple tweet
bash scripts/typefully.sh create-draft "Just shipped a new feature 🚀"

# Thread
bash scripts/typefully.sh create-draft "First tweet\n---\nSecond tweet" --thread

# Cross-platform
bash scripts/typefully.sh create-draft "Big announcement!" --platform x,linkedin

# Schedule
bash scripts/typefully.sh create-draft "Morning thoughts ☀️" --schedule "2026-03-01T09:00:00Z"

# List drafts
bash scripts/typefully.sh list-drafts draft 5
```

## Environment Variables

| Variable | Description |
|----------|-------------|
| `TYPEFULLY_API_KEY` | **(Required)** API key (fallback: `pass typefully/api-key`) |
| `TYPEFULLY_SOCIAL_SET_ID` | *(Optional)* Social set ID — auto-detected if you have one account (fallback: `pass typefully/social-set-id`) |

## License

MIT