名称: mixpost
描述: Mixpost 是一款自托管的社交媒体管理软件,可帮助您跨多个平台(包括 Facebook、Twitter/X、Instagram、LinkedIn、Pinterest、TikTok、YouTube、Mastodon、Google 商家资料、Threads、Bluesky 等)安排和管理社交媒体内容。
主页: https://mixpost.app
元数据: {"openclaw":{"emoji":"🗓️","primaryEnv":"MIXPOST_ACCESS_TOKEN","requires":{"env":["MIXPOST_URL","MIXPOST_ACCESS_TOKEN","MIXPOST_WORKSPACE_UUID"]}}}
Mixpost 是一款自托管的社交媒体管理软件,可帮助您跨多个平台(包括 Facebook、Twitter/X、Instagram、LinkedIn、Pinterest、TikTok、YouTube、Mastodon、Google 商家资料、Threads、Bluesky 等)安排和管理社交媒体内容。
bash
export MIXPOST_URL="https://您的-mixpost-实例.com/mixpost"
export MIXPOST_ACCESS_TOKEN="您的访问令牌"
export MIXPOST_WORKSPACE_UUID="您的工作区-uuid"curl -X GET "$MIXPOST_URL/api/ping" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/accounts" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/accounts/:accountUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media?limit=50" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media/:mediaUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json" \
-F "file=@/路径/到/您的/文件.png"
curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media/:mediaUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"alt_text": "用于无障碍访问的替代文本"
}'
curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/media" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"items": ["媒体-id-1", "媒体-id-2"]
}'
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"name": "市场营销",
"hex_color": "#FF5733"
}'
curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"name": "更新后的标签名称",
"hex_color": "#00FF00"
}'
curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/tags/:tagUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts?limit=50&status=scheduled&page=1" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
查询参数:
- limit (数字,默认: 50): 每页结果数
- status: draft(草稿), scheduled(已安排), published(已发布), failed(失败), needs_approval(待批准), trash(回收站)
- keyword (字符串): 按内容搜索帖子
- accounts (数组): 按账户 ID 筛选
- tags (数组): 按标签名称筛选
- page (数字): 分页页码
curl -X GET "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"schedule": true,
"date": "2024-12-25",
"time": "10:00",
"timezone": "America/New_York",
"accounts": [1, 2],
"tags": [1],
"versions": [
{
"account_id": 0,
"is_original": true,
"content": [
{
"body": "来自 Mixpost API 的问候!",
"media": [1, 2],
"url": "https://example.com"
}
],
"options": {}
}
]
}'
帖子选项:
- schedule: 设为 true 以安排在特定日期/时间发布
- schedule_now: 设为 true 以立即发布
- queue: 设为 true 以添加到发布队列
- 如果以上均未设置,帖子将保存为草稿
平台特定选项:
{
"options": {
"facebook_page": {
"type": "post" // post(帖子), reel(短视频), story(快拍)
},
"instagram": {
"type": "post" // post(帖子), reel(短视频), story(快拍)
},
"linkedin": {
"visibility": "PUBLIC" // PUBLIC(公开), CONNECTIONS(仅联系人)
},
"mastodon": {
"sensitive": false // 布尔值
},
"pinterest": {
"link": null, // null | 字符串
"title": "", // 字符串
"boards": {
"account-1": "971672010430333260" // 键 `account-*` 是您的 Pinterest 账户 ID
}
},
"youtube": {
"title": null, // null | 字符串
"status": "public" // public(公开), private(私密), unlisted(不公开列出)
},
"gbp": { // Google 商家资料
"type": "post", // post(帖子), offer(优惠), event(活动)
"button": "NONE", // NONE(无), BOOK(预订), ORDER(订购), SHOP(购物), LEARN_MORE(了解更多), SIGN_UP(注册), CALL(致电)
"button_link": "", // 如果按钮是 NONE 或 CALL,请留空
"offer_has_details": false, // 仅当 type 为 offer 时适用
"coupon_code": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时适用
"offer_link": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时适用
"terms": "", // 仅当 type 为 offer 且 offer_has_details 为 true 时适用
"event_title": "", // 仅当 type 为 event 或 offer 时适用
"start_date": null, // null | 字符串 - 仅当 type 为 event 或 offer 时适用
"end_date": null, // null | 字符串 - 仅当 type 为 event 或 offer 时适用
"event_has_time": false, // 仅当 type 为 event 时适用
"start_time": "09:00", // 仅当 type 为 event 且 event_has_time 为 true 时适用
"end_time": "17:00" // 仅当 type 为 event 且 event_has_time 为 true 时适用
},
"tiktok": {
"privacy_level": {
"account-2": "PUBLIC_TO_EVERYONE" // PUBLIC_TO_EVERYONE(所有人可见), MUTUAL_FOLLOW_FRIENDS(互相关注的好友), SELF_ONLY(仅自己可见)- 键 `account-*` 是您的 TikTok 账户 ID
},
"allow_comments": {
"account-2": true // 布尔值
},
"allow_duet": {
"account-2": false // 布尔值
},
"allow_stitch": {
"account-2": false // 布尔值
},
"content_disclosure": {
"account-2": false // 布尔值
},
"brand_organic_toggle": {
"account-2": false // 布尔值
},
"brand_content_toggle": {
"account-2": false // 布尔值
}
}
}
}
curl -X PUT "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"content": "更新后的帖子内容",
"schedule_at": "2024-12-25T10:00:00Z",
"media": ["url1", "url2"],
"tags": ["tag1", "tag2"],
"account_ids": ["id1", "id2"]
}'
curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"trash": false,
"delete_mode": "app_only"
}'
删除模式:
- app_only: 仅从应用中删除(默认)
- app_and_social: 从应用和社交媒体平台同时删除
- social_only: 仅从社交媒体平台删除
curl -X DELETE "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"posts": ["帖子-uuid-1", "帖子-uuid-2"],
"trash": false,
"delete_mode": "app_only"
}'
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/schedule/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"postNow": false
}'
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/add-to-queue/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"
curl -X POST "$MIXPOST_URL/api/$MIXPOST_WORKSPACE_UUID/posts/approve/:postUuid" \
-H "Authorization: Bearer $MIXPOST_ACCESS_TOKEN" \
-H "Accept: application/json"