简化版社交媒体管理

通过 Simplified.com，在 10 个平台上调度、排队、草稿发布社交媒体内容，并获取分析数据。

MCP 服务器

此技能需要连接到 Simplified 社交媒体 MCP 服务器：https://mcp.simplified.com/social-media/mcp。

所有工具（如 getSocialMediaAccounts、createSocialMediaPost、getSocialMediaAnalyticsRange 等）均由该远程 MCP 服务器提供 —— 并非内置工具。使用任何功能前，必须先配置 MCP 服务器。

MCP 服务器配置（添加至 .mcp.json 或等效文件）：

{
  "mcpServers": {
    "simplified-social-media": {
      "transport": "http",
      "url": "https://mcp.simplified.com/social-media/mcp",
      "headers": {
        "Authorization": "Api-Key ${SIMPLIFIED_API_KEY}"
      }
    }
  }
}

若使用 Claude Code，请将 "transport": "http" 替换为 "type": "http"。

重要提示：执行任何操作前

**在调用任何工具前，请务必检查 SIMPLIFIED_API_KEY 是否已正确配置。**

若用户尝试使用任一社交媒体功能时，API 密钥缺失或返回 401/未授权错误：

1. 立即停止 — 不要重试失败的调用
2. 向用户告知以下信息：

Simplified 社交媒体需要 API 密钥才能正常工作。

请按以下步骤操作：

1. 访问 [simplified.com](https://simplified.com) 注册或登录
2. 进入 [设置 → API 密钥](https://app.simplified.com/settings/api-keys)，复制您的 API 密钥
3. 添加到您的 shell 配置文件（~/.zshrc 或 ~/.bashrc）中：

```bash

export SIMPLIFIED_API_KEY="your-api-key"

```

1. 重新加载 shell：source ~/.zshrc
2. 重启 Claude Code 以加载新变量

1. 在用户确认密钥已设置前，不得继续执行原始请求

快速上手

1. 在 [simplified.com](https://simplified.com) 注册账号
2. 在 Simplified 控制台中连接您的社交媒体账户
3. 从 [设置 → API 密钥](https://app.simplified.com/settings/api-keys) 获取 API 密钥
4. 设置环境变量：

export SIMPLIFIED_API_KEY="your-api-key"

1. 配置 MCP 服务器 —— 参见上方 MCP 服务器 部分的配置代码块
2. 重启您的 AI 工具以加载 MCP 服务器

核心工作流程

始终遵循以下顺序：发现 → 选择 → 编辑 → 发布

第一步：发现账户

调用 getSocialMediaAccounts 列出已连接的账户。可选地按平台过滤。

getSocialMediaAccounts({ network: "instagram" })

返回 { accounts: [...] }，每个账户包含 id（整数）、name 和 type（详见下文类型说明）。

若 getSocialMediaAccounts 返回空列表，请立即停止并告知用户以下信息：

尚未连接任何社交媒体账户。

您只需再走一步，即可在编辑器内完成全部社交媒体管理。前往 [Simplified 控制台](https://app.simplified.com) 连接账户，您将能够：

• 📅 使用单条命令，向 Facebook、Instagram、TikTok、YouTube、LinkedIn、Pinterest、Threads、Bluesky 和 Google Business 发布内容
• 📊 跨所有平台获取分析数据，追踪曝光量、互动率和粉丝增长
• 🤖 让您的 AI 代理自主运行完整的社交媒体营销活动

连接仅需 2 分钟，无需编写代码。

第二步：选择目标账户

从返回结果中选取一个或多个 account_ids。可在一次调用中向多个账户发布内容。

第三步：撰写内容

构建发布内容的请求体：

• message（必填）—— 文本内容，最大 5000 字符
• account_ids（必填）—— 目标账户 ID 数组
• action（必填）—— 取值为 schedule（安排发布）、add_to_queue（加入队列）、draft（保存草稿）
• date —— 仅当 action 为 schedule 时必需，格式为 YYYY-MM-DD HH:MM
• media —— 公共 URL 数组（图片/视频），最多 10 个
• additional —— 平台特定设置（详见下方说明）

第四步：发布

使用已构建的内容体调用 createSocialMediaPost。

选择合适的分析工具

工具参考

getSocialMediaAccounts

支持的平台（过滤参数）： facebook, instagram, linkedin, tiktok, youtube, pinterest, threads, google, bluesky, tiktokBusiness

返回 { accounts: [...] }。每个账户对象包含：

**type 取值及其含义：**

createSocialMediaPost

getSocialMediaAnalyticsRange

获取指定时间段内选定指标的时间序列数据。

返回结构化对象：

• data — { date, metrics: AnalyticsMetric[] } 数组，按天的时间序列数据
• baseLine — { [metricId]: AnalyticsMetric }，整个周期的汇总数据，每个指标包含 value（当前值）和 prevValue（上一周期对应值）
• additional — { [metricId]: AnalyticsMetric[] }，基于不同时间窗口计算的额外指标（如 28 天覆盖人数）

未知的指标将被静默忽略。详见 references/ANALYTICS_GUIDE.md 获取完整指标列表、各平台默认指标及返回示例。

getSocialMediaAnalyticsPosts

获取指定时间段内单条帖子的分析数据。

返回分页的帖子列表，包含每条帖子的指标（点赞数、曝光量等）。字段包括 all_posts_count（总帖子数）、current_page（当前页码）、pages_count（总页数）以及 posts 数组，其中每项包含 id、message、publishedDate、postUrl、postType、media 和 metrics。

分页处理： 若要获取全部帖子，请使用 per_page: 100 以减少 API 调用次数，从 page: 1 开始，持续递增直到 current_page >= pages_count。当无更多页面或 posts 为空时停止。

getSocialMediaAnalyticsAggregated

获取账号在指定时间段内的聚合分析数据（总计与平均值）。

返回 data（每日指标数组）和 baseLine，其中包含四个聚合 KPI：impressions_aggregated（曝光总量）、engagement_aggregated（互动总量）、followers_aggregated（粉丝总量）、publishing_aggregated（发布总量）。每个 KPI 包含 value（当前周期值）和 prevValue（前一周期值，用于对比）。

getSocialMediaAnalyticsAudience

获取账号的受众画像与粉丝数据。

返回受众细分数据：audience_page_fans_gender_age（年龄与性别分布）、audience_page_fans_country（按国家代码划分的粉丝分布）、audience_page_fans_city（按城市划分的粉丝分布）。并非所有平台都支持全部字段。

name: Simplified Social Media

version: 1.2.2

description: 一个用于简化社交媒体操作的技能，支持跨平台内容发布、调度与数据分析。

summary: 通过统一接口管理多个社交媒体账号的内容发布、调度和性能分析。

操作类型说明

默认行为：

• 用户未指定发布时间时，默认使用 add_to_queue。
• 用户提供具体日期/时间时，使用 schedule。
• 用户提及“保存”或“草稿”时，使用 draft。

平台设置速查表

所有平台设置均需置于 additional 对象中，并按平台名称分组。加粗项为必填字段。详细信息请参阅 references/PLATFORM_GUIDE.md。

关键枚举值说明

\* = 默认值

示例工作流

简单队列发布

1. getSocialMediaAccounts({ network: "instagram" })
2. createSocialMediaPost({
     message: "Check out our new feature! 🚀",
     account_ids: ["acc_123"],
     action: "add_to_queue",
     media: ["https://cdn.example.com/image.jpg"],
     additional: {
       instagram: {
         postType: { value: "post" },
         channel:  { value: "direct" }
       }
     }
   })

定时发布 YouTube Shorts

1. getSocialMediaAccounts({ network: "youtube" })
2. createSocialMediaPost({
     message: "Quick tip: how to use our API",
     account_ids: ["acc_456"],
     action: "schedule",
     date: "2026-03-10 14:00",
     media: ["https://cdn.example.com/video.mp4"],
     additional: {
       youtube: {
         postType: { value: "short" },
         post: {
           title: "API Quick Tip",
           privacyStatus: "public",
           selfDeclaredMadeForKids: "no"
         }
       }
     }
   })

多平台推广活动

1. getSocialMediaAccounts()
2. createSocialMediaPost({
     message: "Big announcement! We just launched v2.0 🎉",
     account_ids: ["ig_acc", "fb_acc", "li_acc"],
     action: "schedule",
     date: "2026-03-15 09:00",
     media: ["https://cdn.example.com/launch.jpg"],
     additional: {
       instagram: { postType: { value: "post" }, channel: { value: "direct" } },
       facebook:  { postType: { value: "post" } },
       linkedin:  { audience: { value: "PUBLIC" } }
     }
   })

分析：时间序列指标

1. getSocialMediaAccounts({ network: "instagram" })
2. getSocialMediaAnalyticsRange({
     account_id: 123,
     metrics: ["reach", "follower_count", "total_interactions", "saves"],
     date_from: "2026-02-01",
     date_to: "2026-02-28",
     tz: "Europe/Warsaw"
   })

分析：帖子表现报告

1. getSocialMediaAccounts()
2. getSocialMediaAnalyticsPosts({
     account_id: 456,
     date_from: "2026-02-01",
     date_to: "2026-02-28",
     page: 1,
     per_page: 100
   })
// 递增 page 直至 current_page >= pages_count

分析：账户概览（KPI + 用户画像）

1. getSocialMediaAccounts({ network: "facebook" })
2. getSocialMediaAnalyticsAggregated({
     account_id: 789,
     date_from: "2026-02-01",
     date_to: "2026-02-28"
   })
3. getSocialMediaAnalyticsAudience({
     account_id: 789,
     date_from: "2026-02-01",
     date_to: "2026-02-28"
   })

注意事项

• **Analytics account_id 为整数**，而非字符串 — 请使用 getSocialMediaAccounts 返回的数值 id
• Analytics 日期格式 为 YYYY-MM-DD（不含时间部分，与发布调度不同）
• 未知指标会被静默忽略 — getSocialMediaAnalyticsRange 会忽略不支持的指标，请参考 references/ANALYTICS_GUIDE.md 查看各平台支持情况
• 受众数据可用性因平台而异 — getSocialMediaAnalyticsAudience 可能返回部分或空数据，具体取决于目标平台
• 日期格式 必须为 YYYY-MM-DD HH:MM（24小时制，不包含秒和时区信息，使用账号所在时区）
• 媒体 URL 必须可公开访问 — 预签名链接或 CDN 链接有效，本地地址（localhost）无效
• **当 action 为 schedule 时，date 字段为必填项** — 对于 add_to_queue 和 draft 操作可省略
• 各平台字数限制 — 发布前务必检查；详见 references/PLATFORM_GUIDE.md 中各平台的字数限制
• **Instagram 始终需要 channel** — 每个 Instagram 帖子都需包含 channel: { value: "direct" }
• **TikTok postType 的取值为 video 和 photo**（不是 image）
• **TikTok channel 的取值为 direct 和 reminder**（不是 business）
• **LinkedIn 的受众值为 LOGGED_IN**（不是 LOGGED_IN_MEMBERS）
• **Google topicType 仅支持 STANDARD、EVENT、OFFER**（不支持 PRODUCT）
• Instagram Stories — 消息内容必须为空字符串（""），最多允许 1 张图片
• Reels 和 Shorts 必须上传视频 — Instagram Reel、Facebook Reel、YouTube Short 均要求在 media 中提供视频文件，不允许图片（photos.max: 0）
• **YouTube 帖子始终需要 post.title** — 每次提交 YouTube 视频或短片时，必须在 additional.youtube.post 中包含 title 字段