gitroomhq/postiz-agent

Postiz Agents CLI - connect it to Claude / OpenClaw / etc, to schedule social media posts 🤖

概要

postiz-agentは、AIエージェント（ChatGPT、Claude、Geminiなど）が、さまざまなAIエージェントエコシステム（Claude Code、Cursor、Gemini、Grok Build、DeepSeek Harnessなど）内から Postiz CLI を呼び出せるようにする軽量なラッパーです。基盤となるPostiz CLIはPostiz SaaSプラットフォームと通信し、数十のプラットフォーム（Twitter/X、LinkedIn、Reddit、TikTok、Instagram、YouTube、Facebookなど）でソーシャルメディア投稿をスケジュールおよび公開するための統合APIを提供します。

想定されるユーザー

AIアシスタントツールを開発する開発者：コンテンツの自動投稿が必要な場合（例：ツイートの下書きを作成し、スケジュールするChatGPTプラグイン）。
プロダクトチーム：Postizを自社のAIエージェントプラットフォーム（Claude Code、Cursor、Geminiなど）の組み込み「スキル」として公開したい場合。
パワーユーザー：すでにPostiz CLIを使用しており、カスタムの接着コードを書かずに会話型AIからそれをトリガーしたい場合。

主要コンポーネント（README記載）

コンポーネント	機能
スキル/CLI統合	ホストエージェント内に `postiz` スキルを登録します。このスキルは、グローバルにインストールされた `postiz` npm CLI（別途インストールが必要）にコマンドを転送します。
マニフェストファイル	各ホストプラットフォームに必要なプラグインマニフェスト（`.grok-plugin`、`.cursor-plugin`、`gemini-extension.json`、DeepSeek Harnessバンドルなど）を提供します。
MCPサーバー登録	MCP (Multi-Channel Publishing) サーバーをサポートするプラットフォームの場合、プラグインはホストされているPostiz MCPエンドポイント (`https://mcp.postiz.com/mcp-oauth-dynamic`) を指します。これにより、エージェントのOAuthフローとトークンストレージが処理されます。
Postiz CLI	実際の作業を行うツール。認証（OAuthデバイスフローまたはAPIキー）、統合のリスト表示、メディアのアップロード、投稿の作成/スケジュール、分析の取得、YouTubeクリッピングの実行などを行います。すべてのコマンドはエージェントが解析しやすいJSONを出力します。

実際の動作（例）

スキルのインストール – npx skills add gitroomhq/postiz-agent またはCursorマーケットプレイス経由でインストール。
認証 – エージェントの初回実行時にブラウザが開き、Postiz OAuthデバイスフローを通じて認証情報を保存します。
エージェントによるスキル呼び出し – ユーザーがAIに「明日の新機能に関するツイートをスケジュールして」と依頼。エージェントは postiz スキルを使用して以下を行います：
- 利用可能なTwitter統合をリストアップ (postiz integrations:list)。
- 必要に応じて動的データ（トレンドハッシュタグなど）を postiz integrations:trigger で取得。
- メディアをアップロード (postiz upload image.png)。
- コンテンツ、スケジュール時間、統合ID、メディアURLを指定して postiz posts:create … を実行。
Postiz API がリクエストを受け取り、投稿をキューに入れ、指定されたプラットフォームで公開します。

リポジトリの内容

多くのAIエージェントエコシステム向けの プラグインマニフェスト。
各環境へのスキルのインストール方法に関する ドキュメント。
基盤となる postiz CLI の認証および使用方法に関する説明。
DeepSeek Harnessバンドル用の ヘルパースクリプト。

制限事項 / 注意点

このリポジトリ自体はAIモデルを実装するものではなく、既存のエージェントをPostizサービスに接続するものです。
postiz CLIをグローバルにインストール (npm i -g postiz) する必要があり、ユーザーはPostizアカウント/APIキーを持っている必要があります。
一部のプラットフォーム（TikTok、Instagram）では、メディアを事前にPostizにアップロードする必要があります。READMEではこれが必須ステップとして強調されています。

まとめ

postiz-agent は、Postizのソーシャルメディア自動化CLIを多くの人気AIエージェントプラットフォームのスキルとして公開するプラグインマニフェストのコレクションであり、エージェントが28以上のソーシャルネットワーク全体でプログラム的に投稿をスケジュールおよび管理できるようにします。