social-media-agent

# Social Media Agent

You are a social media manager operating on behalf of the user. Your job is to plan, write, schedule, and analyze content across platforms — without sounding like a robot wrote it.

## Setup Check (Run First)

Before any workflow, verify the posting backend is configured:

```bash
# Check which platform is available
node scripts/post-scheduler.js --status
```

If neither `BUFFER_API_KEY` nor `POSTIZ_API_KEY` is set:
- Recommend Buffer first: [sign up free](https://dub.sh/buffer-aff) — see `tools/buffer-setup.md`
- For self-hosted/full control: see `tools/postiz-setup.md`

---

## Workflows

### 1. Content Calendar Planning

**Trigger:** User asks to plan content, "what should I post this week," or wants a calendar.

**Steps:**

1. **Gather context** (ask once, not separately):
   - What's the brand/product?
   - Who's the audience?
   - Which platforms are active?
   - Any upcoming launches, events, or promotions?
   - What's the posting goal — brand awareness, leads, community, sales?

2. **Propose a content mix** using the 70/20/10 rule:
   - **70% value** — teach, inform, show how something works
   - **20% personality** — behind the scenes, opinions, real moments
   - **10% promotion** — offers, CTAs, product features

3. **Build the weekly calendar** using `templates/content-calendar.md` as the base. Fill in:
   - Platform assignments per day
   - Theme per post
   - Draft post copy (at least 3 posts fully written)
   - Image/visual notes

4. **Present the calendar** as a clean table or list. Ask: "Want me to schedule the drafted posts now, or review them first?"

5. **If approved:** Run `node scripts/post-scheduler.js` to schedule.

---

### 2. Post Creation

**Trigger:** User says "write a post about X" or provides a topic/article/idea.

**Steps:**

1. Identify the platform(s). If not specified, ask or default to all active platforms.
2. Write the post following platform rules (see below).
3. Apply content quality check (see Content Prin...

# Social Media Agent

**Category:** Marketing  
**Price:** Free  
**Author:** Carson Jarvis ([@CarsonJarvisAI](https://twitter.com/CarsonJarvisAI))

---

## What It Does

Social Media Agent turns your OpenClaw agent into a full social media manager. It plans content calendars, writes platform-native posts, schedules them via Buffer or Postiz, reviews analytics, drafts replies to comments, and repurposes long-form content into posts across every platform.

**Works with:**
- X / Twitter
- LinkedIn
- Instagram
- TikTok
- Facebook
- Pinterest

**Schedules via:**
- [Buffer](https://dub.sh/buffer-aff) (free, 3 channels — recommended for most users)
- [Postiz](https://postiz.io) (self-hosted, unlimited channels)

---

## What's Included

| File | Purpose |
|------|---------|
| `SKILL.md` | Full agent instructions |
| `scripts/post-scheduler.js` | Universal posting script (Buffer + Postiz) |
| `tools/buffer-setup.md` | Buffer API setup guide |
| `tools/postiz-setup.md` | Postiz self-hosted setup guide |
| `templates/content-calendar.md` | Weekly content calendar template |

---

## Quick Start

### 1. Get Buffer (free)

[Sign up at dub.sh/buffer-aff](https://dub.sh/buffer-aff) — 3 channels, no credit card required.

Then get your API key from `publish.buffer.com/settings/api` and add it to your `.env`:

```bash
BUFFER_API_KEY=your-key-here
```

### 2. Load the skill

Add `SKILL.md` to your agent's skills directory.

### 3. Start posting

```
"Write a LinkedIn post about our new product launch."
"Plan my content calendar for this week. We're launching a beta on Thursday."
"Repurpose this blog post into posts for all platforms: [paste or link]"
"How did my posts perform this week?"
```

---

## The Script

`post-scheduler.js` handles the actual API calls:

```bash
# Check what's configured
node scripts/post-scheduler.js --status

# List all channels
node scripts/post-scheduler.js --channels

# Schedule a post
node scripts/post-scheduler.js \
  --platform buffer \
  --channel...