Manage your entire social media from AI — post, schedule, and analyze across Facebook, Instagram, TikTok, YouTube, LinkedIn, Pinterest, Threads, Bluesky and Google Business
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Manage your entire social media from AI — post, schedule, and analyze across Facebook, Instagram, TikTok, YouTube, LinkedIn, Pinterest, Threads, Bluesky and Google Business
version
1.2.2
homepage
https://simplified.com
triggers
["social media","post to","schedule post","publish on","facebook","instagram","tiktok","youtube","linkedin","pinterest","threads","bluesky","google my business","gmb","social accounts","analytics","social media analytics","post analytics","audience analytics","engagement analytics","reach analytics","impressions","followers growth","social insights","social performance","content calendar","social media manager","post scheduling","social media automation","social media campaign"]
Schedule, queue, and draft social media posts, and retrieve analytics across 10 platforms using Simplified.com.
MCP Server
This skill requires a connection to the Simplified Social Media MCP server at https://mcp.simplified.com/social-media/mcp.
All tools (getSocialMediaAccounts, createSocialMediaPost, getSocialMediaAnalyticsRange, etc.) are provided by this remote MCP server — they are not built-in tools. You must configure the MCP server before using any functionality.
MCP server config (add to .mcp.json or equivalent):
Call getSocialMediaAccounts to list connected accounts. Optionally filter by network.
getSocialMediaAccounts({ network: "instagram" })
Returns { accounts: [...] } where each account has id (integer) and name and type (see type values below).
If getSocialMediaAccounts returns an empty list, stop and inform the user with this message:
No social media accounts connected yet.
You're one step away from managing your entire social media presence without leaving your editor. Connect your accounts in the Simplified dashboard and you'll be able to:
📅 Schedule and publish posts to Facebook, Instagram, TikTok, YouTube, LinkedIn, Pinterest, Threads, Bluesky and Google Business — with a single command
📊 Pull analytics, track reach, engagement and follower growth across all platforms
🤖 Let your AI agent run full social media campaigns autonomously
Takes 2 minutes to connect. No code required.
Step 2: Select Target Accounts
Pick one or more account_ids from the results. You can post to multiple accounts in a single call.
Step 3: Compose the Post
Build the post payload:
message (required) — the post text, max 5000 chars
account_ids (required) — array of target account IDs
action (required) — schedule, add_to_queue, or draft
date — required for schedule, format: YYYY-MM-DD HH:MM
media — array of public URLs (images/videos), max 10
additional — platform-specific settings (see below)
Step 4: Publish
Call createSocialMediaPost with the composed payload.
Account ID — use for all analytics calls; convert to string for account_ids in createSocialMediaPost
name
string
Account display name
type
string
Account type — see values below
type values and their meaning:
type value
Platform
Notes
Facebook page
Facebook
—
Instagram business / Instagram profile
Instagram
—
Youtube account
YouTube
—
TikTok profile
TikTok Personal
use tiktok metrics set
TikTok profile (business)
TikTok Business
use tiktokBusiness metrics set
LinkedIn company
LinkedIn
use LinkedIn Company metrics set
LinkedIn profile
LinkedIn
use LinkedIn Personal metrics set
Pinterest board
Pinterest
—
Threads account
Threads
—
Bluesky account
Bluesky
—
Google Profile
Google Business
—
createSocialMediaPost
Parameter
Type
Required
Description
message
string
Yes
Post text (max 5000 chars)
account_ids
string[]
Yes
Target account IDs
action
string
Yes
schedule, add_to_queue, or draft
date
string
No
Schedule datetime: YYYY-MM-DD HH:MM
media
string[]
No
Public media URLs (max 10)
additional
object
No
Platform-specific settings
getSocialMediaAnalyticsRange
Retrieves time-series data for selected metrics within a date range.
Parameter
Type
Required
Description
account_id
integer
Yes
Social media account ID (from getSocialMediaAccounts)
metrics
string[]
Yes
List of metrics to retrieve (see references/ANALYTICS_GUIDE.md)
date_from
string
Yes
Start date: YYYY-MM-DD
date_to
string
Yes
End date: YYYY-MM-DD
tz
string
No
Timezone, e.g. UTC, Europe/Warsaw (default: UTC)
Returns a structured object:
data — array of { date, metrics: AnalyticsMetric[] } — per-day time-series
baseLine — { [metricId]: AnalyticsMetric } — aggregated totals for the full period, each with value (current) and prevValue (equivalent previous period)
additional — { [metricId]: AnalyticsMetric[] } — extra metrics computed over different windows (e.g., 28-day reach)
Unknown metrics are silently ignored. See references/ANALYTICS_GUIDE.md for the full metric list, default metrics per network, and response examples.
getSocialMediaAnalyticsPosts
Retrieves analytics for individual posts within a date range.
Parameter
Type
Required
Description
account_id
integer
Yes
Social media account ID
date_from
string
Yes
Start date: YYYY-MM-DD
date_to
string
Yes
End date: YYYY-MM-DD
page
integer
No
Page number (default: 1, minimum: 1)
per_page
integer
No
Posts per page (default: 10, max: 100)
Returns paginated post list with per-post metrics (likes, impressions, etc.). Fields include all_posts_count, current_page, pages_count, and posts array with id, message, publishedDate, postUrl, postType, media, and metrics.
Pagination: To fetch all posts, use per_page: 100 to minimize API calls, start with page: 1 and keep incrementing until current_page >= pages_count. Stop when there are no more pages or posts is empty.
getSocialMediaAnalyticsAggregated
Retrieves aggregated analytics (totals and averages) for an account within a date range.
Parameter
Type
Required
Description
account_id
integer
Yes
Social media account ID
date_from
string
Yes
Start date: YYYY-MM-DD
date_to
string
Yes
End date: YYYY-MM-DD
Returns data (daily metrics array) and baseLine with four aggregated KPIs: impressions_aggregated, engagement_aggregated, followers_aggregated, publishing_aggregated. Each KPI includes value (current period) and prevValue (previous period for comparison).
getSocialMediaAnalyticsAudience
Retrieves audience demographics and follower data for an account.
Parameter
Type
Required
Description
account_id
integer
Yes
Social media account ID
date_from
string
Yes
Start date: YYYY-MM-DD
date_to
string
Yes
End date: YYYY-MM-DD
tz
string
No
Timezone, e.g. UTC, Europe/Warsaw
Returns audience breakdown: audience_page_fans_gender_age (age/gender split), audience_page_fans_country (followers by country code), audience_page_fans_city (followers by city). Not all fields are available for every network.
Action Types
Action
When to Use
date Required?
schedule
Post at a specific date/time
Yes
add_to_queue
Add to the account's auto-schedule queue
No
draft
Save for later editing in the Simplified dashboard
No
Default: When the user doesn't specify timing, use add_to_queue. When they give a date/time, use schedule. When they say "save" or "draft", use draft.
Platform Settings Quick Reference
All platform settings go inside the additional object, grouped by platform name. Bold = required. For full details see references/PLATFORM_GUIDE.md.
Analytics account_id is an integer, not a string — use the numeric id from getSocialMediaAccounts
Analytics date format is YYYY-MM-DD (no time component, unlike post scheduling)
Unknown metrics are silently ignored by getSocialMediaAnalyticsRange — check references/ANALYTICS_GUIDE.md for per-network availability
Audience data availability varies — getSocialMediaAnalyticsAudience may return partial or empty data depending on the network
Date format must be YYYY-MM-DD HH:MM (24-hour, no seconds, no timezone — uses account timezone)
Media URLs must be publicly accessible — pre-signed or CDN URLs work, localhost does not
date is required when action is schedule — omit it for add_to_queue and draft
Platform character limits — always check before composing; see references/PLATFORM_GUIDE.md for limits per platform
Instagram always requires channel — include channel: { value: "direct" } for every Instagram post
TikTok postType values are video and photo (not image)
TikTok channel values are direct and reminder (not business)
LinkedIn audience value is LOGGED_IN (not LOGGED_IN_MEMBERS)
Google topicType only has STANDARD, EVENT, OFFER (no PRODUCT)
Instagram story — message must be empty (""), max 1 photo
Reels and Shorts require video — Instagram reel, Facebook reel, YouTube short all require a video file in media; images are not allowed (photos.max: 0)
YouTube always requires post.title — always include additional.youtube.post with a title field for every YouTube video or short
