Postatron

postatron-cli

Postatron 用のコマンドラインクライアントおよび MCP サーバーです。Postatron は、接続済みのすべてのプラットフォームに 1 件の投稿を公開するソーシャルメディアスケジューラーです。

このリポジトリには、ターミナルまたは AI エージェントから Postatron を操作するために必要なものがすべて含まれています。 サービス自体はクローズドソースです。

• cmd/postatron - CLI。
• cmd/postatron-mcp - リモートサーバーに接続できないクライアント向けの、stdio 経由のローカル MCP サーバー。
• apiv1 - REST API 用の Go クライアントと、API 自体の基盤となるリクエストおよびレスポンスの型。

Claude を接続する（インストール不要）

Postatron は次の場所で MCP サーバーをホストしています。

https://api.postatron.com/mcp

Claude でカスタムコネクターとして追加し（Settings → Connectors → Add custom connector）、求められたらサインインしてください。

Claude Code の場合は、プラグインをインストールします。サーバーへの接続と Postatron スキルの追加を一度に行えます。

/plugin install postatron --marketplace henrwal/postatron-cli

ターミナルで Claude Code（v2.1.275 以降）内から実行すると、Postatron マーケットプレイスを追加してからインストールします。 Claude デスクトップアプリには /plugin コマンドがありません。その場合は、上記のコネクター URL を追加してください。

次に /mcp を実行し、Postatron にサインインしてください。 スキルを使わずにサーバーだけを接続するには、次のようにします。

claude mcp add --transport http postatron https://api.postatron.com/mcp

OAuth 2.1 と動的クライアント登録に対応したリモート MCP サーバー対応クライアントであれば、どれでも同じ方法で接続できます。 コピーするキーはありません。クライアントが自ら登録し、Postatron の同意ページで承認します。

エージェントスキル

npx skills add henrwal/postatron-cli

postatron スキルを Claude Code、Codex、Cursor、および skills CLI がサポートするその他のエージェントにインストールします。 Claude Code では、上記のプラグインにすでに含まれています。 「これを明日の午前 9 時に LinkedIn と X にスケジュールして」のようなリクエストを処理するワークフローをエージェントに教えます。適切なプロフィールを探し、タイムゾーンに合わせて時刻を判断し、各プラットフォームの制限を守り、メディアを添付し、公開前に確認します。 MCP ツールが接続されている場合はそれらを使い、そうでない場合は CLI または REST を使って動作します。

CLI のインストール

Releases からお使いのプラットフォーム用のバイナリをダウンロードするか、Go 1.23 以降でソースからビルドしてください。

go install github.com/henrwal/postatron-cli/cmd/postatron@latest
go install github.com/henrwal/postatron-cli/cmd/postatron-mcp@latest

API キーの取得

postatron.com/dashboard/api で作成してください。 キーにはスコープが設定され、作成時に一度だけ表示されます。 API、MCP サーバー、CLI はすべての有料プランに含まれています。

export POSTATRON_API_KEY=ptn_your_key_here

必要に応じて、POSTATRON_API_URL で API ホストを上書きできます。

CLI の使用

postatron create-post --content "Shipping today." --platforms x,linkedin
postatron create-post --content "Out on Friday." --platforms x --scheduled-at 2026-09-12T09:00:00Z
postatron create-post --content "New in store" --platforms instagram --profile Acme --media-urls https://example.com/shoe.jpg
postatron list-posts --status scheduled
postatron get-post <id>
postatron delete-post <id>
postatron delete-posts <id> <id>
postatron update-post <id> --add-platforms instagram
postatron retry-post <id>
postatron list-events --range 24h --status error
postatron list-accounts
postatron connect-account instagram --profile Acme
postatron list-profiles
postatron create-profile "Acme Ltd"
postatron create-connect-session --profile "Acme Ltd" --platforms instagram --redirect-url https://app.example.com/connected
postatron list-queues
postatron create-queue --name "Weekday mornings" --timezone Europe/London --slots "mon 09:00,wed 09:00"
postatron create-post --content "Whenever there's room" --platforms x --queue "Weekday mornings"
postatron get-usage
postatron get-analytics --range 7d
postatron create-upload --purpose "photo for Tuesday"
postatron get-upload <id>
postatron webhooks create --url https://example.com/webhooks/postatron --events post.failed,post.partial
postatron webhooks test <id>

任意のコマンドに --json を追加すると、API の生レスポンスを取得できます。 完全なリファレンスは docs/cli.md を参照してください。

投稿が失敗した場合

配信に失敗すると、すべてのケースで対処方法を示す error_code が付与されます。reconnect の場合は、connect-account --account-id を使ってアカウントに再サインインするか、MCP 経由で connect_account を実行してください。rate_limited、platform_unavailable、postatron の場合は再試行してください。media_rejected、validation の場合は、変更を加えて新しい投稿を作成してください。policy、unknown の場合はメッセージを確認してください。 retry-post（retry_post）は、失敗したアカウントにのみ投稿を再送し、すでに配信されたアカウントには再送しません。また、再請求されることはありません。 list-events（list_events）は、ダッシュボードの Logs ページと同じログを読み込みます。

Webhook

Webhook は、投稿が公開、一部公開、または失敗したとき、またアカウントが接続、切断、または再接続が必要になったときに、署名付き JSON イベントを独自のサーバーに POST します。 ダッシュボード、POST /v1/webhooks、または postatron webhooks create で設定し、各リクエストの Postatron-Signature をシークレットで検証してください。検証ルールと Go、Node、Python 用の検証コードについては、docs/api.md を参照してください。

プロファイル

プロファイルには接続済みアカウントがまとめられ、通常はブランドまたはクライアントごとに1つのプロファイルを使用し、各プラットフォームのアカウントを最大1つ保持します。 すべてのユーザーにデフォルトのプロファイルがあり、有料プランでは追加できます。 1つのブランドとして投稿するには、--profile（CLI）またはprofile（APIおよびMCP）を指定します。 複数のプロファイルに同じプラットフォームのアカウントがある場合、プロファイルを指定せずにプラットフォーム経由で投稿しようとすると、すべてのブランドに一度に送信されるのではなく、拒否されます。

ローカル MCP サーバー

ローカルサーバーのみを起動するクライアント向けに、postatron-mcpはAPIキーを使用して、stdio経由で同じツールを提供します。 Claude Desktopの場合は、claude_desktop_config.jsonに設定します。

{
  "mcpServers": {
    "postatron": {
      "command": "postatron-mcp",
      "env": { "POSTATRON_API_KEY": "ptn_your_key_here" }
    }
  }
}

詳しくはdocs/mcp.mdをご覧ください。

OpenAPI

REST APIはOpenAPI 3.1形式でapi.postatron.com/v1/openapi.jsonに記述されており、ウェブフックも含まれます。このファイルの取得にキーは必要ありません。 任意の言語でクライアントを生成するか、エージェントに渡して使用できます。Goでは、同じドキュメントはapiv1.OpenAPIです。

ドキュメント

• docs/api.md - REST APIリファレンス、認証、レート制限、エラー。
• apiv1/openapi.json - APIが提供するOpenAPI 3.1の記述。
• docs/mcp.md - MCPツールとクライアントのセットアップ。
• docs/cli.md - すべてのコマンドとフラグ。

ライセンス

MIT。LICENSEをご覧ください。