mcpField
P
publish-to-social

publish-to-social

github.com/gitroomhq营销与增长83123 次安装3 天前更新
代码仓库

关于 publish-to-social

publish-to-social 是一项技能，可将完成的 agent-media 视频发布到已连接的 TikTok、Instagram 或 X 频道。提供 REST、命令行和 MCP 接口，连接频道需由用户完成授权。

主要功能

  1. 01连接支持的社交频道
  2. 02查看或断开已连接频道
  3. 03立即发布视频
  4. 04安排视频发布时间

适用场景

  1. 01发布完成的 agent-media 视频
  2. 02为指定频道安排视频发布
  3. 03发布前查看已连接频道

MCP 相关

提供用于连接频道、列出频道和发布视频的 MCP 工具。连接时会返回 OAuth URL，需由用户授权。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gitroomhq/agent-media --skill publish-to-social

安装后在 Claude Code 中输入/publish-to-social确认已加载。

详细介绍

发布到社交平台

将已完成的 Agent 媒体视频（任一视频工具生成的 R2 video_url）发布到用户已连接的社交渠道：TikTok、Instagram 或 X。支持三个入口：REST、CLI（agent-media social ...）和 MCP 工具（social_channels / social_connect / social_publish）。所有调用均使用用户的 Authorization: Bearer ma_... 令牌，访问 https://api.agent-media.ai。

1. 连接渠道（一次性操作，需要用户本人完成）

GET    /v1/social/providers             -> connectable networks: tiktok, instagram, instagram-standalone, x
POST   /v1/social/connect { provider }  -> { url }   # the user opens this OAuth url and authorizes
GET    /v1/social/channels              -> { channels: [{ id, name, provider, profile, picture }] }
DELETE /v1/social/channels/:channelId   -> disconnect

连接步骤会返回一个 OAuth URL，必须由用户本人打开并授权；Agent 无法自行完成 OAuth。授权后，该渠道会出现在 /v1/social/channels 中，你可以将其中的 id 传给发布操作。

CLI：agent-media social providers · agent-media social connect x · agent-media social channels。 MCP：social_connect { provider }（向用户返回 URL）· social_channels。

2. 发布视频

curl -X POST https://api.agent-media.ai/v1/social/publish \
  -H "Authorization: Bearer ma_..." -H "Content-Type: application/json" \
  -d '{ "video_url": "https://pub-...r2.dev/generation-outputs/<user>/<job>/...mp4",
        "channel_ids": ["<channel-id-from-/channels>"],
        "caption": "made with agent-media",
        "type": "now" }'    # or "type":"schedule" + "date":"2026-06-01T10:00:00.000Z"

CLI：agent-media social publish --video <url> --channels <id,id> --caption "..."（添加 --at <iso> 可安排发布时间）。 MCP：social_publish { video_url, channel_ids, caption, type }。

video_url 必须是 agent-media R2 URL（视频工具的输出）；agent-media 会为你将视频重新托管到发布平台。channel_ids 来自 /v1/social/channels。各社交网络的特定要求（例如 X 的回复设置）会在服务端填写；你无需传入这些设置。

返回 { success: true, media_id, post_ids: ["..."] }。仅当 post_ids 非空时，才表示已创建真实帖子；如果 post_ids 为空，应视为失败，而非成功。

典型流程

  1. 使用 generate_video 生成视频，并获取 final_output.video_url。
  2. 如果用户尚未连接任何渠道，请引导其完成连接（第 1 步）；你无法代替用户完成 OAuth。
  3. 将该 video_url 发布到所选的 channel_ids；确认返回了 post_ids。

注意：社交操作使用共享的速率额度；不要轮询。连接一次，按需发布。

评论

支持 Markdown