OpenParable
Skip to content
← Back to skills

Post Publisher

Apps & Automation
post-publisher

Post Publisher is an Agent Skill for apps & automation published in the minicoohei/ai-agent-camp repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

コンテンツの投稿・配信実行スキル。Typefully経由のX投稿、画像アップロード、 投稿スケジューリングを行う。 「投稿して」「スケジュール設定」「Typefullyに下書き」等で発動。

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/minicoohei/ai-agent-camp/blob/HEAD/.claude/skills/post-publisher/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/post-publisher, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Post Publisher

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

対応プラットフォーム

プラットフォーム方法ステータス
X (Twitter)Typefully API✅ 対応
X スレッドTypefully API✅ 対応
LinkedInTypefully API✅ 対応
Instagram手動 / Meta API(要実装)🔧 計画中
TikTok手動 / TikTok API(要実装)🔧 計画中
Note手動 / API(要調査)🔧 計画中
MediumMedium 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. 結果サマリー送信

最適投稿時間(日本市場)

曜日XInstagramTikTok
平日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 — コンテンツ制作