Socialync

Socialync MCP 服务

Socialync 托管 MCP 服务的官方文档、注册表清单和 Cursor 插件。Socialync 是一款面向创作者的跨平台发布和排期工具：上传一次，即可发布到 TikTok、Instagram、YouTube、Facebook、X、LinkedIn、Threads 和 Bluesky。

此 MCP 服务让 Claude、ChatGPT、Cursor、Google Antigravity、Gemini CLI、OpenAI Codex、Grok Bot 以及任何兼容 MCP 的 AI Agent，都能通过你自己的 OAuth 授权 Socialync 账户起草、排期和发布社交媒体帖子，并在工作流中加入人工审核环节。它还会读取你的分析数据（浏览量、点赞数、评论数、分享数、收藏数、粉丝数，以及表现最好和最差的帖子），让 Agent 根据实际表现规划下周的内容。

所有平台集成都通过官方平台 API 运行。不使用浏览器自动化、不抓取数据、不调用非官方端点。你的 Agent 不会因此导致你的账户受限。

重复保护机制可确保重试绝不会重复发布，发布失败的帖子也会自动重试。Agent 负责发布时，这两点都很重要。

注意： Socialync 的服务托管于远程环境，且为闭源。本仓库仅包含文档、MCP 注册表清单和 Cursor 插件文件。此处没有需要安装或运行的内容。

端点

https://mcp.socialync.io/mcp

传输方式：Streamable HTTP。发现文档（以 JSON 格式提供工具、平台、身份验证和限制信息）：https://mcp.socialync.io/.well-known/mcp

MCP 和 API 访问包含在免费套餐中。 $0，无需信用卡，每月可在 7 个平台发布 5 条帖子（X 仅限付费套餐）。你的 Agent 无需任何人提供信用卡即可连接并发布。付费套餐起价为 $20/月，可发布不限数量的帖子并连接 5 个账户（Starter $20，Creator $30，可连接 10 个账户；Agency $99，可连接 100 个账户；额外账户每月 $2 起）。套餐和价格。

需要了解的限制：每个品牌 1 个 API 密钥；付费套餐中，每个品牌每天可创建 10 条 AI 帖子（免费套餐为 5 条）。

两种身份验证方式

A）OAuth 2.1（首选）。 添加 URL，不带请求头。你的客户端会自行注册（动态客户端注册、PKCE、无需客户端密钥），打开浏览器，然后你使用 Socialync 账户登录，并选择允许 Agent 管理哪些品牌。Claude.ai、Claude Code、Cursor、ChatGPT、Google Antigravity、Gemini CLI 和 Codex 都会自行完成此流程。

B）Bearer API 密钥。 适用于无法完成浏览器 OAuth 流程的客户端（Grok Bot、无头 Agent、手动编辑的配置文件）。在 https://www.socialync.io/go/github-api-keys 生成密钥，并发送 Authorization: Bearer <key>。每个品牌一个密钥，所有套餐均包含。切勿提交密钥。

已知可端到端正常工作的 OAuth 回调（接受任何 https 重定向 URI，以及任意端口的 http://localhost 和 http://127.0.0.1）：

• https://www.cursor.com/agents/mcp/oauth/callback
• http://localhost:8787/callback
• https://claude.ai/api/mcp/auth_callback
• http://localhost/callback
• http://127.0.0.1/callback

连接

**Claude（claude.ai）：**Socialync 已列入 Claude 的连接器目录。打开 Settings，然后选择 Connectors，再选择 Browse connectors，搜索 Socialync 并登录。若要通过 URL 添加，请选择“Add custom connector”，然后粘贴上面的端点。完整操作指南：Socialync MCP connector guide。

Claude Code：

claude mcp add --transport http socialync https://mcp.socialync.io/mcp

Cursor / Grok Bot（OAuth，仅限 URL）：

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

Grok Bot 或任何无法完成 OAuth 的客户端（Bearer 密钥）：

{
  "mcpServers": {
    "socialync": {
      "url": "https://mcp.socialync.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SOCIALYNC_API_KEY"
      }
    }
  }
}

Grok Bot 通过 Cursor 的云端运行 OAuth，而不是在你的设备上运行。同一个 URL 在 Cursor IDE 中可能可用，在 Grok Bot 中却会失败。请在 Grok Bot 的 Settings，然后 Plugins 中测试，不要只在 IDE 中测试。如果 OAuth 始终无法启动，或你看到“fetch failed”，请使用 Bearer 密钥形式。

**Google Antigravity：**将以下内容添加到 ~/.gemini/config/mcp_config.json（或工作区中的 .agents/mcp_config.json）。Antigravity 使用 serverUrl，并通过动态客户端注册自行处理 OAuth 登录。

{
  "mcpServers": {
    "socialync": {
      "serverUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

**Gemini CLI：**安装扩展，然后运行 /mcp auth socialync。

gemini extensions install https://github.com/JackVitick/socialync-mcp

或者自行将以下内容添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "socialync": {
      "httpUrl": "https://mcp.socialync.io/mcp"
    }
  }
}

OpenAI Codex CLI：

codex mcp add socialync --url https://mcp.socialync.io/mcp
codex mcp login socialync

**ChatGPT：**开启开发者模式，并使用端点 URL 添加自定义连接器。哪些 ChatGPT 套餐可以添加自定义连接器曾随时间变化，请查阅 OpenAI 的开发者模式帮助页面，确认你的套餐是否支持。

OpenClaw：

openclaw mcp add socialync --url https://mcp.socialync.io/mcp --transport streamable-http
openclaw mcp login socialync

其他 MCP 客户端（通用配置）：

{
  "mcpServers": {
    "socialync": {
      "type": "streamable-http",
      "url": "https://mcp.socialync.io/mcp"
    }
  }
}

Claude Code 插件

此仓库是一个 Claude Code 插件，也是其自身的插件市场。它会添加托管服务（.mcp.json，无需密钥）以及下方的技能。

/plugin install socialync --marketplace JackVitick/socialync-mcp

对于早于 2.1.275 的 Claude Code 版本，请分两步操作：

/plugin marketplace add JackVitick/socialync-mcp
/plugin install socialync@socialync

首次运行 Socialync 工具时，会在浏览器中打开登录页面。设置说明：SETUP.md。若要跳过插件，可直接添加服务（见“连接”中的 Claude Code）。

技能

六项技能可指导 Agent 更好地使用服务。每项技能都会要求你在每条帖子发布前批准。

技能	功能
schedule-social-post	为 8 个平台起草、安排或发布内容，每条帖子都需你确认
film-once-week-of-shorts	一次拍摄，制作一周的 TikTok、Reels 和 Shorts 内容
blog-to-a-week-of-posts	将一篇文章转化为一周的 LinkedIn 和 X 帖子，并在首条评论中附上链接
weekly-what-worked	根据你的分析数据进行每周回顾，并提供下周的创意
notes-to-carousel	将笔记转化为适用于 Instagram、LinkedIn 和 Threads 的轮播图片
social-queue-analytics	查看、调整或取消已安排的内容，并了解帖子失败的原因

安装方法：

• **Claude Code：**使用上面的插件。
• Cursor、Codex、Windsurf、Gemini CLI 和其他 Agent：npx skills add JackVitick/socialync-mcp
• OpenClaw：openclaw skills install @jackvitick/social-media-scheduler
• **Claude（网页版和桌面版）：**下载技能文件夹并压缩，然后依次前往 Customize、Skills，点击 + 按钮，选择 Create skill，再选择 Upload a skill。必须开启代码执行（Settings、Capabilities）。

技能是可选的指导。即使没有技能，服务也能正常运行。

Cursor 和 Grok Bot 插件

此仓库也是 Cursor 插件（.cursor-plugin/plugin.json、mcp.json、skills/、assets/logo.png）。上架后，可从 Cursor Marketplace 搜索“Socialync”进行安装，也可以像上面那样直接添加 MCP URL。skills/ 中的技能会指导 Agent 如何起草和安排内容、规划一周的帖子，或检查队列。提交清单：MARKETPLACE-SUBMIT.md。

工具

共 28 个工具。相同的列表也发布在 https://www.socialync.io/.well-known/mcp。

工具	功能
list_profiles	列出你的 Socialync 品牌档案（请先调用；每次写入操作都需要 profileId）
list_connections	查看已连接且运行正常的社交账号
list_audiences	列出帖子可指定的已保存受众
list_media	浏览 Socialync 中已有的媒体；附加视频时会用到 mediaId
create_media_upload / finalize_media_upload	上传图片或生成的视频
import-claude-motion-from-url	将 Claude Motion 视频导入你的素材库，供发布使用
check_quota	查看套餐、剩余帖子数、各平台每日上限和排期窗口
validate_post	只读的发布前检查：说明文字长度、链接、媒体、纵横比、视频时长和连接状态
create_post_draft	起草文字或图片帖子（由你在应用中审批）
schedule_post_draft	为未来时间起草文字、图片或视频帖子（由你在应用中审批）
get_draft_status	查看草稿在处理流程中的状态
approve_draft	在你于聊天中确认后，发布待处理的草稿
publish_now	在你于聊天中确认后，立即发布文字或图片帖子
publish_scheduled	在你于聊天中确认后，直接安排帖子发布，包括发布到 TikTok 和 YouTube 的视频
create_x_article_draft / publish_x_article_now	长篇 X Articles（需要 X Premium 账号）
get_scheduled_posts	列出即将发布的帖子
update_scheduled_post	更改已排期帖子的时间、说明文字、标题或首条评论，或移除某个平台
delete_scheduled_post	取消已排期的帖子
get_post_history	查看已发布帖子的历史记录和状态
get_top_posts	展示表现最佳的内容，包括视频的观看时长和 3 秒留存率
get_post_insights	深入查看单条帖子：留存曲线、最大流失点，以及各平台并排对比（支持应用的客户端中提供交互式图表）
get_comments	查看帖子的评论和回复
reply_to_comment	在你于聊天中确认后，回复一条评论（Instagram、Threads、LinkedIn Pages、Bluesky）
get_best_times	根据你自己的历史数据，查看各平台的最佳发布时间段
get_analytics	获取粉丝和互动分析数据
generate_content	使用 AI 生成符合平台风格的说明文字（付费套餐）

文字和图片帖子会立即发布到 Instagram、Facebook、X、LinkedIn、Threads 和 Bluesky。视频帖子，包括 TikTok 和 YouTube（需要标题），会作为已排期帖子发布，使用托管在 Socialync 素材库中的媒体或公开视频 URL。无法将原始视频文件直接粘贴到聊天中；请先将其上传到 Socialync。

完整参考文档，包括推荐调用顺序、各平台限制和错误处理：docs/tools.md。

通过 MCP 查看分析数据

Socialync 会收集 TikTok、YouTube、Instagram、Facebook、Threads 和 Bluesky 的帖子及账号分析数据，MCP 服务返回的数值与 Socialync 分析页面显示的相同（付费套餐）。

• get_analytics 返回过去一周或一个月的浏览量、点赞数、评论数、分享数、收藏数和粉丝总数，以及与上一周期相比的变化、可选的各平台数据细分，以及可选的每日时间序列图表数据。
• get_top_posts 返回帖子的浏览量、点赞数、评论数、分享数、互动率和表现状态（爆红、良好、一般、表现不佳）；可按互动率或日期排序，并可按平台和最低表现状态筛选。
• get_post_history 返回帖子发布的平台，以及失败帖子的简要原因和重试提示。

Bluesky 会报告互动数据，但不报告浏览量，因此其帖子仅根据互动情况评级。

示例工作流

将这些内容粘贴到任意已连接的 Agent 中。指定工具名称是可选的；这样只是让运行过程更容易跟进。上文的每项技能都以一条可供粘贴的“试试看”提示词结尾。

根据过往成效规划本周内容

使用 get_top_posts 获取我过去 30 天表现最好的 5 条帖子，并告诉我它们的共同点。然后按这种风格给我 5 个本周的发帖创意。

撰写并安排一周的帖子

将每个创意分别写成适用于 TikTok、Instagram、LinkedIn 和 Threads 的帖子，并为每个平台撰写合适的配文。对每条帖子运行 validate_post，然后安排在周一至周五我当地时间下午 6 点以草稿形式发布，并列出来供我审批。

将一条视频发布到所有平台

使用 list_media 列出我最新的视频。将最新一条安排在明天下午 5 点发布到 TikTok、Instagram Reels 和 YouTube Shorts。YouTube 标题：“如何在 10 分钟内剪辑一条 Short”。安排前先把所有内容给我看。

每周报告

使用 get_analytics 获取过去一周的数据，并按 by_platform 拆分。告诉我哪些平台有所增长，哪些有所下滑，以及每个平台表现最好的帖子。

查看队列

使用 get_scheduled_posts 显示我下周的帖子，并使用 get_post_history 列出本周所有失败的帖子。

如何让人类参与其中

Socialync 会告知每个已连接的 Agent，在调用 publish_now、publish_scheduled 或 approve_draft 之前，先向你展示准确的帖子内容（平台、各平台的文本、媒体和时间），并在聊天中等待你确认。这些工具被标记为具有破坏性，因此 Claude 等客户端会在运行它们之前征求你的许可。此代码库中的技能对批量操作也采用相同做法：完整展示每条帖子并编号，只有你批准的编号才会发布。对于 TikTok，Agent 会询问每条视频的可见对象（所有人、好友、关注者或仅自己），绝不会替你选择。如果你想改在应用中审核，可以要求创建草稿：create_post_draft 和 schedule_post_draft 会为你保存草稿，供你在 Socialync 中审批；在你批准之前，内容不会发布。

如需由 Socialync 自行进行第二次检查，可在 Socialync 设置中启用确认对话框。支持 MCP elicitation 的客户端会在发布前向你展示帖子，你拒绝后，发布便会停止。

Socialync 发布的内容与你批准的完全一致，并会记录每条帖子的审批人和审批时间。帖子通过你连接的账号发布，你可以随时断开这些账号。Socialync 不提供无人值守的发布模式。

链接

• 网站：socialync.io
• MCP 功能概览：socialync.io/features/mcp
• 连接器设置指南：socialync.io/mcp-connector-guide
• 发现文档：socialync.io/.well-known/mcp
• 官方 MCP Registry：io.github.JackVitick/socialync
• 服务条款：socialync.io/terms-of-service
• 开发者协议（API 和 MCP）：socialync.io/developer-terms
• 隐私政策：socialync.io/privacy-policy

支持

如有疑问或遇到问题，请在此处提交 issue，或发送邮件至 [email protected]。

关注 Socialync

• X： https://x.com/Socialync_io
• Instagram： https://www.instagram.com/socialync.io/
• TikTok： https://www.tiktok.com/@socialync.io
• YouTube： https://www.youtube.com/@Socialync-io
• LinkedIn： https://www.linkedin.com/company/socialync
• Threads： https://www.threads.com/@socialync.io
• Bluesky： https://bsky.app/profile/socialync.bsky.social