tweet-box

tweet-box は、Twitter(X) の特定ユーザーのツイートを自動で収集・保存し、専用のタイムラインで閲覧できるWebアプリケーションです。

しくみ

tweet-box は twipush というツールと連携して動作します。

twipush とは

twipush は、Webブラウザが通知を受け取る仕組み（Web Push）を模倣したアプリケーションです。

普段、ブラウザで Twitter の通知をオンにすると、ツイートがあったときにブラウザに通知が届きます。この通知は Twitter から直接届くのではなく、Mozilla の Web Push サーバーを経由して届いています。twipush はこの「ブラウザのふり」をして通知を受け取り、その内容を tweet-box に転送します。

つまり流れとしては以下のようになります。

code:mermaid

flowchart LR

A"Twitter" -->|"通知を送信"| B"Mozilla Web Push サーバー"

B -->|"通知を中継"| C"twipush（ブラウザのふり）"

C -->|"ツイートを転送"| D"tweet-box"

style A fill:#1d9bf0,color:#fff

style B fill:#e05d44,color:#fff

style C fill:#555,color:#fff

style D fill:#555,color:#fff

Twitter から見ると、通常のブラウザ通知を送っているだけなので、twipush の存在を認識することはありません。

API・スクレイピングは一切不使用

twipush は Twitter の API やスクレイピングを一切使用していません。通知の受信先はあくまで Mozilla のサーバーであり、Twitter のサーバーに対して自動的なアクセスを行うことはありません。そのため、アカウントの BAN や IP BAN のリスクはありません。

twipush の使い方(tweet-boxだけの人は読み飛ばしてOK)

初期設定

twipush を使い始めるには、一度だけ Twitter の認証情報を渡して初期登録を行います。

1. twipush の init と register を実行する

2. 登録が完了したら、渡した認証情報（Cookie）は不要になります。ログアウトして Cookie を破棄しても問題ありません

初期登録後は、twipush が自動的に通知を受信し続けます。

アカウントについて

twipush にはサブアカウントや捨てアカウントの使用を推奨します。メインアカウントの認証情報を使う必要はありません。

通知を受け取るには

tweet-box でツイートを受け取りたいユーザーがいる場合、twipush に登録したアカウントで、そのユーザーのツイート通知をオンにしてください。Twitter 上で通知をオンにしたユーザーのツイートだけが tweet-box に届きます。

tweet-box の機能

タイムライン

収集したツイートを Twitter 風のタイムラインで閲覧できます。

ユーザーアイコン、ユーザー名、投稿日時、本文、画像、動画、リンクなどを表示

スクロールするだけで過去のツイートを自動で読み込み（無限スクロール）

画像タップで拡大表示。複数画像のツイートはスワイプやキーボードで切り替え可能

フィルター

ツイートを見たい Twitter ユーザーをグループにまとめて、タイムラインを絞り込めます。

フィルターに Twitter ユーザーを追加すると、そのユーザーのツイートだけを表示

複数のフィルターを作成して切り替え可能

タイムライン上部のドロップダウンでフィルターを選択

code:mermaid

flowchart TB

subgraph filter1"フィルター: 推し"

U1"@user_a"

U2"@user_b"

end

subgraph filter2"フィルター: ニュース"

U3"@news_x"

U4"@news_y"

end

filter1 -->|"選択"| TL"タイムライン"

filter2 -->|"選択"| TL

style filter1 fill:#1d9bf0,color:#fff

style filter2 fill:#e05d44,color:#fff

style TL fill:#555,color:#fff

フィルター共有

作成したフィルターを他の tweet-box ユーザーと共有できます。

閲覧権限：共有されたフィルターを使ってタイムラインを絞り込める

編集権限：フィルターのメンバー（Twitter ユーザー）を追加・削除できる

共有の流れは以下のとおりです。

code:mermaid

sequenceDiagram

participant A as フィルター作成者

participant B as 招待されたユーザー

A->>B: フィルターへの招待を送信（閲覧 or 編集）

B->>B: 招待を確認

B->>A: 承認

Note over B: フィルターが使えるようになる

Webhook 通知

新しいツイートが届いたとき、外部サービスに自動で通知を送れます。

任意の URL に通知を送信

Discord 対応：Discord のチャンネルに直接ツイート内容を投稿可能

フィルターと組み合わせて、特定のユーザーのツイートだけを通知することも可能

通知の送信状況（成功/失敗）を確認できる

code:mermaid

flowchart LR

T"新しいツイート" --> W{"Webhook"}

W -->|"通常"| URL"任意の URL"

W -->|"Discord モード"| D"Discord チャンネル"

style T fill:#1d9bf0,color:#fff

style W fill:#555,color:#fff

style URL fill:#555,color:#fff

style D fill:#5865f2,color:#fff

招待制アクセス

tweet-box は招待制です。利用するには既存ユーザーから招待コードを受け取る必要があります。

各ユーザーは最大 3 つの招待コードを発行可能

招待コードの使用状況を確認できる

ユーザー設定

表示名の変更

ユーザーアイコンの変更

ユーザー ID の変更