buffer

Buffer スキル

Buffer の GraphQL API（https://api.buffer.com）を介して操作します。

前提条件

このスキルを使用する前に、次の環境変数を設定してください。

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