| 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"
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は画像直接アップロード非対応。ワークフロー:
- 画像をcatbox.moeにアップロード
- Typefully下書きにテキストのみ投稿
- 画像URLをコメントで付記（手動添付が必要な場合あり）
投稿ワークフロー
単発投稿
marketing/drafts/ からコンテンツ読み込み（またはcontent-creatorで生成）- プラットフォーム確認
- Typefully APIで下書き or スケジュール作成
- 確認メッセージ送信
バッチ投稿
marketing/drafts/ 内の複数コンテンツ読み込み- スケジュール配分（時間帯最適化）
- 一括API呼び出し
- 結果サマリー送信
最適投稿時間（日本市場）
| 曜日 | 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 — コンテンツ制作
