使用 Sendcove
Sendcove 是一个社交媒体调度器。其 MCP 服务器提供了管理用户帖子、媒体、分析和收件箱的工具。如果没有可用的 Sendcove 工具,请告知用户连接 Sendcove(设置指南:https://www.sendcove.app/features/mcp)。
从账户开始
- 在创建或更改帖子之前调用
list_accounts。将返回的id作为accountIds传递;Sendcove 会根据这些 ID 确定平台。 - 如果用户有多个账户但未指定使用哪个,请询问。默认情况下不要发布到每个账户。
- 带有
needsReconnect: true的账户将无法发布。请告知用户在 Sendcove 中重新连接该账户。
创建帖子
create_post创建的是草稿,除非你设置了status。草稿是安全默认值:创建一个,向用户展示你创建的内容,然后让他们安排或发布。content是每个平台的默认文本。使用platformContent为某个平台指定其专属文本,例如为twitter提供 280 字符版本,为instagram提供更长的说明。键值:twitter、instagram、tiktok、threads、bluesky、facebook、linkedin(字符串)和youtube({ title, description })。- 每个平台的选项(Instagram 帖子类型、YouTube 视频类型和可见性、TikTok 隐私、Bluesky 回复设置、X 社区等)都放在
platformSettings中。请从工具输入模式及其描述中获取允许的字段和值,而不是猜测。在设置platformSettings.tiktok之前,请调用get_tiktok_creator_info以获取该账户允许的隐私级别和互动。 - 字符限制在帖子发布时检查:X 280、Bluesky 300、Threads 500、Instagram 和 TikTok 2200、LinkedIn 3000、YouTube 标题 100 及描述 5000。请将每个平台的文本保持在其限制内(使用
platformContent),以免帖子稍后失败。 - Instagram 和 TikTok 帖子需要媒体;YouTube 需要一个视频。
- Threads:将后续帖子作为
threadItems传递(每个{ content, mediaUrls? })。这些将在 X、Bluesky 和 Threads(Pro 和 Max)上作为线程发布;其他平台仅获得content。使用update_post并传递threadItems: []可停止线程化。 - 标签:
list_hashtag_sets返回用户保存的标签集(存储时不带#)。 - 为
create_post、duplicate_post和reply_to_inbox_item传递一个idempotencyKey(任意唯一字符串,8 到 200 个字符)。如果调用超时或你不确定是否成功,请使用相同的键重试:你将获得第一次结果,而不是重复的帖子或回复。 update_post仅更改你传递的字段,但platformContent、platformSettings和threadItems各自替换整个存储值。请先调用get_post并发送完整的对象。
媒体
- 媒体必须位于用户的 Sendcove 媒体库中,然后才能放入
mediaUrls。list_media显示已有的内容。 - 公共 https URL:调用
upload_media_from_url,然后使用返回的url。 - 本地文件:调用
create_media_upload_url,并运行返回的 curl 命令,使用实际文件路径(例如curl -s -X POST '<uploadUrl>' -F 'file=@/path/to/photo.jpg')。JSON 响应中有要使用的url。上传 URL 持续 10 分钟,无需 API 密钥。对于超过 4 MB 的文件,请传递contentType并按顺序运行返回的两个命令(PUT 到存储,然后 finalize POST)。添加-F convertForInstagram=true可将图像转换为 JPEG 以用于 Instagram。 - 允许的类型:JPEG、PNG、GIF、WebP、MP4、MOV、AVI。
安排和发布
只有当用户在此对话中要求时,才进行安排、发布或回复。撰写帖子并不代表允许发布。
- 安排:
status: "scheduled"并设置scheduledFor为带有偏移量的 ISO 8601 格式(2026-11-20T15:00:00Z)。转换用户的本地时间,如果不确定时区请确认。或者传递nextOpenSlot: true以使用用户为这些账户设置的下一个空闲发布时间。 - 立即发布:在
create_post上设置status: "pending",或对现有帖子使用publish_post。 - 发布后,调用
get_post:每个账户都有自己的status(published、failed、pending)和error。失败的帖子通常意味着一个账户失败。对该帖子上的publish_post仅重试失败的账户;它不会重新发布已经发布的内容。 delete_post无法撤销。删除前请确认。
草稿仅限连接 (403)
安排、发布和回复需要 Pro 或 Max 计划并且一个允许发布的连接。在 Basic 计划上,或使用设置为仅限草稿的 API 密钥或连接应用,这些调用会返回 403 "This API key or connected app can only create drafts"。
当这种情况发生时,不要重试,也不要绕过。将帖子保存为草稿并告知用户:
我已将此保存为 Sendcove 中的草稿。此连接仅限草稿,因此我无法安排或发布。要让我发布,你需要 Pro 或 Max 计划,然后在此处重新连接 Sendcove 并选择“允许发布”(或使用在 Sendcove 的“账户 > API 密钥”中创建时开启了“允许发布”的 API 密钥)。你也可以自己在 Sendcove 中安排该草稿。
分析和收件箱
get_engagement:总计、按平台细分、热门帖子以及每个账户相对于其中位数的近期最佳帖子(timesMedian显示帖子表现好多少,而非原因)。get_post_analytics:每个账户的已发布帖子的指标;传递refresh: true获取最新数据(缓存一小时)。并非每个平台都报告每个指标。get_best_times:根据用户自身的互动数据,获得最佳发布日和发布时间。list_inbox/get_inbox_item:回复、提及和评论。reply_to_inbox_item发布公开回复,因此先向用户展示文本并获得确认。update_inbox_item将项目标记为已读、未读或已归档。