Post for Me MCP Pro

postforme-mcp-pro 📱

最も充実した Post for Me MCP サーバーです。あらゆる MCP クライアントから、9 つのプラットフォームでソーシャル投稿の公開、予約、編集、削除、分析ができます。

postforme-mcp-pro は Post for Me API を、27 種類以上の完全に型付けされた MCP ツール（各操作に 1 つ）にラップし、さらに postforme_raw という汎用の代替手段と読み取り専用のセーフティモードを備えています。ドキュメント検索とサンドボックス化されたコード実行ツール（「コードモード」）しか公開しない公式 MCP とは異なり、ここではすべての操作が第一級の直接呼び出し可能なツールとして用意されているため、モデルは SDK コードを書かずに投稿、予約、分析データの取得を行えます。

プラットフォーム： Instagram · Facebook · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Threads

このサーバーを選ぶ理由

• 27 個以上の型付きツール — create_post、schedule_post、publish_now、create_draft、upload_media、list_account_feeds、list_post_results、アカウントとウェブフックの管理などに対応しています。
• 高レベルのショートカット — publish_now／schedule_post／create_draft／reschedule_post／upload_media を使えば、よくある複数ステップのワークフローを 1 回の呼び出しにまとめられます。
• 1 ステップでメディアをアップロード — upload_media にローカルファイルのパスまたは公開 URL を渡すと、署名付き URL を取得し、データをアップロードして、添付できる状態の media_url を返します。
• プラットフォームごとの調整 — platform_configurations は Instagram Reels、X の投票、TikTok のプライバシー設定、YouTube の公開範囲などをモデル化し、新しいオプションにも柔軟に対応します。
• 読み取り専用のセーフモード — POSTFORME_READONLY=true を設定すると、すべての書き込みがブロックされます。分析のみを行うセッションに最適です。
• postforme_raw — 新しいエンドポイントも含め、任意のエンドポイントを呼び出して API を 100％利用できます。
• 堅牢なクライアント — Bearer 認証、バックオフを伴う 429／5xx エラー時の再試行、具体的なエラーメッセージに対応しています。

インストール

npm install
npm run build

または、クローンせずに公開済みのものを実行できます（リリース後）。

npx -y postforme-mcp-pro

設定

.env.example を .env にコピーし、キーを設定します。

変数	必須	説明
POSTFORME_API_KEY	✅	Post for Me の API キー（Dashboard → Settings → API Keys）。
POSTFORME_BASE_URL	—	セルフホスト／オープンソースのデプロイで API のベース URL を上書きします。既定値は https://api.postforme.dev です。
POSTFORME_READONLY	—	true にすると、すべての書き込みツールがブロックされます（読み取りと postforme_raw の GET のみ実行されます）。
POSTFORME_DISABLE_RAW	—	true にすると、postforme_raw ツールが削除されます。
POSTFORME_TIMEOUT_MS	—	リクエストごとのタイムアウト（既定値は 60000）。
POSTFORME_MAX_RETRIES	—	429／5xx／ネットワークエラー時の最大再試行回数（既定値は 3）。

ローカルでテストする

npx @modelcontextprotocol/inspector node dist/index.js

Claude Code に追加する

.claude/settings.json の mcpServers に追加します。

"postforme": {
  "command": "node",
  "args": ["projects/postforme-mcp-pro/dist/index.js"],
  "env": { "POSTFORME_API_KEY": "pfm_xxx" }
}

Claude Desktop に追加する

%APPDATA%\Claude\claude_desktop_config.json（Windows）／~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

"postforme": {
  "command": "node",
  "args": ["/abs/path/projects/postforme-mcp-pro/dist/index.js"],
  "env": { "POSTFORME_API_KEY": "pfm_xxx" }
}

Cursor では、MCP ファイルで同じ形式の設定を使用します。

ツール

ソーシャルアカウント

ツール	説明
list_social_accounts	接続済みアカウントを一覧表示します（プラットフォーム／ユーザー名で絞り込み可能）。
get_social_account	ID でアカウントを 1 件取得します。
create_social_account	認証情報を指定してアカウントを接続します。
update_social_account	保存済みの認証情報／メタデータを更新します。
create_auth_url	OAuth 接続フローを開始します（URL を返します）。
disconnect_social_account	アカウントのアクセス権を取り消します。
list_account_feeds	**分析：**アカウントの最近のフィードとエンゲージメント指標を取得します。

投稿

ツール	説明
create_post	アカウントに投稿を作成します（即時公開、予約投稿、または下書き）。
publish_now	ショートカット：すぐに公開します。
schedule_post	ショートカット：ISO 8601 形式の日時で予約投稿します。
create_draft	ショートカット：下書きとして保存します。
get_post	ID で投稿を取得します。
list_posts	投稿を一覧表示します（ステータスで絞り込み可能）。
update_post	キャプション／メディア／アカウント／スケジュール／設定を編集します。
reschedule_post	ショートカット：予約日時を変更します。
delete_post	投稿を削除します。

結果とプレビュー

ツール	説明
list_post_results	**分析：**プラットフォームごとの公開結果を取得します。
get_post_result	ID で投稿結果を 1 件取得します。
create_post_preview	プラットフォームごとの投稿の表示をプレビューします。

メディア

ツール	説明
create_media_upload_url	署名付きアップロード URL を取得します（2 ステップのフロー）。
upload_media	**1 ステップ：**ローカルファイルまたはリモート URL からアップロードし、media_url を返します。

ウェブフック

ツール	説明
list_webhooks · get_webhook · create_webhook · update_webhook · delete_webhook	イベントのサブスクリプションを管理します。

回避手段

ツール	説明
postforme_raw	任意の /v1/... エンドポイントを直接呼び出します（メソッド、パス、パラメーター、本文）。

コンパニオンスキル

skill/SKILL.md にある /postforme は、これらのツールをガイド付きワークフロー（post、schedule、campaign、analytics、accounts、media）として組み合わせます。Claude Code で使用するには、.claude/skills/ にコピーしてください。

例

You: post "Lançamos a v2 🚀" no instagram e no x, com a imagem ./hero.png
→ list_social_accounts            (get the instagram + x account ids)
→ upload_media { file_path: "./hero.png" }   → media_url
→ create_post_preview             (optional, confirm look)
→ publish_now { social_accounts: [...], caption: "...", media: [{ url: media_url }] }
→ list_post_results               (report success/links per platform)

公式 MCP との比較

	postforme-mcp-pro	公式の post-for-me-mcp
ツールモデル	27 個の型付きツール（操作ごとに 1 個）	2 個のツール（ドキュメント検索＋コード実行サンドボックス）
呼び出し	ツールを直接呼び出します	モデルがサンドボックス内で SDK コードを記述する必要があります
ショートカット	publish_now / schedule_post / create_draft / upload_media	—
安全性	POSTFORME_READONLY モード＋SSRF／ファイル読み取り対策の強化	—
回避手段	postforme_raw（任意の /v1 エンドポイント）	コード実行
コンパニオンスキル	/postforme のガイド付きワークフロー	—

セキュリティ

upload_media は、SSRF 対策としてリモート取得を強化し（DNS 解決＋パブリックユニキャスト IP の検証、リダイレクトなし、サイズ上限）、ローカルファイルの読み取りを認識済みのメディア拡張子に制限します（POSTFORME_MEDIA_DIR を指定すると、そのディレクトリ内に制限できます）。postforme_raw のパスは、バージョン付き API の範囲内に収まるよう検証されます。完全な監査結果は REVIEW.md を参照してください。

ライセンス

MIT © Helbert Paranhos / Strat Academy