Breakreach developer and agent kit
Everything to use Breakreach from code and from AI agents: schedule and publish social media posts to Instagram, TikTok, X, LinkedIn, YouTube, Facebook, Threads, Pinterest, Bluesky, Reddit, Telegram, Discord, Slack, Mastodon, WordPress, Ghost, Dev.to, Hashnode and Tumblr.
| Install | |
|---|
| TypeScript SDK + CLI | npm install breakreach · npx breakreach post … | Node 18+, no dependencies |
| Python SDK | pip install breakreach | Python 3.9+, standard library only |
| Agent skill | npx skills add breakreach/breakreach | Claude Code, Codex, Cursor, OpenClaw and other agents that read SKILL.md |
| Claude Code plugin (skill + MCP server) | claude plugin marketplace add breakreach/breakreach then claude plugin install breakreach@breakreach | |
| MCP server | https://api.breakreach.com/mcp | hosted, OAuth; setup per client |
The SDKs are generated from the OpenAPI spec the API serves (a copy is in openapi.json), so every endpoint has a typed method. Both retry network errors and restarts with an Idempotency-Key on each POST: a retry never publishes a post twice.
import { Breakreach } from "breakreach";
const br = new Breakreach(); // BREAKREACH_API_KEY
const { accounts } = await br.listAccounts();
await br.createPost({ content: "Out tomorrow.", accountIds: accounts.map((a) => a.id), useNextSlot: true });
npx breakreach login
npx breakreach post "Out tomorrow." --to instagram,linkedin --media ./launch.jpg --next-slot
An API key comes from Breakreach, Settings → API & MCP. Docs: breakreach.com/developers.
Working on it
npx tsx scripts/generate.mts # after an API change: types, methods and README tables from the spec
npx tsx scripts/generate.mts --check # fails when the generated files are out of date
cd typescript && npm install && npm run build
In the Breakreach monorepo the generator reads the spec from apps/api/src/lib/openapi.ts; elsewhere from openapi.json, or --spec https://api.breakreach.com/v1/openapi.json. scripts/e2e.sh (monorepo only) drives both SDKs and the CLI against the real API code on a local database. Releasing: RELEASING.md.
MIT licensed.
