Circle Tweet Cleaner — TwitterアーカイブからCircleツイートを検出・削除するツール

Tool
Circle Tweet Cleaner — TwitterアーカイブからCircleツイートを検出・削除するツール

Circle Tweet Cleaner — TwitterアーカイブからCircleツイートを検出・削除するツール

Twitterの「Circle」機能（限定公開ツイート）はアーカイブにマークされず含まれるため、アーカイブを共有すると意図せず限定公開のツイートが公開される危険があります。本リポジトリは、エクスポートしたTwitter/XアーカイブからCircleツイートを検出して削除するためのTypeScript製ツールです。オフラインのアーカイブデータと外部のTwitter情報を照合してCircleで共有された可能性の高いツイートを特定し、アーカイブをクリーンな状態で出力します。

https://github.com/aliceisjustplaying/circle-tweet-cleaner

概要

Twitterの「Circle」機能は限定された閲覧者だけにツイートを見せるための機能でしたが、アーカイブをダウンロードするとCircleでの限定公開だったツイートも通常のツイートと同じ形式で含まれており、それらが明示的に区別されていません。本ツール「circle-tweet-cleaner」は、エクスポートしたTwitter/Xアーカイブ内のツイートを解析・照合して、Circleで投稿された可能性の高いツイートを検出し、アーカイブから削除（または一覧出力）することで、アーカイブ共有時のプライバシー漏洩リスクを下げることを目的としています。TypeScriptで実装され、ローカル環境で動作するユーティリティです。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 5
  • ファイル数: 10
  • メインの言語: TypeScript

主な特徴

  • Twitterアーカイブ内のCircle（限定公開）ツイートを検出して削除可能
  • ローカルで動作するCLIツール（TypeScript実装）
  • アーカイブを壊さずにクリーンな出力を生成するワークフロー
  • Bunや一般的なNode系ツールチェーンでの利用を想定

技術的なポイント

本プロジェクトはTypeScriptで書かれており、bun.lockが含まれていることからBunランタイムやそのパッケージ管理を利用することが想定されます。実際の検出手法はREADMEでも触れられている通り、アーカイブ内のツイートデータ（JSONやHTMLエクスポート）を単に文字列やメタ情報でフィルタするのではなく、外部のTwitter側情報と照合することで「アーカイブ上は通常ツイートだが実際は限定公開されていた」ものを特定する点が肝です。照合の具体的手法としては、ツイートのメタデータ（作成日時、返信/リプライ先、メディアID、いいね/リツイートの公開状況など）と外部から取得可能な公開情報を突き合わせ、挙動が限定公開と一致するパターンを検出するアプローチが考えられます。TypeScriptでユーティリティ群を実装することで型安全にファイル操作やJSON解析を行い、CLIとして使いやすくするための入出力ハンドリングやログ出力、dry-runモード（削除前の確認）といった実装上の配慮が期待されます。また、アーカイブを直接編集する場合はバックアップの自動作成や削除対象の一覧出力（レビュー用）を行うなど、誤削除対策が重要です。OSSとして配布する際にはAPIキー管理やレートリミット、プライバシー配慮（アーカイブの取り扱い）に関するドキュメント整備が必要になります。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .cursor: dir
  • .gitignore: file
  • .prettierrc: file
  • README.md: file
  • bun.lock: file

…他 5 ファイル

（上記ファイル群のうち、ソースはTypeScriptのファイル群や設定ファイル、CLIエントリが含まれている想定です。READMEに実行手順や引数、注意事項が記載されています。）

使い方（概要）

  • Twitterからアーカイブを取得してローカルに展開する
  • 本ツールにアーカイブのディレクトリを渡して解析を実行
  • 検出されたCircle疑いツイートの一覧を確認（dry-run）
  • 問題なければ実際にアーカイブから該当エントリを削除してクリーンなアーカイブを出力

CLIツールとしての一般的なオプション（想定）

  • —input: アーカイブディレクトリ
  • —output: クリーンなアーカイブ出力先
  • —dry-run: 削除を行わずレポートのみ出力
  • —verbose: 詳細ログ出力

セキュリティと注意点

  • アーカイブには個人情報や過去の投稿が含まれるため、ツール実行時はローカル環境で完結させ、外部へアップロードしないことが推奨されます。
  • 自動削除は誤判定のリスクがあるため、必ず検出レポートで確認できるワークフローを用意するべきです。
  • 外部APIを利用する場合は認証情報やレート制限、利用規約に留意してください。

まとめ

Twitterアーカイブの共有前に限定公開ツイートの漏洩を防ぐ実用的なツールで、TypeScript/Bun環境で手軽に利用可能です。

リポジトリ情報：

READMEの抜粋：

circle-filter

Detect and remove Twitter Circle tweets from your Twitter/X archive export.

The Problem

Twitter Circles was a feature (May 2022 - October 2023) that let users share tweets with a limited audience. When you download your Twitter archive, Circle tweets are included but not marked as such - there’s no field indicating a tweet was Circle-only.

This is a privacy issue: if you share or upload your archive, your Circle tweets become public.

The Solution

This tool uses Tw… （READMEは検出ロジックや使い方、注意点を続けて記載していますので、導入前にREADMEをよく確認してください。）