mcpField
B
buffer

buffer

github.com/akhy营销与增长158 次安装8 周前更新
代码仓库

关于 buffer

buffer 是通过 shell 脚本调用 Buffer GraphQL API 的技能，面向社交媒体内容管理。它支持发布排期、帖子与创意管理，以及频道查询。

主要功能

  1. 01创建并安排社交帖子
  2. 02列出和获取帖子
  3. 03创建营销创意
  4. 04列出频道及发布安排
  5. 05以 JSON 返回结果

适用场景

  1. 01为社交频道排队发布帖子
  2. 02查看已排期或已发布的帖子
  3. 03将营销构想记录为创意

安装

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

$npx skills add https://github.com/akhy/agent-skills --skill buffer

安装后在 Claude Code 中输入/buffer确认已加载。

附带文件scripts/buffer.sh

详细介绍

Buffer 技能

通过 Buffer 的 GraphQL API（https://api.buffer.com）与 Buffer 交互。

前提条件

使用此技能前，请设置此环境变量：

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，即可查看完整用法：

bash buffer/scripts/buffer.sh --help

工作流

大多数操作都需要组织 ID 和频道 ID。从这里开始：

# 1. Get your organization ID
bash buffer/scripts/buffer.sh account | jq '.account.organizations[].id'

# 2. List channels to find channel IDs
bash buffer/scripts/buffer.sh channels --org-id <org-id> | jq '.channels[] | {id, name, service}'

操作

创建帖子
# Add to queue (default)
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Hello from the Buffer API!"

# Schedule at a specific time
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Scheduled post" \
  --mode customScheduled \
  --due-at "2026-04-01T09:00:00Z"

# Share immediately
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Posting now!" \
  --mode shareNow

# Save as draft
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Draft content" \
  --save-draft

# Post linked to an idea
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Content from my idea" \
  --idea-id <idea-id>

--mode 的取值： addToQueue（默认）| shareNow | shareNext | customScheduled | recommendedTime

--scheduling-type 的取值： automatic（默认）| notification

关于编辑帖子的说明： Buffer 的公开 GraphQL API 不提供 updatePost 变更操作。使用 update-post 创建修订后的草稿，或在 Buffer 控制面板中编辑帖子。

获取和列出帖子
# Get a single post
bash buffer/scripts/buffer.sh get-post --id <post-id>

# List all posts
bash buffer/scripts/buffer.sh list-posts --org-id <org-id>

# Filter by status and channel
bash buffer/scripts/buffer.sh list-posts \
  --org-id <org-id> \
  --status scheduled \
  --channel-id <channel-id>

# Paginate
result=$(bash buffer/scripts/buffer.sh list-posts --org-id <org-id> --limit 10)
cursor=$(echo "$result" | jq -r '.posts.pageInfo.endCursor')
bash buffer/scripts/buffer.sh list-posts --org-id <org-id> --limit 10 --after "$cursor"

--status 的取值： draft | scheduled | sent | error | needs_approval

创建灵感
# Basic idea
bash buffer/scripts/buffer.sh create-idea \
  --org-id <org-id> \
  --title "Campaign concept" \
  --text "Details about the campaign..."

# With target date and tags
bash buffer/scripts/buffer.sh create-idea \
  --org-id <org-id> \
  --title "Spring promo" \
  --text "Spring sale announcement ideas" \
  --date "2026-04-01T00:00:00Z" \
  --tags '[{"id":"tag-id","name":"Marketing","color":"#FF5733"}]'

关于编辑灵感的说明： Buffer 的公开 GraphQL API 不提供 updateIdea 变更操作。使用 update-idea 创建修订后的灵感。

频道信息
# List all channels for an org
bash buffer/scripts/buffer.sh channels --org-id <org-id>

# Get a specific channel with posting schedule
bash buffer/scripts/buffer.sh channel --id <channel-id>

响应格式

所有响应均为 JSON。使用 jq 提取字段：

# Get created post ID
bash buffer/scripts/buffer.sh create-post \
  --channel-id <channel-id> \
  --text "Hello!" | jq '.createPost.post.id'

# List scheduled post texts
bash buffer/scripts/buffer.sh list-posts \
  --org-id <org-id> \
  --status scheduled | jq '.posts.edges[].node | {id, text, dueAt}'

# Get idea ID after creation
bash buffer/scripts/buffer.sh create-idea \
  --org-id <org-id> \
  --title "My idea" | jq '.createIdea.id // .createIdea.idea.id'

支持的服务

instagram · twitter · facebook · linkedin · pinterest · tiktok · youtube · mastodon · bluesky · threads · googlebusiness · startPage

评论

支持 Markdown