Telegram ユーザー自動追加ツール
概要
Telegram-Adding-Usersは、コミュニティメンバーを任意のターゲット(グループやチャンネル)に自動で追加することを目的としたPythonスクリプト群です。メンバーの抽出(メッセージ履歴やメディア、チャネル一覧から)、隠れメンバーの取得、プレミアム会員のみをフィルタして追加するといった機能がうたわれており、GUIのスクリーンショットや実行デモGIFで操作イメージが示されています。設定や実行はローカルのユーザーセッションを用いる設計が想定され、簡単に使えることがセールスポイントです。
リポジトリの統計情報
- スター数: 23
- フォーク数: 0
- ウォッチャー数: 23
- コミット数: 2
- ファイル数: 10
- メインの言語: Python
主な特徴
- メンバー、メッセージ、メディア、チャンネル情報の抽出(スクレイピング)機能を提供
- 抽出したメンバーを自動で指定グループ/チャンネルに追加
- 「プレミアム会員のみ」などのフィルタリングによる追加対象の絞り込みが可能(オプション)
- GUIイメージやGIFで操作の様子を視覚的に確認できる
技術的なポイント
このプロジェクトはPythonスクリプト(adding.py など)を中心に構成され、Telegramクライアントのユーザーセッションを操作してメンバーの取得・追加を自動化する形をとっています。実装上の主要ポイントは以下の通りです。
- メンバー抽出: チャット履歴やチャネルの参加者リスト、メッセージ発信者の情報を順に収集する処理が必要です。個々のメッセージやメディアからユーザーIDやユーザーネーム、表示名を抽出してデータ化します。
- 非表示メンバー対応: “隠れメンバー” の取得をうたっていますが、これは権限やプライバシー設定により通常のAPI呼び出しで取得できないケースがあるため、ユーザーセッションを用いたクライアント操作や追加のリクエスト方法で補完している可能性があります。
- フィルタリングとバッチ処理: プレミアム会員など属性によるフィルタ処理を行い、追加対象を絞る機能があるため、属性判定ロジックとバッチ単位での追加実行(レート制限対策)が組み合わされています。
- レート制御とエラーハンドリング: Telegram側の制限(APIレート、招待の上限など)に対する待機・再試行ロジック、セッション切断や例外時のロギングが重要です。並列処理を行う場合はIP/アカウントあたりの制限に注意が必要です。
- セキュリティと認証: 実行にはTelegramのAPI ID/Hashやユーザーセッション(電話番号認証や2段階認証)が必要になる想定です。セッションファイルの管理や機密情報の扱いに注意してください。
- 倫理・規約面の注意点: 他人を大量に追加する行為やスパムになりうる使い方はTelegramの利用規約や各国の法令に抵触する可能性があるため、用途は厳格に管理する必要があります。
開発上の改善余地としては、使用しているTelegramクライアントライブラリ(例: TelethonやPyrogram)を明記して依存関係を整備すること、詳細な設定ファイルやログ出力の整備、レート制御ポリシーやスケジューラを組み込むことが挙げられます。デプロイ時はプロキシやリトライ戦略、マルチアカウント運用の方針も検討してください。
プロジェクトの構成
主要なファイルとディレクトリ:
- README.md: file
- UI1.png: file
- add.gif: file
- adding.py: file
- copy.gif: file
…他 5 ファイル
(主要ファイルの役割)
- README.md: プロジェクトの概要、取得リンク、連絡先、スクリーンショットや使用例の説明を含む
- adding.py: メンバー抽出と自動追加のコア処理を行うスクリプト(エントリポイント)
- UI1.png / add.gif / copy.gif: ユーザーインターフェースや実行デモの視覚的資料
まとめ
手軽に使える自動化ツールだが、利用はTelegram規約と倫理に注意して行う必要あり。
リポジトリ情報:
- 名前: Telegram-Adding-Users
- 説明: An automation for the process of adding communitymembers to any target of your choice. Simple to use and up to date!
- スター数: 23
- 言語: Python
- URL: https://github.com/duongtsa/Telegram-Adding-Users
- オーナー: duongtsa
- アバター: https://avatars.githubusercontent.com/u/233070645?v=4
READMEの抜粋:
Telegram-Adding-Users
An automation for the process of adding communitymembers to any target of your choice. Simple to use and up to date!
📁 GET IT HERE: https://shorturl.at/MdvDy
CONTACT FOR QUESTIONS: https://shorturl.at/qRqTq
-
EXTRACT MEMBERS, MESSAGES, MEDIA, CHANNELS AND MORE! (EVEN HIDDEN MEMBERS)
-
ADD MEMBERS TO YOUR GROUPS/CHANNELS AUTOMATICALLY!
-
FILTERING ONLY PREMIUM MEMBERS POSSIBLE! (OPTIONAL)
-
AUTOMATICALLY F…