Post Publisher

制作済みコンテンツを各プラットフォームに投稿・スケジューリングする。

対応プラットフォーム

プラットフォーム	方法	ステータス
X (Twitter)	Typefully API	✅ 対応
X スレッド	Typefully API	✅ 対応
LinkedIn	Typefully API	✅ 対応
Instagram	手動 / Meta API（要実装）	🔧 計画中
TikTok	手動 / TikTok API（要実装）	🔧 計画中
Note	手動 / API（要調査）	🔧 計画中
Medium	Medium API	🔧 計画中

Typefully API v2

認証

環境変数: TYPEFULLY_API_KEY ヘッダー: Authorization: Bearer $TYPEFULLY_API_KEY

social_set_id の取得（必須）

v2 では全エンドポイントに social_set_id が必要。先に取得しておく。

curl -X GET "https://api.typefully.com/v2/social-sets" \
  -H "Authorization: Bearer $TYPEFULLY_API_KEY"
# レスポンスから id を取り、環境変数に保存
export TYPEFULLY_SOCIAL_SET_ID="取得した値"

エンドポイント

下書き作成（X 単発）

curl -X POST "https://api.typefully.com/v2/social-sets/$TYPEFULLY_SOCIAL_SET_ID/drafts" \
  -H "Authorization: Bearer $TYPEFULLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": {
      "x": {
        "enabled": true,
        "posts": [{"text": "投稿テキスト"}]
      }
    },
    "publish_at": "2025-01-15T09:00:00Z"
  }'

スレッド投稿

posts 配列に複数エントリを並べる（v1 の \n\n\n\n + threadify は廃止）。

{
  "platforms": {
    "x": {
      "enabled": true,
      "posts": [
        {"text": "1/🧵 フック"},
        {"text": "2/ 本題"},
        {"text": "3/ CTA"}
      ]
    }
  }
}

スケジュール投稿

• publish_at: ISO 8601 形式（UTC）
• publish_at: "next-free-slot" で次の空きスロットに自動配置

X と Threads 同時投稿

{
  "platforms": {
    "x":       {"enabled": true, "posts": [{"text": "テキスト"}]},
    "threads": {"enabled": true, "posts": [{"text": "テキスト"}]}
  },
  "publish_at": "next-free-slot"
}

画像付き投稿

Typefully APIは画像直接アップロード非対応。ワークフロー:

1. 画像をcatbox.moeにアップロード
2. Typefully下書きにテキストのみ投稿
3. 画像URLをコメントで付記（手動添付が必要な場合あり）

投稿ワークフロー

単発投稿

1. marketing/drafts/ からコンテンツ読み込み（またはcontent-creatorで生成）
2. プラットフォーム確認
3. Typefully APIで下書き or スケジュール作成
4. 確認メッセージ送信

バッチ投稿

1. marketing/drafts/ 内の複数コンテンツ読み込み
2. スケジュール配分（時間帯最適化）
3. 一括API呼び出し
4. 結果サマリー送信

最適投稿時間（日本市場）

曜日	X	Instagram	TikTok
平日	7-8時, 12時, 18-21時	12時, 18-21時	18-22時
土日	9-11時, 14-16時	10-12時, 15-17時	12-22時

ログ

投稿結果を marketing/post-log.md に記録:

| 日時 | プラットフォーム | コンテンツ要約 | URL | ステータス |

関連スキル

• marketing-planner — 計画策定
• content-creator — コンテンツ制作