Social media connectors

Social connectors give the agent three abilities: reading public content, publishing to connected accounts, and generating images and video. They live on their own screen: /settings/social-connectors.

If you can't see the menu

Social connectors sit behind three gates. Unless all three are open, the menu is hidden, the API returns 403, and the social tools are removed entirely from the agent's toolset — the model doesn't even see them.

1. Platform switch — must be enabled on the SemAgent side.
2. Tenant switch — social connectors must be enabled for your account.
3. A configured provider — at least one connector saved and enabled.

If the first two are off, contact your administrator.

Three families

Family	What it does	Providers
📥 Read	Reads/monitors public content	Apify, Reddit
🔗 Managed publishing	Publishes to many accounts from one panel	WoopSocial, Ayrshare, Zernio
🎨 Media generation	Video generation with your own key	fal.ai, Higgsfield

The flow is the same for every provider: fill the fields → Save → Test. Each row shows the last test status and error. Secrets are stored encrypted and come back to the panel masked as ***; leave the mask untouched and the old value is preserved.

Reading: Apify and Reddit

Apify

Pulls public content from X/Twitter, Instagram, TikTok, Facebook, YouTube, LinkedIn, Pinterest and Etsy. The agent can also run any actor from the Apify store.

1. Create an account at apify.com → Settings › Integrations → copy the API token.
2. Enter the token and a Max results limit (spend protection; e.g. 25).
3. Save → Test.

Usage: say "read this Instagram profile" and social_read runs. For a specific actor, say "run Apify actor apify/google-maps-scraper with this input" and apify_run runs.

The optional Actor mapping field lets you override a platform's default actor, e.g. {"linkedin":"harvestapi/linkedin-profile-posts"}.

Reddit

Read-only access through Reddit's official API (PRAW), and it's free.

1. Go to reddit.com/prefs/apps → create app → choose type script.
2. Set the redirect URI to http://localhost (unused for script apps) and create it.
3. Copy the Client ID (the string under the app name) and the secret.
4. Enter Client ID + secret + (optional) User-Agent → Save → Test.

Usage: "what's trending in r/Turkey" → reddit_read.

Managed publishing: WoopSocial and Ayrshare

Aggregators remove the need to register a developer app per platform: you connect your accounts in their panel via OAuth, and the agent publishes through a single tool (social_post).

WoopSocial

1. Create an account at woopsocial.com and connect your social accounts in their panel (one-click OAuth per platform).
2. API access requires the Pro plan or above — the free plan is panel-only, with no API. Copy the Bearer API key from app.woopsocial.com/api-access.
3. Enter the API key → Save → Test.

Usage: "post this text to my Instagram account on WoopSocial" → social_post. "List my connected accounts" → social_channels. Image and video posts are supported; media is uploaded to the media library automatically.

Native MCP (optional): tick Connect native MCP tools and WoopSocial's own tools attach directly to the agent; api.woopsocial.com is added to the egress allow-list automatically.

Ayrshare

An official-partner aggregator — 13 networks, no developer app required.

1. Create an account at ayrshare.com and copy the API Key from the dashboard.
2. For a single account that's enough. On the multi-profile Business plan you also provide a Profile Key, plus Domain + Private Key for the JWT account-linking flow.
3. Save → Test.

Usage: "post this to LinkedIn on my Ayrshare profile" → social_post. If you don't name a platform, the post goes to every connected account.

Zernio

Zernio is another managed-publishing aggregator (LinkedIn and other networks). Connect your accounts in its portal and enter your API key in SemAgent; then use social_post for approved publishing and social_channels to list accounts. Image/video media is uploaded too.

Postiz

You will see a Postiz card in the panel. Right now it only stores configuration; no publishing tools are wired to it yet. Use WoopSocial, Ayrshare or Zernio to publish.

Learning from published posts

The agent doesn't just publish; it collects performance metrics (engagement, reach) from the posts it publishes, distills lessons from them, and applies them to its strategy (charter) — so the next piece of content is sharper. This learning loop is tenant-specific and strengthens as metrics accumulate.

Media generation: images on us, video on your key

These two work differently — this is the most commonly confused point.

	Image generation	Video generation
Tool	image_generate	video_generate
Runs on	The SemAgent gateway	Your provider account
Setup	None	Required — connect fal.ai or Higgsfield
Billing	Uses your SemAgent credits	Burns no credits; bills your provider balance
If not connected	Works	Video cannot be generated

In other words, video generation is bring-your-own-key (BYOC). You must connect the provider and switch it on; switch it off and video generation stops immediately. The daily video limit still applies under BYOC.

fal.ai

1. Create an account at fal.ai → Dashboard › Keys → create an API key (a single string shaped like id:secret).
2. Paste the key → Save → Test.

Once on: "generate a 5-second vertical video about this" → the video is produced against your fal balance. Track spending at fal.ai/billing.

Higgsfield

1. Get an API key + secret from your Higgsfield account (platform.higgsfield.ai).
2. Enter both → Save → Test.

Generation is a two-step process (image first, then video) and can take minutes. Costs land on your Higgsfield account.

Tools unlocked

Tool	What it does	Connector needed
social_read	Reads a profile or post	Apify
apify_run	Runs any Apify actor	Apify
reddit_read	Reads a subreddit or post	Reddit
social_channels	Lists connected accounts	WoopSocial
social_analytics	Fetches post metrics	Aggregator
social_post	Publishes to connected accounts	WoopSocial / Ayrshare
video_generate	Generates video	fal.ai / Higgsfield

social_post publishes externally and therefore requires approval in supervised mode. Content returned by the reading tools counts as external content and is quarantined before it reaches the planner — see Security architecture.