CLIAPI

ターミナルから予約・公開

fopostはFoPost公式のCLIです。追加のインストール不要の単一の静的バイナリで、投稿の作成、メディアの添付、接続済みの全アカウントへの予約、各配信の確認まで、シェルでもスクリプトでもCIジョブでも行えます。

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

単一のバイナリ

macOS、Linux、Windowsのamd64とarm64に対応。Homebrew、go install、またはリリースアーカイブでインストールできます。

スクリプト向け設計

すべてのコマンドが--jsonに対応し、エラーはstderrへ出力され、失敗ごとに固有の終了コードが返ります。

勝手に投稿されません

--publishを付ける、posts publishを実行する、または予約を設定するまで、投稿は下書きのままです。

投稿

作成、予約、公開をワンコマンドで

posts createにアカウント、本文、ローカルのメディアファイル、日時を渡せます。ファイルはメディアライブラリにアップロードされ、自動で添付されます。長文はファイルやパイプから読み込め、プリフライトで送信前に各ネットワークへの適合を確認できます。

投稿コマンドを読む
投稿
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

予約または公開

日時を渡せば予約、--publishで即時送信、何も付けなければ下書きのままです。

プリフライト

公開前に、どのアカウントが準備完了か、ブロックされているか、その理由を確認できます。

配信ステータス

アカウントごとのステータスと試行回数、ネットワークが発行した場合は公開リンクを確認できます。

スクリプト

JSONで出力、終了コードで応答

どのコマンドにも--jsonを付けて、結果をjqにパイプできます。401、404、レート制限、不正なリクエストはそれぞれ異なるコードで終了するため、テキストを解析せずに区別できます。再試行とバックオフはすべてのリクエストで内部的に行われます。

スクリプトガイドを読む
対応が必要なアカウント
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

どこでも--json

リソースそのものをインデント付きでstdoutに出力します。表は人間向けです。

固有の終了コード

不正な入力、認証、スコープ、未検出、レート制限、サーバーエラーにそれぞれコードがあります。

再試行を内蔵

レート制限、サーバーエラー、ネットワーク障害はバックオフ付きで再試行されます。

CI

パイプラインから投稿

APIキーをシークレットとして設定しワークスペースを指定すれば、保存済みの設定は不要です。リリースの告知、変更履歴の共有、プリフライト失敗時のマージブロックも可能です。GitHub向けには、同じフローをまとめた公式Actionもあります。

構築を始める
タグごとにリリースノートを投稿
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

環境変数からキーを取得

FOPOST_API_KEYは自動で読み込まれます。CIでのログイン手順は不要です。

あらゆるCIに対応

GitHub Actions、GitLab CI、シェルを実行できる環境ならどこでも使えます。

自動化とWebhook

同じツールから自動化の実行やWebhookサブスクリプションの管理ができます。

CLIに関するよくある質問

CLIはどうやってインストールしますか?

brew install fopost/tap/fopost を実行するか、go install github.com/fopost/fopost-cli@latest を実行するか、GitHubのリリースページからお使いのプラットフォーム向けアーカイブをダウンロードしてfopostをPATHに追加してください。

アカウントは必要ですか?

はい。CLIはホスト型のFoPost APIと通信するため、ダッシュボードの「設定」の「APIキー」で作成するAPIキーが必要です。fopost auth login で保存するか、代わりにFOPOST_API_KEYを設定してください。

APIキーはどこに保存されますか?

ユーザーの設定フォルダ内に、本人だけが読める形で保存されます。CLIがキーを再表示することはありません。auth statusはマスクされたプレフィックスのみを表示し、詳細出力にも含まれません。

何ができますか?

投稿、アカウントとそのヘルス、ワークスペース、メディアのアップロード、ラベル、分析、自動化、Webhookを扱えます。すべてのコマンドは fopost --help かCLIドキュメントで確認できます。

オープンソースですか?

はい。CLIはMITライセンスで、ソースはGitHubのfopost/fopost-cliで公開されています。

今日からCLIで開発を

無料で始められ、API全体が含まれます。キーを作成すれば、数分で最初の呼び出しができます。

APIキーを取得