Postemi: Social Media Scheduler

Postemi CLI

コマンドラインから、または AI エージェントからソーシャルメディアへの投稿をスケジュールできます。

Postemi（https://postemi.com）はソーシャルメディアのスケジューラーで、これはそのコマンドラインツールです。ウェブアプリと同じパブリック API を使用しているため、ここでスケジュールした投稿は Postemi のカレンダーに表示され、ウェブアプリでスケジュールした投稿もここで確認できます。

チャンネル：Facebook、Instagram、X、LinkedIn、TikTok、YouTube、Threads、Bluesky、Pinterest、Mastodon など、37 のプラットフォームとアプリに対応しています。

プラン：CLI、API、MCP の利用には Pro 以上のプラン（Pro、Creator、Team）が必要です。Basic では API にアクセスできません。

SKILL.md に、AI エージェント向けに記述した全コマンドのリファレンスがあります。 Claude、ChatGPT、Codex、OpenClaw、Hermes に提示すれば、追加の説明なしで CLI 全体を利用できます。

インストール

npm install -g postemi
postemi --help

Node.js 18 以降が必要です。

サインイン

postemi auth:login     # device flow: opens postemi.com/app/device in the browser
postemi auth:status    # checks the credential
postemi auth:logout    # deletes the stored credential

Postemi にサインインした状態でブラウザーからログインを承認し、そのキーでアクセスできるワークスペースとチャンネルを選択します。CLI はキーを ~/.postemi/credentials.json（モード 0600）に保存します。

まだアカウントをお持ちでない場合は、ターミナルから作成できます。

postemi auth:signup --email [email protected]    # e-mails a code, asks for it and for the terms
postemi auth:signup --email [email protected] --code 123456 --accept-terms --workspace-name "Anna's Cafe"

作成する人は、まず https://postemi.com/terms および https://postemi.com/privacy に同意する必要があります。postemi auth:signup で作成したアカウントには無料トライアルがありません。続けて postemi billing:plans と postemi billing:subscribe を実行してください。代わりに https://postemi.com/app/signup で登録すると、7 日間の無料トライアルが始まります。その後、postemi auth:login を実行してください。

サーバー、CI、またはブラウザーのないエージェントで使う場合は、ウェブアプリの「Settings」の「Developers」から API キーを取得してください。

export POSTEMI_API_KEY=your_api_key

変数	デフォルト	用途
POSTEMI_API_KEY	なし	auth:login を使用しない場合の API キー
POSTEMI_API_URL	https://api.postemi.com	API のベース URL
POSTEMI_WORKSPACE	なし	すべてのコマンドで使うワークスペース ID（--workspace と同じ）
POSTEMI_TIMEZONE	なし	オフセットなしで記述された日付に使う IANA タイムゾーン
POSTEMI_AUTH_SERVER	https://api.postemi.com	auth:login がデバイスフローを実行するサーバー
POSTEMI_CLIENT_NAME	Postemi CLI	承認ページに表示される名前

auth:login で保存した認証情報は、POSTEMI_API_KEY より優先されます。

クイックスタート

postemi auth:status
postemi integrations:list                        # your channels and their ids
postemi config:set timezone Europe/London        # once: how to read dates without an offset

IMG=$(postemi upload ./photo.jpg | jq -r '.path')
postemi posts:create -c "Hello from the terminal" -m "$IMG" \
  -s "2026-12-31 09:00" -i "<integration-id>"

結果は stdout に JSON で出力され、ステータス行とエラーは stderr に出力されます。失敗した場合は必ず終了コード 1 で終了します。各コマンドの使い方を確認するには、postemi <command> --help を実行してください。

エージェントスキル（任意）

CLI は、スキルをお使いのマシン上のコーディングエージェント（Claude Code ~/.claude/skills、Codex ~/.codex/skills または $CODEX_HOME/skills、Cursor ~/.cursor/skills、Grok Build ~/.grok/skills）にインストールできます。中核となる postemi スキルはどのエージェントにも付属します。ほかの 2 つは任意です。

postemi skills list                    # core, writing, growth: installed where
postemi skills add writing             # ideas, hooks, formatting, templates
postemi skills add growth              # niche, cadence, 30-day plan
postemi skills add all --agent claude --yes
postemi skills remove growth

ターミナルで postemi auth:login を実行した後、CLI は文章作成スキルと成長スキルを使うかどうかを一度だけ尋ねます（デフォルトは No）。回答は ~/.postemi/config.json に保存されます。エージェントやスクリプトから実行する場合（ターミナルなし、--json、または CI が設定されている場合）は尋ねず、代わりにヒントを 1 行だけ一度表示します。複数のエージェントが見つかった場合は、どれを使うか尋ねます。--agent と --yes を指定すると、この選択を省略できます。

詳細

• SKILL.md：すべてのコマンド、フラグ、ルール
• PROVIDER_SETTINGS.md：チャンネルごとの設定
• SUPPORTED_FILE_TYPES.md：対応する 8 種類のメディア形式
• examples/：すぐに使える --json ペイロード
• チャットクライアント向け MCP サーバー：https://mcp.postemi.com/mcp
• ヘルプ：https://postemi.com/help、サポート：[email protected]
• プライバシー：https://postemi.com/privacy、利用規約：https://postemi.com/terms

AI エージェント向けプラグイン

このリポジトリには、plugins/ に Postemi プラグインも含まれています。

フォルダー	対象	内容
plugins/postemi-mcp	Claude（チャット、デスクトップ、Code）	ホスト型 MCP サーバー https://mcp.postemi.com/mcp とスキル
plugins/postemi-cli	Claude Code	この CLI のスキル。エージェントが postemi コマンドを実行します
plugins/postemi-chatgpt	ChatGPT	ChatGPT アプリパッケージ
plugins/postemi-cursor	Cursor	MCP サーバー、スキル、コマンド
plugins/postemi-grok	Grok Build	MCP サーバー、スキル、コマンド
plugins/postemi-growth	Claude Code、Cursor、Grok Build	オプション：グローススキルのみ

Claude Code では：

claude plugin marketplace add norbertlevente/postemi-agent
claude plugin install postemi@postemi-agent        # MCP server
claude plugin install postemi-cli@postemi-agent    # CLI skill

スキル単体（OpenClaw やその他のエージェント向け）は skills/postemi/SKILL.md です。

執筆とグロースのスキル

投稿のスケジュール設定だけでなく、投稿の執筆をエージェントが支援するスキルがさらに 3 つあります。

スキル	学べること	プラグイン内の場所
skills/postemi-writing	投稿のアイデア、フックと見出し、書き出し、書式設定、スレッド、各ネットワークの執筆ルール、公開前のチェック	すべてのメインプラグイン
skills/postemi-templates	ウェブアプリから生成された Postemi コンポーザーのテンプレートとフックのライブラリ	執筆スキルとともに、すべてのメインプラグイン
skills/postemi-growth	ネットワークと最初のニッチの選び方、30 日間のテスト、数値の読み解き方、投稿頻度、1 つのトピックから 30 個の切り口を考える方法、再利用、自己紹介文とプロフィールリンク、週次レビュー	オプション：単独のプラグイン plugins/postemi-growth

claude plugin install postemi-growth@postemi-agent   # the optional growth plugin

CLI では、執筆とグロースはいずれもオプションです。以下を参照してください。

開発

pnpm install
pnpm build        # dist/index.js
pnpm test         # type check, build, unit tests (test/), scripts/check.mjs (manifests, skill copies, no other-brand text)
node dist/index.js --help

pnpm sync:templates ../postemi/src/lib/app/templates   # regenerate skills/postemi-templates/reference from the web app
pnpm sync:skills                                       # copy writing and templates into the main plugins, growth into postemi-growth

リリース手順：PUBLISHING.md。変更履歴：CHANGELOG.md。

ライセンス：AGPL-3.0。詳細は LICENSE を参照してください。 ソース：https://github.com/norbertlevente/postemi-agent