Social Post Flow

Social Post Flow CLI

AI エージェント向けのソーシャルメディア自動化 — プログラムから 12 以上のネットワークへの投稿を予約できます。

Social Post Flow API を利用する、依存関係ゼロの Node.js CLI ラッパーです。AI エージェント（Claude Code、Cursor、Windsurf、Codex、OpenAI SDK）での利用や、シェルスクリプト／CI ワークフロー向けに設計されています。

対応先： Facebook、X（Twitter）、LinkedIn、Instagram（フィード＋ストーリーズ）、Threads、Pinterest、TikTok、Mastodon、Bluesky、Telegram、Google ビジネス プロフィールなど。

---

インストール方法を選択

使用環境	こちらをお使いください
Claude Code	プラグイン（下記の Claude Code プラグインとしてインストール を参照） — MCP サーバーがあらかじめ設定されています
Claude Desktop、ChatGPT Desktop	MCP サーバー（ワンクリックで接続、設定不要）
Cursor、Codex、Warp、Cline、OpenCode、その他のエージェント	スキル（下記の スキルとしてインストール を参照）
シェルスクリプト、CI/CD、独自のツール	CLI（下記の CLI としてインストール を参照）

スキルと CLI は併用できます。スキルは Social Post Flow の使い方をエージェントに教え、実際にエージェントが実行するのは CLI です。

Claude Code プラグインとしてインストール

プラグインには MCP サーバーの設定と Claude ネイティブのスキルがまとめて含まれています。

/plugin marketplace add socialpostflow/claude-marketplace
/plugin install socialpostflow@socialpostflow

または、コミュニティマーケットプレイスで承認された後は、次のコマンドを実行します。

/plugin marketplace add anthropics/claude-plugins-community
/plugin install socialpostflow@claude-community

初回使用時に、Claude Code がブラウザーを開き、Social Post Flow アカウントへのサインインとアクセスの承認を求めます。個人用アクセストークンは必要ありません。

注： プラグインをインストールした場合は、Claude Desktop の設定で MCP サーバーを手動で追加しないでください。同じエンドポイントが二重に登録されます。どちらか一方を選んでください。

スキルとしてインストール

エージェントに Social Post Flow スキルを追加すると、自然言語で投稿を作成して予約できるようになります。これは CLI 駆動のスキルです（エージェントが spf をシェル経由で実行します）。Claude Code ユーザーは、上記のプラグインをインストールしてください。MCP サーバーを使うため、CLI は不要です。

1 コマンドでインストール（~/.claude/skills/ を読み込むエージェント向け）：

mkdir -p ~/.claude/skills/socialpostflow && \
  curl -L https://raw.githubusercontent.com/socialpostflow/socialpostflow-cli/main/agent-skill/socialpostflow/SKILL.md \
    -o ~/.claude/skills/socialpostflow/SKILL.md

複数のエージェントにインストール（Cursor、Codex、Warp、Cline、OpenCode など）：

npx skills add socialpostflow/socialpostflow-cli

プロンプトが表示されたら、インストール先のエージェントを選択してください。

続いて、エージェントに次のように依頼できます。

「このテキストを X と LinkedIn のアカウントに投稿して。」

「来週月曜日の午前 9 時に、月曜のモチベーションを高める投稿を予約して。」

「この 3 つのブログ紹介文を、すべてのチャンネルに順次投稿できるようにキューに追加して。」

エージェントは agent-skill/socialpostflow/SKILL.md から、投稿の種類、予約の仕組み、一般的なワークフローを学びます。

CLI としてインストール

npm を使ってグローバルにインストールします。

npm install -g socialpostflow-cli

または、インストールせずに npx から直接実行します。

npx socialpostflow-cli --help

または、リポジトリをクローンして、スクリプトを直接実行します（依存関係は不要です）。

git clone https://github.com/socialpostflow/socialpostflow-cli.git
cd socialpostflow-cli
node scripts/socialpostflow.js --help

組み込みの fetch を使用するため、Node.js 18 以降が必要です。

認証

API にアクセスできる Social Post Flow アカウントが必要です。プロフィールページから個人用アクセストークンを取得してから、次の手順を実行してください。

spf setup --key spf_xxxxxxxxxxxxxxxx

トークンを API に照合し、~/.socialpostflow/credentials.json に保存します（chmod 600）。

または、環境変数を設定します。

export SOCIALPOSTFLOW_API_TOKEN=spf_xxxxxxxxxxxxxxxx

クイックスタート

# List your connected social profiles
spf profiles

# Post to one profile, immediately
spf post -c "Hello world!" -i 42

# Post to multiple profiles
spf post -c "Big announcement coming soon" -i 42,87,103

# Schedule for a specific time
spf post -c "Happy Monday!" -i 42 --schedule-type scheduled -s "2026-07-20T09:00:00Z"

# Add to the user's queue (uses their configured queue interval)
spf post -c "Quick tip..." -i 42 --schedule-type queue_end

# List recent posts
spf posts --status posted --order-by posted_at --order desc

# Delete a scheduled post
spf delete 12345

コマンド

コマンド	説明
spf setup --key <token>	個人用アクセストークンを検証して保存します。
spf whoami	認証済みユーザーのプロフィール、サブスクリプションの状態、統計情報を表示します。
spf profiles [--post-type T]	接続済みのソーシャルプロフィールを一覧表示します。必要に応じて投稿タイプで絞り込めます。
spf posts [--status S] [--profile-id N]	投稿を一覧表示します。ステータスまたはプロフィールで絞り込めます。
spf post -c "..." -i id1,id2 [options]	投稿を作成します（オプションは以下を参照）。
spf show <post-id>	1件の投稿の詳細を表示します。
spf delete <post-id>	投稿を削除します。予約投稿の場合は公開を停止します。

spf post のオプション

フラグ	説明
-c, --content	投稿テキストです。--type story の場合を除き必須です。
-i, --profile-ids	カンマ区切りのプロフィール ID（必須）。
-t, --type	投稿タイプ：text（デフォルト）、link、image、story、pin、tiktok、google。
-m, --media	カンマ区切りの公開画像・動画 URL。
-u, --url	添付する URL（--type link の場合は必須）。
--first-comment	最初のコメントのテキストです。Mastodon、TikTok、Telegram、Google ではサポートされていません。
--schedule-type	immediate（デフォルト）、queue_end、queue_start、scheduled。
-s, --scheduled-at	ISO 8601 形式のタイムスタンプです（--schedule-type=scheduled の場合は必須で、未来の日時を指定する必要があります）。

各投稿タイプで必要な項目と禁止されている項目など、投稿タイプのルール全体については、agent-skill/socialpostflow/SKILL.md を参照してください。

すべての出力は JSON です

すべてのコマンドは stdout に JSON を出力します。エラーは stderr に JSON を出力し、ゼロ以外の終了コードを返します。

PROFILES=$(spf profiles)
TWITTER_ID=$(echo "$PROFILES" | jq -r '.data[] | select(.provider=="x") | .id')

spf post -c "Hello from a shell script" -i "$TWITTER_ID"

環境変数

変数	デフォルト	説明
SOCIALPOSTFLOW_API_TOKEN	—	API トークンです。spf setup の代わりに使用できます。
SOCIALPOSTFLOW_API_URL	https://app.socialpostflow.com/api	API のベース URL を上書きします（テストに便利です）。

例

一般的なワークフローを示すシェルスクリプトについては、examples/ を参照してください。

• post-everywhere.sh — 同じコンテンツを、接続済みのテキスト対応プロフィールすべてに投稿します
• schedule-week.sh — キューを使用して、1週間分の投稿を予約します
• github-actions.yml — GitHub Action からブログ記事の告知を公開します

トラブルシューティング

「Not authenticated」 — spf setup --key <token> を実行するか、SOCIALPOSTFLOW_API_TOKEN を設定してください。

「HTTP 401 from API」 — トークンが無効です。https://app.socialpostflow.com/profile から有効なトークンを取得してください。

「HTTP 422 from API」 — 検証エラーです。details ペイロードに、問題のあるフィールドが記載されています。よくある原因は、無効な post_type／schedule_type の組み合わせ、過去の日時での予約、image／story／pin／tiktok 投稿で必須の media_urls の指定漏れです。

「HTTP 429 from API」 — そのプロフィールの1日の投稿上限に達しました。ユーザーは待つか、プランをアップグレードする必要があります。

ライセンス

MIT — LICENSE を参照してください。

リンク

• Social Post Flow： socialpostflow.com
• API ドキュメント： socialpostflow.com/documentation/api
• MCP ドキュメント： socialpostflow.com/documentation/mcp
• WordPress プラグイン： wordpress.org/plugins/social-post-flow
• 問題の報告／フィードバック： github.com/socialpostflow/socialpostflow-cli/issues