ポストメッシュ 開発者向けドキュメント
ポストメッシュのREST APIとMCPサーバーを使って、外部システムやAIエージェントからSNS投稿を自動化できます。APIキーはダッシュボードから自分で発行でき、営業への問い合わせは不要です。
クイックスタート
- アカウントを作成し、投稿したいSNSアカウントをOAuthで連携する
- ダッシュボードの「APIキー」画面からAPIキーを発行する
- 発行したキーをBearerトークンとして送る
curl https://post-mesh.com/api/v1/connections \
-H "Authorization: Bearer $POST_MESH_API_KEY"APIキーの発行はセルフサービスです。営業への問い合わせや事前審査はありません。7日間の無料トライアル中でも利用できます。
エンドポイント
ベースURL: https://post-mesh.com/api/v1
| メソッド | パス | operationId | 説明 |
|---|---|---|---|
| GET | /connections | listConnections | 有効なSNSアカウント連携を返す |
| POST | /media/upload-url | createMediaUploadUrl | メディアアップロードURLを生成する |
| GET | /posts | listPosts | 投稿一覧を返す（ページネーション付き） |
| POST | /posts | createPost | 投稿を作成・予約する |
| GET | /posts/{id} | getPost | 投稿の詳細を返す |
| DELETE | /posts/{id} | cancelPost | 予約投稿をキャンセルする |
OpenAPI仕様
- YAML: /openapi.yaml
- JSON: /openapi.json
- Swagger UI: /api-reference
すべてのオペレーションに一意のoperationId、summary、descriptionが付いており、LLMのfunction callingへそのまま変換できます。
MCPサーバー
https://post-mesh.com/api/mcpREST APIと同等の6つのツールを提供します。認証はOAuth（/oauth/authorizeで同意）と、APIキーのBearerヘッダーの2種類です。OAuthのメタデータはRFC 8414 / RFC 9728に従って配信しています。
Agent Skill
npx skills add hid3h/post-mesh-agent-skills公開リポジトリ: github.com/hid3h/post-mesh-agent-skills
使い方はAIエージェント連携を参照してください。
認証とエラー
認証はAuthorization: Bearer <APIキー>ヘッダーのみです。ヘッダーが無い、または不正な場合は401とJSONを返します。
{ "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid Authorization header" } }エラーは常にerror.codeとerror.messageを持つJSONで返します。
| HTTPステータス | code | 意味 |
|---|---|---|
| 400 | VALIDATION_ERROR | リクエストのバリデーションに失敗 |
| 400 | TIKTOK_PRIVACY_LEVEL_UNAVAILABLE | そのTikTokアカウントでは選べない公開範囲を指定した |
| 401 | UNAUTHORIZED | APIキーが未指定または無効 |
| 403 | SUBSCRIPTION_REQUIRED | 有効なサブスクリプションが必要 |
| 404 | NOT_FOUND | リソースが見つからない |
| 409 | POSTING_READINESS_RECONNECT_REQUIRED | 投稿作成時、投稿先のSNS連携が切れており再連携が必要 |
| 409 | POSTING_READINESS_UNAVAILABLE | 投稿作成時、SNS側の一時的なエラーで投稿準備を確認できなかった |
| 409 | CONFLICT | 予約投稿をキャンセルできない状態（処理中・キャンセル済み・即時投稿） |
| 500 | INTERNAL_ERROR | 内部サーバーエラー |
制限
- Xへの投稿はスタータープランで月30件までです。X以外のSNSへの投稿に件数制限はありません。
- 接続できるSNSアカウント数はスタータープランで10です。
- 1回の投稿で配信できるSNSは投稿種別ごとに決まっています。テキストはX・Threads・Facebook、画像はX・Instagram・Threads・TikTok・Facebook、動画はX・Instagram・Threads・TikTok・YouTube、ツリー投稿（category: tree）はX・Threadsです。対応していないプラットフォームを投稿先に含めると400 VALIDATION_ERRORになります。
- サンドボックス環境は提供していません。7日間の無料トライアルで本番環境をそのままお試しください。
動作確認用エンドポイント
認証なしで到達できます。
curl https://post-mesh.com/health
# {"status":"ok"}質問がある場合
お問い合わせから、実行したリクエストと返ってきたレスポンスを添えてご連絡ください。