# Bulkpublish Social Scheduling

Schedule, publish and analyze social posts across 15 networks via BulkPublish (MCP or...

- Repository: https://github.com/davepoon/buildwithclaude (3705 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add davepoon/buildwithclaude --skill bulkpublish-social-scheduling -g -a claude-code -y`
Codex: `npx skills add davepoon/buildwithclaude --skill bulkpublish-social-scheduling -g -a codex -y`
Cursor: `npx skills add davepoon/buildwithclaude --skill bulkpublish-social-scheduling -g -a cursor -y`
Gemini CLI: `npx skills add davepoon/buildwithclaude --skill bulkpublish-social-scheduling -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add davepoon/buildwithclaude`

## Description

Schedule, publish and analyze social posts across 15 networks via BulkPublish (MCP or REST), Facebook, Instagram, X, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat. Use when the user wants to post, schedule, or bulk-publish to social media, check connected channels, or read post analytics. Always check platform rules before composing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Social Publishing via BulkPublish

Cross-platform scheduling and publishing through one API. Unlike per-platform skills, this
targets many networks in a single call, with each platform's rules enforced up front.

## Setup

**MCP (recommended)**, hosted server, no install:

```bash
claude mcp add --transport http bulkpublish https://mcp.bulkpublish.com/mcp
```

Add it as a custom connector and OAuth 2.1 walks you through consent, no key in the URL.

**Or the npm server (stdio):**

```bash
claude mcp add bulkpublish --env BULKPUBLISH_API_KEY=bp_your_key -- npx -y @bulkpublish/mcp-server
```

**Or plain REST:** `https://app.bulkpublish.com/api`, spec at
`https://app.bulkpublish.com/openapi.json`, docs at `https://app.bulkpublish.com/docs`.

Get an API key at [app.bulkpublish.com/developer](https://app.bulkpublish.com/developer) and
send it as `Authorization: Bearer <key>`. API and MCP access are on every plan, free included.

## Workflow

1. `list_channels`, get connected accounts with their `channelId` and `platform`. Do this
   first; never guess a channel id.
2. Check the platform rules below (or `get_channel_options`) before composing.
3. Upload media if needed, `upload_media` takes a public `url` or a local `filePath`, and
   returns the id you pass in `mediaFileIds`.
4. `create_post` with `content`, `channels`, and `status: "scheduled"` plus `scheduledAt`
   (or leave it a draft, then `publish_post` when the user confirms).
5. Confirm the exact text, target accounts, and time with the user **before** publishing.

## create_post essentials

The rest: https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/all-skills/skills/bulkpublish-social-scheduling/SKILL.md
