publora/threads-post

Threads Post

Publora MCPサーバーを使用してMetaのThreadsに投稿を作成・予約します。単一投稿、画像カルーセル（2～20枚）、返信制御に対応。現在、プラットフォーム接続によりマルチパートスレッドは無効になっています。

前提条件

プラン: 無料のStarterプランで動作します。現在の制限と価格: publora.com/pricing

はじめに

1. アカウントを作成 publora.com/register（無料）
2. Threadsを接続 Publora DashboardでInstagram OAuthを介して接続
3. APIキーを取得 app.publora.com/dashboard/api
4. エージェントを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": ["threads-12345"],
    "content": "投稿内容",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

プラットフォームID形式: threads-{id}（/platform-connections から取得）

📖 ドキュメント: docs.publora.com

プラットフォーム制限

機能	制限
投稿あたりの文字数	500
ハッシュタグ	投稿あたり最大1つ
リンク	投稿あたり最大5つ
カルーセルあたりの画像数	2～20
画像サイズ	8 MB
画像フォーマット	JPEG, PNG（WebPは自動変換）
動画長さ	5分
動画サイズ	1 GB
動画フォーマット	MP4, MOV
1日あたりの投稿数	250
1日あたりの返信数	1,000

利用可能なツール

create_post

新しいThreads投稿またはスレッドを作成します。

パラメータ:

• platforms: Threads接続IDの配列（例: ["threads-12345"]）
• content: 投稿テキスト（500文字を超える場合は自動スレッド化）
• scheduledTime: ISO 8601 UTC日時。オプション: 省略すると投稿は下書きとして作成されます。未来の時間を指定すると予約されます。5分以上過去の時間は SCHEDULED_TIME_IN_PAST で拒否されるため、即時投稿には現在時刻＋1分を使用してください。
• mediaUrls: 最大10個の公開 https 画像または動画URL。Publoraがサーバー側でダウンロードし、検証の前に添付するため、メディアとスケジュール設定が1回の呼び出しで完了します。これは、下書き→get_upload_url→complete_media フローの代替となるワンショット方法です。取り込みは1時間あたり60 URLにレート制限されています。

get_upload_url

画像をアップロードするための署名付きURLを取得します。

complete_media

get_upload_url でアップロードしたファイルを、署名付き PUT が成功した後に確定します。オプションです。スケジュール設定でも保留中のメディアは確定されますが、早期に呼び出すことで公開前にフォーマットやプローブのエラーを検出できます。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 はアップロード済みファイルを整理します。

長いコンテンツ

Threads投稿は500文字に制限されており、現在Publoraのマルチパートスレッドは無効（Threadsアプリ接続復旧中）のため、上限を超えるコンテンツは自動分割されません。そのため:

• 投稿を500文字以内に収めるか、
• 自分でパートを分割して個別に投稿するか、
• 長文版を現在スレッド機能が使えるプラットフォーム（X）に移動しリンクを貼ってください。

手動の --- 区切りや [1/3] マーカーはそのまま保持されますが、現時点では接続された返信チェーンは作成されません。復旧時期については [email protected] にお問い合わせください。

返信制御

REST APIの platformSettings を使用して、投稿に返信できるユーザーを制御します:

値	説明
""（空文字）	デフォルトのプラットフォーム動作（誰でも返信可能）
"everyone"	明示的に誰でも返信可能にする
"accounts_you_follow"	フォローしているアカウントのみ返信可能
"mentioned_only"	メンションされたアカウントのみ返信可能

注: platformSettings はMCPの create_post および update_post ツール、RAPIの両方で受け入れられます。スキーマは厳格で、誤ったプラットフォームやキーは黙って無視されるのではなく、バリデーションエラーで拒否されます。

重要な制限事項

1. 単一ハッシュタグ制限: Threadsでは投稿あたり最大1つのハッシュタグが許可されています。追加のハッシュタグはプラットフォームによって無視されます。

2. 投稿編集不可: 一度投稿されたThreads投稿はAPIで編集できません。必要に応じて削除して再投稿してください。

3. 動画カルーセル非対応: Publoraのカルーセル実装は画像のみ対応しています。単独の動画投稿は通常通り動作します。

4. マルチスレッド投稿は一時的に利用不可: コンテンツを複数の接続された返信に分割する機能は一時的に無効になっています。単一投稿とカルーセルは引き続き動作します。

使用例

シンプルなテキスト投稿

Threadsにこれを投稿してください:
「今日、2時間節約できた素晴らしい生産性ハックを発見しました。ポイントは類似タスクをまとめて処理することです。」

画像カルーセル

次の5枚の製品進化スクリーンショットでThreadsのカルーセルを作成してください。
キャプション: 「コンセプトからローンチまで - 6ヶ月の旅。#buildinpublic」

注: 2～20枚の画像が必要です。カルーセル内の動画はサポートされていません。

長いコンテンツ（個別の投稿として公開）

スレッド化は無効のため、パートを明示的に指定してください:

これをThreadsに個別の投稿として投稿してください:
「スレッド: 初めての創業者が犯した7つのミス

---

1. 採用が早すぎた。2人から3ヶ月で15人に。文化が犠牲になった。

---

2. ユニットエコノミクスを無視した。収益は良く感じられたが、CACを計算するまでは…」

予約投稿

明日の午前10時にこれを予約してください:
「月曜日のモチベーション: 始めるのに最適な時期は昨日だった。次に良い時期は今です。」

ベストプラクティス

1. 最初の2行が鍵: 最初の2行がエンゲージメントを決めます。効果的にしましょう。
2. 最適な長さ: 単一投稿は100～250文字がパフォーマンス良好です。
3. ネイティブなコンテンツ: オリジナルで会話調の投稿が評価されます。
4. 単一ハッシュタグ: 関連性の高いハッシュタグを1つ使用してください（プラットフォーム制限）。
5. 編集オプションなし: 投稿前に内容を再確認してください。

タイミング

• 最適な時間: 対象タイムゾーンの午前7～9時、午後12～1時、午後7～9時
• 頻度: 成長のために1日1～3投稿
• 一貫性: 定期的な投稿はアクティブなアカウントを示します

エンゲージメント

• 最初の1時間以内にコメントに返信する
• Instagram（アカウントはリンクされています）と相互参照する
• 発見のために関連トピック/キーワードを使用する

トラブルシューティング

エラー	原因	解決策
「アカウントが接続されていません」	Threads/Instagram OAuthの期限切れ	Publoraダッシュボードから再接続
「コンテンツが長すぎます」	投稿が500文字を超え、スレッド化に失敗	手動で --- 区切りを追加
「メディアアップロードに失敗しました」	フォーマットまたはサイズが不正	確認: 画像 < 8 MB、JPEG/PNGのみ
「カルーセルには2～20個のアイテムが必要です」	画像数が不正	カルーセルには2～20枚の画像を用意
1日250投稿超過	レート制限に達しました	24時間待機