pp-techtwitter

Tech Twitter — Printing Press CLI

前提条件：CLI のインストール

このスキルでは、techtwitter-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーでインストールします。既定では、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install techtwitter --cli-only
   

2. 確認します：techtwitter-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールが失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。この方法では $GOPATH/bin（既定値は $HOME/go/bin）にインストールされるため、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/techtwitter/cmd/techtwitter-pp-cli@latest

インストール後に --version で「command not found」と表示される場合、ランタイムから $PATH 上のバイナリディレクトリが見えていません。確認に成功するまで、スキルのコマンドを実行しないでください。

Tech Twitter は、テック関連の X の投稿から、価値の高い情報を厳選し、重複を除去して要約し、品質スコアを付けています。この CLI を使うと、そのデータをローカルの SQLite ミラーに保存してオフラインで全文検索できるほか、データを蓄積するストアだけが可能にする、前回の同期以降の変更、トピックの経時的な勢い、新たなナラティブ、過去の任意の日へのタイムトラベル、エージェント向けの引用付きオフライン証拠バンドルを扱うコマンドを利用できます。

この CLI を使用する場合

エージェントやユーザーが、Tech Twitter の厳選されたテック関連言説コーパスから、引用付きの構造化された証拠を必要とする場合、X の未加工の大量投稿ではなく、重複を除去して品質スコアを付けたストリームをオフラインで全文検索したい場合、あるいは、単一のステートレスな API 呼び出しでは回答できない経時的な変化（新しい情報、勢いを増しているもの、出現しつつあるナラティブ）について尋ねる場合に、この CLI を使用してください。

使用しないケース

次の用途には、この CLI を使用しないでください。

• X/Twitter への投稿、いいね、ブックマーク、その他の書き込み。この CLI は Tech Twitter の厳選されたコーパスに対する読み取り専用であり、X クライアントではありません。
• X から任意のツイートを取得すること。Tech Twitter が厳選したツイートのみ利用できます。
• techtwitter.com でのアカウント、請求、スポンサー、投稿申請に関する手続き。これらは認証が必要であり、対象外です。

独自の機能

この API を利用する他のツールでは、次の機能を利用できません。

蓄積されるローカル状態

• since — ストリーム全体を読み直す代わりに、前回の同期以降に厳選されたツイート、または新たに注目を集めたツイートだけを確認できます。

  再取得やコーパス全体の再スキャンをせずに「見逃したものは何か」に答える場合に利用してください。

  techtwitter-pp-cli since 24h --agent
  

• momentum — 同期ごとに保存されるヒートマップのスナップショットを横断して、上昇中、下降中、または新たに出現したトピックを確認できます。

  単一の API 呼び出しでは答えられない、経時的な変化についての質問に利用してください。

  techtwitter-pp-cli momentum --window 7d --json
  

• narrative — 以前のスナップショットと比べて新たに出現した、または加速しているキーワードを、保存された関連ツイートを根拠として提示します。

  現在大きな話題になっているものではなく、新たに出現しているものを知りたい場合は、単発のナラティブ取得よりこちらを選んでください。

  techtwitter-pp-cli narrative --json
  

• author-rank — 期間内に蓄積されたエンゲージメントに基づいて著者を順位付けし、それぞれの著者の最も優れた厳選ツイートを表示します。

  API が一度だけ選ぶその日のトップではなく、同期するたびに蓄積されるランキングを作る場合に利用してください。

  techtwitter-pp-cli author-rank --window 7d --limit 10 --json
  

• time-travel — 特定の日付（YYYY-MM-DD、today、yesterday、または latest）の厳選ツイートを、ライブまたはローカルストアから完全オフラインで表示します。

  同期後はライブ呼び出しを行わずに、指定した日にテック系 Twitter で何が話題だったかのスナップショットを取得できます。

  techtwitter-pp-cli time-travel 2026-06-07 --limit 10 --json
  

エージェント向けのオフラインエビデンス

• digest — 指定期間のローカルストアから、トップツイート、最近の記事、トップ著者のリストを作成します。

  追加の呼び出しなしで、引用付きの「テック業界で何が起きているか」の概要をエージェントに一度で渡す場合に使用します。

  techtwitter-pp-cli digest --window 24h --agent
  

• evidence — ローカルの SQLite からエージェントのコンテキスト種別を反映したエビデンスバンドルを作成します。正規の URL を引用として使用し、ネットワークには接続しません。

  エージェントに引用付きエビデンスが必要で、上流への呼び出しを行わずにローカルミラーを根拠としたい場合に使用します。

  techtwitter-pp-cli evidence read-list --agent --select evidence.title,evidence.canonicalUrl
  

コマンドリファレンス

agent — 機械エージェント向けエビデンスバンドル

• techtwitter-pp-cli agent — エージェントの質問に対する引用付きエビデンスバンドル

articles — ツイートの出典情報を備えた長文記事

• techtwitter-pp-cli articles — 長文記事を一覧表示します

command — コマンドセンターのシグナル（注目の意見、主役、ヒートマップ、統計、日付別）

• techtwitter-pp-cli command heatmap — トピックの勢いを示すヒートマップ（キーワード、件数、エンゲージメント）
• techtwitter-pp-cli command hot-takes — 返信が多く、議論が活発なキュレーション済みツイート
• techtwitter-pp-cli command main-character — その日に最もエンゲージメントを集めた著者（主役）
• techtwitter-pp-cli command stats — コーパスインデックスの健全性統計
• techtwitter-pp-cli command tweets-by-date — 指定日のキュレーション済みツイート（today、yesterday、latest、または YYYY-MM-DD）

newsletters — アプリ内ニュースレター（Threads）

• techtwitter-pp-cli newsletters — 公開済みのアプリ内ニュースレターを一覧表示します

profiles — キュレーション済みの著者プロフィール

• techtwitter-pp-cli profiles — 名前、ハンドル、または自己紹介文で著者プロフィールを検索します

tweets — キュレーション済みツイートのストリームを検索・閲覧します

• techtwitter-pp-cli tweets author — 特定の著者ハンドルのキュレーション済みツイート
• techtwitter-pp-cli tweets get — UUID で単一のキュレーション済みツイートを取得します（前後のツイートも表示）
• techtwitter-pp-cli tweets latest — 最新のキュレーション済みツイートを 1 件取得します（nextTweetId を表示）
• techtwitter-pp-cli tweets monthly — 指定月のキュレーション済みツイート
• techtwitter-pp-cli tweets search — テキストでキュレーション済みツイートを検索します（関連度順）
• techtwitter-pp-cli tweets topic — トピックスラッグに対応するキュレーション済みツイート
• techtwitter-pp-cli tweets trending — 過去 7 日間のキュレーション済みツイートをランキング形式で表示します

適切なコマンドを見つける

何をしたいかは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

techtwitter-pp-cli which "<capability in your own words>"

which は自然言語による機能の問い合わせを、この CLI のキュレーション済み機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件の一致があることを示し、終了コード 2 は確実な一致がないことを示します。その場合は --help を参照するか、より具体的な問い合わせを使用してください。

レシピ

エージェント向けの引用付き「何が変わったか」エビデンス

techtwitter-pp-cli agent --kind what-changed --agent --select evidence.title,evidence.canonicalUrl,evidence.qualityScore

引用付きエビデンスバンドルを取得し、深くネストしたレスポンスからタイトル、引用 URL、品質スコアだけを抽出します。これにより、メディアや指標のフィールドでエージェントが圧倒されることを防ぎます。

オフラインでの毎日のテックスタンドアップ

techtwitter-pp-cli digest --window 24h --agent

ローカルミラーから過去 1 日分のトップツイート、最近の記事、トップ著者のリストを作成し、引用付きでエージェント向けに整形します。

新たに台頭しているもの

techtwitter-pp-cli narrative --json

保存済みのヒートマップスナップショットを比較して、新たに出現したキーワードや勢いを増したキーワードを抽出し、それぞれを根拠となる保存済みツイートに紐付けます。

キュレーション済みコーパスをオフラインで検索する

techtwitter-pp-cli search "agentic coding" --json --limit 10

ネットワーク呼び出しなしで、同期済みのローカルストアを全文検索し、品質スコア付きのキュレーション済みツイートを JSON で返します。

トピックの勢いを追跡する

techtwitter-pp-cli momentum --window 7d --json

過去 1 週間の同期で保存されたスナップショットをもとに、上昇中、下降中、または新たに出現したトピックを表示します。

認証の設定

認証は不要です。

techtwitter-pp-cli doctor を実行して、設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込みます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。出力が冗長な API でコンテキストを小さく保つのに重要です：

  techtwitter-pp-cli articles --agent --select id,name,status
  

• プレビュー可能 — --dry-run で送信せずにリクエストを表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合にローカル SQLite ストアを使用できます

• 非対話型 — プロンプトは表示せず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、ライブデータかローカルデータかを確認するには .meta.source を解析してください。人間が読める N results (live) の概要は、stdout がターミナルであり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合にのみ stderr に出力されます。パイプ／エージェント経由の利用者や形式を明示した実行では、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この CLI に気になる点があれば（エージェントが気づいた場合も含めて）、記録してください：

techtwitter-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
techtwitter-pp-cli feedback --stdin < notes.txt
techtwitter-pp-cli feedback list --json --limit 10

記録はローカルの ~/.local/share/techtwitter-pp-cli/feedback.jsonl に保存されます。TECHTWITTER_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか TECHTWITTER_FEEDBACK_AUTO_SEND=true でない限り、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で書きます。そこから改善が積み重なります。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定した送信先に送られるため、エージェントはコマンド結果を手作業でパイプせずに振り分けられます。次の 3 種類の送信先に対応しています：

送信先	動作
stdout	デフォルト。stdout のみに出力します
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact 指定時は application/json または application/x-ndjson）

不明なスキームは、対応しているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルは保存済みのフラグ値のセットで、実行のたびに再利用できます。スケジュールされたエージェントが毎回、同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

techtwitter-pp-cli profile save briefing --json
techtwitter-pp-cli --profile briefing articles
techtwitter-pp-cli profile list --json
techtwitter-pp-cli profile show briefing
techtwitter-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルトより優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が誤っています）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → techtwitter-pp-cli --help の出力を表示します
2. install で始まる場合 → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の「前提条件」を参照してください
3. その他すべて → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします：

   go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/techtwitter/cmd/techtwitter-pp-mcp@latest
   

2. Claude Code に登録します：

   claude mcp add techtwitter-pp-mcp -- techtwitter-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which techtwitter-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある「前提条件」を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを付けて実行します：

   techtwitter-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：techtwitter-pp-cli <command> --help。