X/Twitter投稿
Publora MCPサーバーを使用してX（Twitter）への投稿を作成・スケジュールします。テキスト投稿、画像（最大4枚）、動画、および長文コンテンツの自動スレッド分割に対応しています。
前提条件
プラン： 有料プランが必要です（X APIコストは実費請求）。現在の制限と料金はこちら：publora.com/pricing をご確認ください。
重要： Twitter APIコストのため、無料のStarterプランではX/Twitterを利用できません。
はじめに
- アカウントを作成 publora.com/register
- ProまたはPremiumプランを選択（X/Twitterは有料プランが必要）
- PubloraダッシュボードでOAuth経由でX/Twitterを接続 app.publora.com/dashboard
- APIキーを取得 app.publora.com/dashboard/api
- エージェントをMCPサーバーに接続（
https://mcp.publora.com、認証はAuthorization: Bearer sk_YOUR_API_KEYヘッダー）。Claude Codeの例：
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_YOUR_API_KEY"
Claude Desktop、Cursor、Codex、OpenClaw、claude.aiコネクタにはそれぞれ異なる設定ファイルまたはフローが必要です。正確なパスとスニペットについてはクライアント設定を参照してください。
REST APIフォールバック
MCPが利用できない場合は、REST APIを直接使用します。
ベースURL： https://api.publora.com/api/v1
認証： x-publora-keyヘッダー
# 接続済みプラットフォームを取得
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_your_api_key"
# 投稿を作成
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["twitter-123456789"],
"content": "ツイート内容",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
プラットフォームID形式： twitter-{id}（例：twitter-123456789）
📖 ドキュメント： docs.publora.com
プラットフォーム制限
| 機能 | API制限 | 備考 |
|---|---|---|
| 文字数 | 280 | 絵文字は2文字としてカウント |
| 画像 | 最大4枚 | 自動でPNGに変換（最大幅1000px） |
| 動画時間 | 2分20秒（140秒） | PubloraはXの動画を140秒で検証 |
| 動画サイズ | 512 MB | MP4、MOV形式 |
| スレッド化 | 自動 | 280文字超のコンテンツは(1/N)マーカーで分割 |
文字カウント
Xには独自の文字カウントルールがあり、Publoraが自動的に処理します。
- 標準文字 = 1
- 絵文字 = 2文字
- URLはリテラル長でカウント
- スレッドマーカーはツイートごとに10文字を予約
自動スレッド化
コンテンツが280文字を超える場合、Publoraは自動的に接続されたスレッドを作成します。
- コンテンツを段落区切り、次に文の区切り、最後に単語の区切りで分割
- 各部分に
(1/N)、(2/N)の形式で番号を付与 - Xの
reply_to_idパラメータを使用してツイートを接続
手動スレッド区切り
---を単独の行に記述すると、強制的にスレッドを分割できます。
これがスレッドの最初のツイートです。
---
これがスレッドの2番目のツイートです。
---
そしてこれが3番目のツイートです！
利用可能なツール
create_post
新しいX/Twitterの投稿またはスレッドを作成します。
パラメータ：
platforms：X接続IDを含む配列（例：["twitter-12345678"]）content：投稿テキスト（280文字を超えると自動スレッド化）scheduledTime：ISO 8601 UTC日時。オプション: 省略すると下書きとして作成されます。未来の時間を指定するとスケジュール投稿になります。5分以上過去の時間はSCHEDULED_TIME_IN_PASTエラーで拒否されるため、即時投稿の場合は現在時刻+1分を指定してください。mediaUrls：最大10個の公開https画像または動画URL。Publoraがサーバーサイドでダウンロードし、検証前に添付します。これにより、メディアとスケジュールを1回の呼び出しで処理できます。これは、下書き作成→get_upload_url→complete_mediaフローのワンショット代替手段です。取り込みは1時間あたり60URLにレート制限されています。
get_upload_url
メディアアップロード用の署名付きURLを取得します。
パラメータ：
postGroupId：メディアを添付する投稿IDfileName：ファイル名（例："image.png"、"video.mp4"）contentType：image/png、image/jpeg、video/mp4type："image"または"video"
complete_media
署名付きPUTが成功した後、get_upload_urlを通じてアップロードされたファイルを確定します。スケジュール設定でも保留中のメディアは確定されますが、このツールを早期に呼び出すことで、公開前にフォーマットやプローブエラーを検出できます。mediaUrlsで添付されたメディアには不要です。
パラメータ：
mediaId：get_upload_urlから返されたID
list_connections
接続済みアカウントをプラットフォームIDとともに一覧表示します。最初にこれを呼び出し、IDをそのままコピーしてください。IDは推測不可能です。
list_posts / get_post / update_post / delete_post
スケジュール済みおよび下書きの投稿を管理します。update_postは下書きまたはスケジュール済み投稿のcontentとplatformsも更新できるため、タイプミスの修正やターゲットの変更を削除と再作成なしで行えます。delete_mediaとprune_media_referenceでアップロード済みファイルをクリーンアップできます。
使用例
シンプルなツイート
これをXに投稿してください：
"新しいAPIドキュメントをリリースしました。ぜひチェックしてみてください！"
画像付きツイート
新しいダッシュボードのスクリーンショットを添えてTwitterに投稿：
"リデザイン前と後。どう思いますか？"
注：画像は最大4枚まで。すべての画像は自動的にPNGに変換されます。
長文スレッド
Twitterスレッドを作成：
"スレッド：スタートアップを構築して学んだ5つの教訓
---
1. 早く出荷して、素早く反復する。私たちはバグだらけのMVPでローンチし、実際のフィードバックに基づいて改善しました。
---
2. 毎日ユーザーと話す。最高の機能は顧客との会話から生まれました。
---
3. 機能よりも集中。うまくいった1つの製品に集中するため、3つの製品をやめました。"
スケジュールツイート
これを明日の午前9時にスケジュール：
"月曜日のモチベーション：準備ができる前に始めよう。"
重要な制限事項
-
Proプラン必須：Twitter APIコストのため、X/Twitterは無料のStarterプランでは利用できません。
-
140秒の動画制限：PubloraはXの動画を2分20秒（140秒）で検証します。それより長い動画は検証に失敗します。
-
画像自動変換：すべての画像はアップロード前にPNG（最大幅1000px）に変換されます。アニメーションGIFはアニメーションを失います。
-
画像と動画の混合不可：1つのツイートには画像または動画のどちらか一方のみ添付できます。
-
スレッド内のメディアは最初のツイートのみ：スレッドでは、画像・動画は最初のツイートにのみ添付されます。
ベストプラクティス
コンテンツ
- 最初の行でフック：エンゲージメントのほとんどは最初のツイートで発生
- 最適なスレッド長：エンゲージメントを最大化するには3〜7ツイート
- 絵文字の認識：絵文字は2文字としてカウントされることを忘れずに
タイミング
- 最適な時間帯：ターゲットタイムゾーンの8〜10時、12〜13時、17〜18時
- 頻度：成長のためには1日3〜5ツイート
- スレッド：最大の可視性を得るために朝に投稿
エンゲージメント
- 最初の1時間以内にコメントに返信
- 自分のスレッドを引用ツイートして可視性を高める
- 関連するハッシュタグを使用（ツイートあたり1〜2個）
トラブルシューティング
| エラー | 原因 | 解決策 |
|---|---|---|
| "X/TwitterにはProプランが必要です" | Starterプランを使用中 | publora.com/settings でProにアップグレード |
| "コンテンツが長すぎます" | 280文字を超え、スレッド化に失敗 | 手動で---区切りを追加 |
| "動画が長すぎます" | 140秒を超えている | 動画を2分20秒未満にトリミング |
| "画像が多すぎます" | 4枚を超えている | 4枚以下に減らす |
| "レート制限に達しました" | X API制限に到達 | 待ってから再試行 |