Appearance
Social Platform Extensions
FreshSource: BIBLE.md (Phase 7-9 social engagement plugins, platform-factory)
18 platform adapters built from one factory (_social/platform-factory.mjs). Each adapter exposes a uniform interface: login, post, comment, like, follow, execute, plus routes.
Platform list
| Platform | Module | Notes |
|---|---|---|
reddit-extension | Karma warming (cold/lukewarm/warm), subreddit discovery, post types | |
linkedin-extension | Posts, articles, images, polls, connections | |
facebook-extension | Page management, post scheduling, audience insights | |
instagram-extension | Stories (24h), reels, feed, carousel, hashtag auto-expand | |
twitter-extension | Tweets, threads, 280-char validation, bookmarks, quote tweets | |
| YouTube | youtube-extension | Videos, playlists, privacy levels, subscriber tracking |
| TikTok | tiktok-extension | Engagement |
pinterest-extension | Engagement | |
| Medium | medium-extension | Engagement |
| Tumblr | tumblr-extension | Engagement |
| Snapchat | snapchat-extension | Engagement |
| Quora | quora-extension | Answer posting with link embedding, question discovery |
| Discord | discord-extension | Servers, channels, webhooks, rich embeds |
| Rumble | rumble-extension | Engagement |
| Vimeo | vimeo-extension | Engagement |
| BBB | bbb-extension | Reviews, engagement |
| Trustpilot | trustpilot-extension | Reviews, engagement |
| Yelp | yelp-extension | Reviews, engagement |
Platform factory
plugins/_social/platform-factory.mjs (~277 lines):
javascript
import { createPlatformPlugin } from '../_social/platform-factory.mjs';
import { config } from './platforms/reddit.mjs';
const reddit = createPlatformPlugin(config);
export const { login, post, comment, like, follow, execute, routes } = reddit;Each config specifies:
- Rate limits per action type
- Risk thresholds for Smart Gate
- Default mode (ghost/hybrid/speed)
- Specific URL patterns
Routes
Uniform per platform. Examples for Reddit:
| Method | Route |
|---|---|
| POST | /social/reddit/login |
| POST | /social/reddit/post |
| POST | /social/reddit/comment |
| POST | /social/reddit/like |
| POST | /social/reddit/follow |
| POST | /social/reddit/execute |
Plus the dispatcher:
| Method | Route |
|---|---|
| POST | /social/action |
| GET | /social/platforms |
social-engine plugin
Routes social actions to the right platform-factory instance. Imports all 18 platform configs and caches created plugins.
bash
# Generic dispatcher
curl -X POST http://localhost:4700/social/action \
-H "Content-Type: application/json" \
-d '{
"platform": "reddit",
"action": "post",
"accountId": "abc123",
"content": "Post body...",
"subreddit": "DallasJunkRemoval"
}'
# Or platform-specific
curl -X POST http://localhost:4700/social/reddit/post \
-H "Content-Type: application/json" \
-d '{ "accountId": "abc123", "content": "...", "subreddit": "DallasJunkRemoval" }'Per-platform daily limits
Examples (set in each platform config):
| Platform | Likes/day | Comments/day | Posts/day |
|---|---|---|---|
| 300 | 50 | 20 | |
| 200 | 30 | 5 | |
| 100 | 20 | 3 | |
| 100 | 30 | 5 | |
| 200 | 40 | 10 |
Enforced by social-engagement plugin.
Mode defaults per platform
ghost: reddit, linkedin, facebook, instagram, twitter, nextdoor
hybrid: yelp, substack, gmail
speed: youtube, googleRelated
- Cascade Runner: uses 9 platforms in sequence
- social-executor in catalog: Smart Gate risk scoring
- Three I/O Modes