SuperAPI AI 工具集

buffer

编程与开发

查看项目

更新于 10-16 05:06

技能介绍

用途:该技能用于通过 Buffer 的 GraphQL API 操作社交媒体排期,包括查询组织与渠道、查看已排期帖子、创建文本帖、图片帖、Twitter/X 线程、保存创意以及编辑已有帖子。

主要能力:支持列出组织(organizations)、列出渠道(channels)、查询帖子(posts,含过滤、排序、分页)、创建文本帖与图片帖(create-post)、创建 Twitter/X 线程(create-thread)、保存创意(create-idea)、编辑已排期帖子(editPost)。多数操作需要 organizationId,未指定时先获取组织;若只有一个组织则自动使用。

使用方式:需设置环境变量 BUFFER_API_TOKEN,令牌在 https://publish.buffer.com/settings/api 生成。接口端点为 https://api.buffer.com,全部请求为 POST + GraphQL,Content-Type 为 application/json,认证头为 Authorization: Bearer $BUFFER_API_TOKEN,且必须带 User-Agent: Mozilla/5.0 以避免 Cloudflare 403。含 GraphQL 变量的查询建议写入临时文件并用 -d @file 发送,避免 shell 展开 $input;输出建议用 jq 处理。创建帖子时 channelId 与 text 为必填,schedulingType 可选 automatic 或 notification,mode 为 ShareMode 枚举,仅 addToQueue、shareNow、shareNext、customScheduled 四个值,customScheduled 需提供 ISO 8601 的 dueAt 且须为未来时间。Twitter/X 线程通过 metadata.twitter.thread 数组实现,首条推文需同时出现在顶层 text 与数组首项。图片帖通过 assets.images 传入可公开访问的图片 URL。LinkedIn 公司/展示页提及可直接粘贴完整页面 URL。

限制与注意:account 完整查询在标准令牌权限下会失败,建议改用组织查询确认身份;editPost 若只传 metadata 而不带 text 会报错,需重发完整原文;标签需先获取已有标签对象;不确定字段时可用 schema 内省确认,不要猜测。403 通常因缺少 User-Agent,401 表示令牌无效或过期。