/post-publisher

name: post-publisher
description: "コンテンツの投稿・配信実行スキル。Typefully経由のX投稿、画像アップロード、 投稿スケジューリングを行う。 「投稿して」「スケジュール設定」「Typefullyに下書き」等で発動。"
triggers:
  - 投稿して
  - 投稿する
  - スケジュール投稿
  - Typefully
  - 下書き作成
  - 配信
  - publish
  - schedule post

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` — コンテンツ制作