Skip to main content
Blog to subreddit sync copies full blog posts into Reddit-ready workspace posts and can queue them for Reddit publishing. The sync is configured per workspace and does not require per-company environment variables. Use this workflow when a customer provides:
  • A blog URL, RSS feed, sitemap, or blog index URL
  • A destination subreddit
  • An approved Reddit persona with a working browser session

​
Configuration Model

Each sync config belongs to a workspace and stores:
FieldPurpose
blog_urlBlog index, feed, sitemap, or landing page to crawl
subredditDestination subreddit, with or without r/
persona_idOptional preferred persona; otherwise an active auth-completed persona is selected
include_mediaExtract inline images and render them into Reddit richtext
activeAllows daily cron runs and publishing eligibility
publish_immediatelyQueues synced posts for publishing when the config is active
For Cube, the verified config is: 
workspace: cube-dev
config_id: 1
blog_url: https://cube.dev/blog
subreddit: r/cubedev
Cube can be verified in non-public mode before launch, or in live mode after posts have already been published.

​
API-First Flow

Create or update a config: 
POST /api/v1/actions/blog-subreddit-syncs
Run a non-mutating preview: 
POST /api/v1/actions/blog-subreddit-syncs/:id/run
{
  "dry_run": true,
  "max_posts": 3
}
Run a real sync that writes drafts but does not publish: 
POST /api/v1/actions/blog-subreddit-syncs/:id/run
{
  "publish": false,
  "max_posts": 3
}
Check Reddit readiness without public posting: 
POST /api/v1/actions/blog-subreddit-syncs/:id/readiness
{
  "max_posts": 1,
  "persona_id": 238,
  "verify_media_upload": false
}
persona_id is optional. Use it to verify a specific workspace account without changing the sync config. If the requested persona is not active, auth-completed, and browser-ready, the API fails instead of falling back. verify_media_upload=true uploads Reddit media assets during preflight. Use it only when a human explicitly asks to verify media uploads.

​
MCP Flow

MCP clients should use the same API actions in this order:
  1. get_blog_subreddit_syncs
  2. post_blog_subreddit_syncs_id_run with dry_run=true
  3. post_blog_subreddit_syncs_id_readiness
  4. post_blog_subreddit_syncs_id_publish_preflight only for a selected synced post
Do not run browser-backed checks concurrently. GoLogin can perform only one cloud browser operation at a time for a workspace API key.

​
One-Command Cube Acceptance

Run the non-public Cube acceptance verifier: 
npm run verify:blog-subreddit-sync:cube -- \
  --workspace cube-dev \
  --config-id 1 \
  --blog-url https://cube.dev/blog \
  --subreddit cubedev \
  --max-posts 1 \
  --persona-id 238
The verifier checks:
  • TypeScript
  • Full-content dry-run discovery
  • Media extraction
  • Mid-sync config-change abort behavior
  • Production HTTP API behavior with temporary read/write keys
  • Reddit readiness through one GoLogin-backed browser session
  • Banned persona exclusion
  • Final database cleanup state
The default command does not submit a Reddit post and does not upload Reddit media assets. --persona-id is optional; when provided, the verifier uses that workspace persona for browser-backed readiness through the API and fails if the account is not active, auth-completed, and browser-ready. Use --allow-published when verifying a config that has already completed live publishing.

​
GoLogin Limit

GoLogin is serialized per workspace API key. The Cube verifier therefore uses one GoLogin-backed readiness check by default. Do not run these at the same time for the same workspace:
  • Blog sync readiness
  • Blog sync publish preflight
  • Persona OAuth preflight
  • Any other Reddit browser automation using the same GoLogin API key
To also run the separate non-public live publish preflight, use: 
npm run verify:blog-subreddit-sync:cube -- --include-live-preflight
Only run that when no other GoLogin-backed job is active.

​
Public Publish Gate

Public Reddit submission requires explicit human approval. The live publish verifier will not publish unless called with: 
npm run verify:blog-subreddit-sync:live -- \
  --workspace cube-dev \
  --config-id 1 \
  --persona-id 238 \
  --confirm-live-reddit-post
Before using that flag, confirm:
  • The selected synced post is approved
  • The destination subreddit is correct
  • The persona is approved for the customer
  • The config is active and publish_immediately=true
  • No other GoLogin-backed job is running for the same workspace

​
Destination Changes During Sync

The sync fingerprints the config before each run. If the blog URL, subreddit, persona, active state, media setting, publish mode, or max-post setting changes while a run is active, the run aborts before writing or queueing more posts. Queued publish tasks also carry the config fingerprint. If the destination changes before publishing, the task is skipped and the synced item returns to draft state.

​
Expected Cube Acceptance State

After a live acceptance run with --allow-published, Cube should have no queued or failed sync items and should retain media-bearing published items. Before live publishing, a non-public acceptance run should leave published posts: 0. 
temp API keys: 0
queued posts: 0
failed sync items: 0
media-bearing items: 3
config last_error: null