用途：通过 Buffer 的 GraphQL API（https://api.buffer.com）与 Buffer 交互，管理社交媒体帖子与想法，包括创建并排期发布到已连接渠道、管理帖子队列、在 Buffer Create 中创建想法。
前置条件：使用前需设置环境变量 export BUFFER_API_KEY="your_api_key" # from Buffer account settings 所有请求使用 Authorization: Bearer $BUFFER_API_KEY。
使用方式：所有操作通过 scripts/buffer.sh 执行，在仓库根目录运行： bash buffer/scripts/buffer.sh <command> [options] 无参数或加 --help 可查看完整用法。多数操作需要组织 ID 和渠道 ID，可先用 account 命令获取组织 ID，再用 channels --org-id <org-id> 列出渠道。
主要能力： 创建帖子（create-post）：支持加入队列（默认 addToQueue）、定时（--mode customScheduled --due-at）、立即发布（shareNow）、保存草稿（--save-draft）、关联想法（--idea-id）。--mode 可选 addToQueue、shareNow、shareNext、customScheduled、recommendedTime；--scheduling-type 可选 automatic（默认）、notification。 获取与列出帖子：get-post --id；list-posts --org-id，可按 --status（draft、scheduled、sent、error、needs_approval）和 --channel-id 过滤，用 --limit、--after 分页。 创建想法（create-idea）：支持 --title、--text、--date 及 --tags（JSON 数组）。 渠道信息：channels --org-id 列出组织全部渠道；channel --id 获取指定渠道及其发布计划。
响应格式：所有响应均为 JSON，可用 jq 提取字段。
支持的服务：instagram、twitter、facebook、linkedin、pinterest、tiktok、youtube、mastodon、bluesky、threads、googlebusiness、startPage。
限制：Buffer 公开 GraphQL API 未提供 updatePost 或 updateIdea mutation，编辑帖子或想法时需用 update-post、update-idea 创建修订版草稿，或直接在 Buffer 面板中编辑。其余限制资料未提供。