Thth MCP server

THTH（ThreadsThrower・承認済み投稿の投げ手）

設計: docs/設計THTH2026-09-08.md（§8 の裁定済み。現行の設計書）。

承認済み（status: approved）の投稿ファイルを読み、静かな時間帯と最短間隔を守って 1 件だけ投げ、 post_id を書き戻して push し、投稿済みの返信を拾って追記し、走った記録と鮮度を出し、 走らなかったことを外部に知らせるまでを持つ。意味（何を書くか・承認・返信の解釈・採集箱への昇格）は持たない。 watchtower（~/Developer/watchtower）の隣に同じ流儀で並べる。watchtower は POST しないので投稿は混ぜない。

版

このソースの版は 2.11.0。現在の設計は 自分の泉、導入は 承認を押すだけ、文書の索引は docs/README.md。

版の正本は thth/VERSION（server.json はテストで一致を強制）。開発中の main には未配布の変更も含まれます。インストール済みの版は thth --version、VM の版と revision は thth board で確認してください。

main への push は保存だけ。release を進める操作が配布（VM は release だけを追う。設計 §3.2.1）。

使う人へ

各プロジェクトのセッションが読むのは docs/使い方プロジェクトのセッション向け2026-09-09.md だけ。設計書は作った側の記録なので読まなくてよい。

2.12 のローカル実装候補

管理者用の サーバ書込、停止・退出、X 読取予算 を追加しています。配布・本番検収とは別です。X の認可・refresh の本人読取も予算対象で、既定 USD 0 のままでは token 交換前に停止します。X 投稿・採集 adapter はまだありません。

認可（2.11.0）

招待した利用者は、masaru がサーバ側で始めた認可 URL を開いて承認します。利用者に VM や Meta アプリの準備を求めません。Threads/Mastodon/X は thth auth --by masaru、Bluesky は秘密管理ツールから App Password を thth token set --stdin --by masaru へ渡します。X は認可だけ対応し、投稿・採集は未対応です。「接続」ページはこの版にはありません。

運営者の client 設定、貼付の逃げ道、scope と doctor 観測、X の更新間隔の限界は 統一ガイド にまとめています。認可の成功で承認・digest・production の条件は変わりません。

実装と運用の状態（2026-09-18）

2.7.0 の実装 revision f331e8c の全件テストは 2743 件（python -m pytest tests/ -q -n auto -p no:cacheprovider・1 skip・rc=0）。開発中の変更の検証は対象 revision の CI を参照してください。

媒体: Threads（稼働）・Bluesky・Mastodon（同席用の台帳あり・未稼働）。

定期実行中: Threads の 3 アカウント（nigamilab・asmon 関東・kopicha）。masaru の Threads は同席用です。 timer（systemd・thth systemd で生成）は10分ごとに実行し、投稿間隔と静かな時間帯を尊重します。返信の採集（thth replies）と数の採集 （thth measured）は稼働、トークン更新は thth maintain が毎日。

入口は 4 つ: 厚い CLI（bin/thth・python -m thth）、薄い MCP（mcp/server.py・読み取りと 同席の投稿・beforeyoupost）、timer、そして pip install（thth・thth-mcp の entry point・ 依存 0。PyPI に公開済み・MCP registry に io.github.aokings/thth として登録済み）。

トピックの棚（thth topics）: 観測者ごとに並ぶ・打ち消し retract-note・history。

v2.8.0: Bluesky／Mastodon のタグ

台帳の hashtags: true では本文のタグと topic を使えます。topic: 茶 は公開本文の末尾に #茶 を付け、同じタグが既にあれば重ねません。hashtags: false ではタグを追加せず、topic が効かないことを警告します。maxhashtags は公開本文のタグの上限（省略時 3、0 以上の整数）です。承認の指紋はタグを含む公開本文を使うため、以前の本文で承認した原稿は approvalstale になり、再確認・再承認が必要です。

where／topics --search の JSON は by_tag にタグ検索・観測の結果を分けます。ローカルの期間比較は thth analytics-report --compare-previous --by tag --json。API で確認できたタグだけを使い、未観測はタグなしと混ぜません。媒体をまたぐ合算はしません。利用手順・2.8.0 リリースノート。

v2.7.0 の変更

• 指標採集に720時間（30日）を追加し、対象窓を刻みから38日と計算。正常時は指標6回、返信は従来の5回です。返信の採集窓は独立して維持します。
• 新しい観測に、採取時刻以前48時間以内で最も新しい日次フォロワー数を文脈として添えます。followerscountat と stalenesshours を含み、追加APIや過去行の後補完はありません。該当しない場合は contextreason に理由を残します。
• Threads・Bluesky・Mastodonの刻みを揃え、媒体にないviewsはnullのまま維持。合成検証と限界。実SNS APIでの30日後採集は未確認です。
• C3・C4は実装保留。独立規約照合報告の未確認事項とApp Reviewの結果を踏まえて別途判断します。

v2.6.0 の変更

• 既存台帳から刻み別の値、中央値の IQR・min・max、枝別の帰結、採集成否と鮮度、層別比較、採集時刻を上限とした枝の形を追加。既存キーは維持し schema_version=1 のままです。
• cannotsaydetails にコードと既存の説明文を併記。施策レポートには未成熟投稿が24時間に達する予定を添え、採集保証とは分けます。
• handoff-report --since-last-read で保存済みsnapshotとの差分。cursor保存は CLI の --mark-read --by 名前 を明示したときだけ。MCP・HTTPは読むだけです。
• API呼出を増やさない分析の改良です。VM5accountの読取検証と限界は 検証記録 に記載。Bluesky/Mastodon の非空実台帳と実採用施策の検証は未確認です。

v2.5.0 の変更

Shortened. The full README is on GitHub.