📡 Bluesky Campaign Engine

Automated Bluesky campaign scheduling — AT Protocol + Cloudflare D1 + thread chaining

---

What Is This

A production-grade campaign scheduling engine for Bluesky. Schedule multi-post thread campaigns with images, facets (links/mentions/tags), and precise timing — all running serverless on Cloudflare's edge.

Built and battle-tested running real investigative journalism campaigns on Bluesky.

---

Features

• 🧵 Thread Chaining — proper reply chains with root/parent URI tracking
• 🖼️ Image Embedding — automatic image upload + blob attachment
• 🏷️ Facet Support — links, mentions, hashtags auto-detected and encoded
• ⏱️ D1-Based Scheduling — fire at precise times via CF Cron
• 🔒 Fire-Once Lock — D1 state prevents double-posting
• 📦 Campaign Archive — completed campaigns archived, never deleted
• 🌐 REST API — inject campaigns via /inject, check status via /status

---

Architecture

POST /inject (campaign payload)
        │
        ▼
schedule-worker (D1: schedule-db)
        │
CF Cron Trigger (every minute check)
        │
        ▼
bsky-worker ──► AT Protocol API ──► Bluesky
        │
        └── Update D1 (post URIs, CIDs, status)

---

Campaign Payload Format

{
  "campaign_id": "my-campaign-001",
  "handle": "yourhandle.bsky.social",
  "posts": [
    {
      "post_index": 0,
      "text": "🧵 THREAD: My investigation into X...",
      "image_url": "https://example.com/image.jpg",
      "scheduled_at": "2026-05-02T14:00:00Z"
    },
    {
      "post_index": 1,
      "text": "1/ Here's what we found...",
      "scheduled_at": "2026-05-02T14:05:00Z"
    }
  ]
}

---

Self-Hosting

git clone https://github.com/indicaindependent/bsky-campaign-engine
cd bsky-campaign-engine

cp wrangler.toml.example wrangler.toml

wrangler d1 create campaign-db
wrangler secret put BSKY_APP_PASS
wrangler secret put WORKER_SECRET

wrangler deploy

---

Grapheme Safety

All posts are validated against Bluesky's 300-character limit (JS length, not byte count). Flag emoji = 4 chars. Hard ceiling enforced before posting.

---

License

MIT

---

_{Battle-tested on real investigative campaigns | Built by Indica Independent}