Postatron MCPサーバー
コミット 2026年11月10日AIクライアントを使用して、X、Instagram、LinkedIn、TikTok、YouTubeなどのプラットフォームにわたるソーシャルメディア投稿のスケジュール設定、公開、および測定を行います。
別名 henrwal/postatron-cli, postatron-cli
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.15.1
- 最終コミット
- 2026年11月10日
- ライセンス
- MIT
Postatron MCPとは
PostatronはMCPサーバーです。 AIクライアントを使用して、X、Instagram、LinkedIn、TikTok、YouTubeなどのプラットフォームにわたるソーシャルメディア投稿のスケジュール設定、公開、および測定を行います。.
プロジェクトのREADMEから生成された概要
Postatron MCP server について
Postatronは、開発者やAIエージェントがX、Instagram、LinkedIn、TikTok、YouTubeを含む複数のプラットフォームにわたってソーシャルメディアのプレゼンスを管理するための手段を提供します。コンテンツのスケジュール設定、接続された複数のアカウントへの同時投稿、およびアナリティクスを通じたパフォーマンスの監視が可能です。このシステムは、適切なプロファイルの特定、タイムゾーンの計算、プラットフォーム固有の制限の遵守といった複雑なワークフローを処理できるように設計されています。
ユーザーは、api.postatron.comでホストされているリモートMCP server経由で接続するか、APIキーを使用してpostatron-mcpバイナリを使い、stdio経由でローカルMCP serverを実行できます。Claude Desktop、Claude Code、Cursor、Gemini CLIとの統合が可能です。リモート接続の認証にはOAuth 2.1を使用し、ローカル設定ではスコープ付きのAPIキーが必要です。また、直接的なプログラム制御のためのCLIおよびREST APIも提供されています。
できること
- 1マルチプラットフォーム投稿のスケジュール設定AIエージェントが単一のコンテンツを受け取り、LinkedInとXに特定の時間で表示されるようスケジュールできます。
- 2ソーシャルメディアのパフォーマンス監視開発者が特定の期間におけるエンゲージメントデータの要約をリクエストできます。
- 3コンテンツキューの自動化コンテンツが自動的にリリースされる特定のタイムスロットを作成できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Postatron MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにPostatron MCPをインストール
$ claude mcp add --transport http postatron-cli https://api.postatron.com/mcpCursorにPostatron MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"postatron-cli": {
"url": "https://api.postatron.com/mcp"
}
}
}VS CodeにPostatron MCPをインストール
.vscode/mcp.json
{
"servers": {
"postatron-cli": {
"type": "http",
"url": "https://api.postatron.com/mcp"
}
}
}VS Code CLIにPostatron MCPをインストール
$ code --add-mcp '{"name":"postatron-cli","type":"http","url":"https://api.postatron.com/mcp"}'CodexにPostatron MCPをインストール
$ codex mcp add postatron-cli --url https://api.postatron.com/mcpCodex config.tomlにPostatron MCPをインストール
~/.codex/config.toml
[mcp_servers.postatron-cli] url = "https://api.postatron.com/mcp"
Gemini CLIにPostatron MCPをインストール
$ gemini mcp add -s user --transport http postatron-cli https://api.postatron.com/mcpGemini settings.jsonにPostatron MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"postatron-cli": {
"url": "https://api.postatron.com/mcp",
"type": "http"
}
}
}設定
POSTATRON_API_KEY
| 名前 | 説明 | 種類 |
|---|---|---|
| POSTATRON_API_KEY | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能henrwal/postatron-cli is public and reachablegithub.com/henrwal/postatron-cli ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-10github.com/henrwal/postatron-cli ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見るpostatron-cli
Command line client and MCP server for Postatron, a social media scheduler that publishes one post to every platform you have connected.
This repository holds everything you need to drive Postatron from a terminal or from an AI agent. The service itself is closed source.
cmd/postatron- the CLI.cmd/postatron-mcp- a local MCP server over stdio, for clients that cannot reach a remote one.apiv1- a Go client for the REST API, and the request and response types the API itself is built on.
Connect Claude (no install)
Postatron hosts its MCP server at:
https://api.postatron.com/mcp
In Claude, Postatron is in the connector directory: Settings → Connectors → Browse connectors, find Postatron and click Connect, or open https://claude.ai/directory/postatron. Or add it by hand as a custom connector (Settings → Connectors → Add custom connector) with the URL above. Either way, sign in to Postatron when asked.
Claude Code: install the plugin, which connects the server and adds the Postatron skill in one step.
/plugin install postatron --marketplace henrwal/postatron-cli
Run it inside Claude Code in a terminal (v2.1.275 or later); it asks to add the Postatron marketplace, then installs.
The Claude desktop app has no /plugin command: there, add the connector URL above instead.
Then run /mcp and sign in to Postatron.
To connect the server alone, without the skill:
claude mcp add --transport http postatron https://api.postatron.com/mcp
Cursor: install the Postatron plugin from the Cursor Marketplace once it is listed, or add the server with one click: Add to Cursor. Cursor signs you in to Postatron the first time it uses it.
Gemini CLI: install the extension, which connects the server and adds the Postatron skill, then sign in.
gemini extensions install https://github.com/henrwal/postatron-cli
Then run /mcp auth postatron in Gemini CLI.
Any client that supports remote MCP servers with OAuth 2.1 and dynamic client registration works the same way. There is no key to copy: the client registers itself and you approve it on a Postatron consent page.
Agent skill
npx skills add henrwal/postatron-cli
Installs the postatron skill into Claude Code, Codex, Cursor and the other agents the skills CLI supports.
In Claude Code the plugin above already includes it.
It teaches the agent the workflow behind a request such as "schedule this to LinkedIn and X tomorrow at 9am": find the right profile, work out the time in your timezone, respect each platform's limits, attach media and confirm before anything is published.
It works through the MCP tools when they are connected, and through the CLI or REST otherwise.
Install the CLI
Download a binary for your platform from Releases, or build from source with Go 1.23 or newer:
go install github.com/henrwal/postatron-cli/cmd/postatron@latest
go install github.com/henrwal/postatron-cli/cmd/postatron-mcp@latest
Get an API key
Create one at postatron.com/dashboard/api. Keys are scoped, and the key is shown once at creation. The API, the MCP server and the CLI are included on every paid plan.
export POSTATRON_API_KEY=ptn_your_key_here
POSTATRON_API_URL overrides the API host if you need it to.
Use the 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>
Add --json to any command for the raw API response.
Full reference in docs/cli.md.
When a post fails
Every failed delivery carries an error_code that says what to do: reconnect (sign the account in again with connect-account --account-id, or connect_account over MCP), rate_limited, platform_unavailable and postatron (retry), media_rejected and validation (make a new post with the change), policy and unknown (read the message).
retry-post (retry_post) sends the post again to the accounts it failed on, never to one it already reached, and is not charged again.
list-events (list_events) reads the same log as the dashboard's Logs page.
Webhooks
A webhook POSTs a signed JSON event to your own server when a post publishes, partly publishes or fails, and when an account is connected, disconnected or needs reconnecting.
Set one up in the dashboard, with POST /v1/webhooks or with postatron webhooks create, and check each request's Postatron-Signature with its secret; docs/api.md has the rules and a Go, Node and Python check.
Profiles
A profile groups connected accounts, usually one per brand or client, and holds at most one account per platform.
Everyone has a Default profile; paid plans can add more.
Pass --profile (CLI) or profile (API and MCP) to post as one brand.
When a platform has accounts in more than one profile, posting by platform without a profile is refused rather than sent to every brand at once.
Local MCP server
For clients that only launch local servers, postatron-mcp exposes the same tools over stdio with an API key.
Claude Desktop, in claude_desktop_config.json:
{
"mcpServers": {
"postatron": {
"command": "postatron-mcp",
"env": { "POSTATRON_API_KEY": "ptn_your_key_here" }
}
}
}
Details in docs/mcp.md.
OpenAPI
The REST API is described in OpenAPI 3.1 at api.postatron.com/v1/openapi.json, webhooks included, and fetching it needs no key.
Use it to generate a client in any language, or hand it to an agent; in Go the same document is apiv1.OpenAPI.
Documentation
- docs/api.md - REST API reference, auth, rate limits, errors.
- apiv1/openapi.json - the OpenAPI 3.1 description the API serves.
- docs/mcp.md - MCP tools and client setup.
- docs/cli.md - every command and flag.
Licence
MIT. See LICENSE.
Postatron MCPのよくある質問
Postatron MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http postatron-cli https://api.postatron.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Postatron MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
リモートMCP serverの認証はどのように行われますか?
サーバーはOAuth 2.1と動的クライアント登録を使用します。クライアントが自身を登録し、Postatronの同意ページで接続を承認します。
Postatronをローカルで使用できますか?
はい、APIキーを使用してpostatron-mcpコマンドを実行することで、stdio経由でローカルMCP serverを動作させることができます。
投稿の配信に失敗した場合はどうすればよいですか?
エラーコードを確認してください。例えば、'reconnect'はアカウントの再ログインが必要であることを示し、'retry'はretry-postコマンドを使用して再試行できることを示します。