THTH

THTH は、AI と一緒に SNS の投稿を作成・管理するためのコマンドラインツールです。Threads、Bluesky、Mastodon に対応しています。

いつものエディタや AI エージェントで下書きを作り、内容を確認して承認すると、予約した時刻に投稿されます。原稿も投稿後の記録も、自分の Git リポジトリで管理できます。

pip install thth

使い方

下書きは Markdown ファイルに保存します。本文のほか、投稿先のアカウントや予約時刻、トピックなどを指定できます。

まず、投稿する内容を確認します。

thth approve docs/sns/queue/2026-09-14-oolong.md

本文と投稿先などが表示されます。この段階では、まだ承認されません。

内容がよければ、表示された確認コードと承認者の名前を付けて、もう一度実行します。

thth approve docs/sns/queue/2026-09-14-oolong.md --confirm <確認コード> --by masaru

承認した下書きは、タイマーを設定しておけば自動で投稿されます。承認後に本文や投稿先、予約時刻などを変更した場合は、あらためて承認が必要です。

投稿したあとの管理も

投稿が完了すると、原稿に投稿 ID が記録されます。返信や閲覧数も取得して、同じリポジトリに保存できます。投稿の履歴をたどったり、次の原稿を考えるときの資料として使えます。

招待した利用者は認可 URL を開いて承認し、masaru がアプリ・サーバ・台帳を管理します。利用者が VM や Meta アプリを用意する必要はありません。接続ページは今後の実装です。

AI エージェントから使う

MCP サーバと Claude Code 用のスキルを同梱しています。コマンドラインから直接使うほか、AI エージェントとやり取りしながら下書きや投稿の記録を扱えます。

認可と運営者の設定

Mastodon の auth は expires_in または refresh_token を返す非標準実装に未対応です。手動 token set も期限・更新情報を受け取らず期限なしとして保存するため、その回避策にはなりません。

masaru がサーバ側で thth auth <account> --by masaru を開始し、利用者が URL を開いて承認します。Threads・対応 Mastodon・X の共通入口です。X は認可だけ対応し、投稿・採集は未対応。Bluesky は App Password の stdin 入力です。

導入: 承認を押すだけ（利用者と masaru の手順）

English

THTH is a command-line tool for drafting and publishing social media posts with AI. It supports Threads, Bluesky, and Mastodon.

Review and approve a draft, then let THTH publish it at the scheduled time. Drafts, published post IDs, replies, and view counts are stored in your own Git repository. Masaru operates the server and apps; invited users approve an authorization URL. X is authorization-only. A connection page is not implemented yet.

GitHub ／ PyPI ／ MCP Registry ／ llms.txt