Osintgram 🔎📸

Osintgram は、Instagram 上のOSINTツールで、情報収集、分析、偵察を行います。

免責事項: 教育目的のみに使用してください！ 本ツールの使用により生じたいかなる責任も貢献者は負いません。

$${\color{red}警告:}$$ このツールを使用する際は、自分のメインアカウントを使用しないことを推奨します。

$${\color{red}警告:}$$ プロジェクトをフォークし、自身のホームリポジトリに Instagram の認証情報を追加する場合、それらを GitHub にアップロードしないでください。特定のファイルを無視リストに追加することで、アップロードを無効にできます。

ツールとコマンド 🧰

Osintgram は、任意のユーザーの Instagram アカウントをニックネームで分析するための対話型シェルを提供します。以下の情報を取得できます。

- addrs          ターゲットの写真から登録された住所をすべて取得
- captions       ユーザーの写真のキャプションを取得
- comments       ターゲットの投稿の総コメント数を取得
- followers      ターゲットのフォロワーを取得
- followings     ターゲットがフォローしているユーザーを取得
- fwersemail     ターゲットのフォロワーのメールアドレスを取得
- fwingsemail    ターゲットがフォローしているユーザーのメールアドレスを取得
- fwersnumber    ターゲットのフォロワーの電話番号を取得
- fwingsnumber   ターゲットがフォローしているユーザーの電話番号を取得
- hashtags       ターゲットが使用しているハッシュタグを取得
- info           ターゲットの情報を取得
- likes          ターゲットの投稿の総いいね数を取得
- mediatype      ユーザーの投稿タイプ（写真または動画）を取得
- photodes       ターゲットの写真の説明を取得
- photos         ユーザーの写真を出力フォルダにダウンロード
- propic         ユーザーのプロフィール画像をダウンロード
- stories        ユーザーのストーリーをダウンロード  
- tagged         ターゲットによってタグ付けされたユーザーのリストを取得
- wcommented     ターゲットの写真にコメントしたユーザーのリストを取得
- wtagged        ターゲットをタグ付けしたユーザーのリストを取得

詳細なコマンドの使い方はこちらを参照してください。

最新バージョン | コマンド | CHANGELOG

FAQ

1. 非公開プロフィールの内容にアクセスできますか？ いいえ、非公開プロフィールの情報は取得できません。公開プロフィールまたはフォローしているプロフィールからのみ情報を取得できます。成功すると主張するツールはすべて詐欺です！
2. challenge_required エラーとは何ですか？また、それを回避する方法は？ challenge_required エラーは、Instagram があなたのプロフィールに不審な動作を検知し、あなたが実際の人間かボットかを確認する必要があることを意味します。これを回避するには、表示されるリンクに従い、必要な操作（コードの入力、メールの確認など）を完了してください。

インストール ⚙️

1. このリポジトリをフォーク/クローン/ダウンロードします。

   git clone https://github.com/Datalux/Osintgram.git

2. ディレクトリに移動します。

   cd Osintgram

3. このプロジェクト用の仮想環境を作成します。

   python3 -m venv venv

4. 仮想環境を有効にします。

   • Windows Powershell の場合: .\venv\Scripts\activate.ps1
   • Linux および Git Bash の場合: source venv/bin/activate

5. pip install -r requirements.txt を実行します。

6. config フォルダ内の credentials.ini ファイルを開き、対応するフィールドに Instagram アカウントのユーザー名とパスワードを記入します。または、https://hikerapi.com/tokens から hikerapi_token を使用します（登録と Telegram 確認後、最初の100リクエストは無料）。

   あるいは、make setup コマンドを実行して、このファイルに自動入力することもできます。

7. 以下の3つの方法のいずれかで main.py スクリプトを実行します。

   • 対話型プロンプトとして:

Osintgram v2（ベータ版）の使用

v2 ブランチに切り替えることで、Osintgram2 ベータ版を使用できます。 v2 は改善点と高速化が施され、新しいコマンド実行インターフェースを備えています。git checkout v2 を実行して試してください。

Docker クイックスタート 🐳

このセクションでは、Docker または Docker-compose を使用してこのイメージを迅速に利用する方法を説明します。

前提条件

Docker または Docker-compose を使用する前に、以下の前提条件が満たされていることを確認してください。

1. Docker がインストールされていること - リンク
2. Docker-compose がインストールされていること（Docker-compose を使用する場合） - リンク
3. 認証情報 が設定されていること - 手動で行うか、このリポジトリのルートで make setup コマンドを実行することで設定できます。

重要: 手順3を実行せずに認証情報を設定しないと、コンテナは起動に失敗します。

Docker

Docker がインストールされている場合、イメージをビルドしてコンテナとして実行できます。

ビルド:

docker build -t osintgram .

実行:

docker run --rm -it -v "$PWD/output:/home/osintgram/output" osintgram <ターゲット>

• <ターゲット> は、偵察対象とする Instagram アカウントです。
• 必須の -i フラグは、コンテナ内でコマンドを使用するためのインタラクティブターミナルを有効にします。ドキュメント
• 必須の -v フラグは、ローカルファイルシステムとコンテナの間にボリュームをマウントし、./output/ フォルダに保存します。ドキュメント
• オプションの --rm フラグは、コンテナのファイルシステムを実行完了時に削除し、残骸の蓄積を防ぎます。ドキュメント
• オプションの -t フラグは、疑似 TTY を割り当て、色付きの出力を可能にします。ドキュメント

docker-compose の使用

docker-compose.yml ファイルを使用して、次の単一コマンドで実行できます。

docker-compose run osintgram <ターゲット>

ここで、ターゲット は偵察対象の Instagram ターゲットです。

または、Makefile を使って docker-compose を実行することもできます。

make run - ビルドし、compose で実行します。実行前に ターゲット の入力を求めます。

Makefile（簡単モード）

Docker-compose を簡単に使用するために、Makefile が用意されています。

以下は、わずか2つのコマンドでコンテナを起動し osintgram を実行するサンプルワークフローです。

1. make setup - Instagram の認証情報を設定します。
2. make run - osintgram コンテナをビルドして実行し、ターゲットの入力を求めます。

開発用のサンプルワークフロー:

1. make setup - Instagram の認証情報を設定します。
2. make build-run-testing - main.py スクリプトを起動せずにコンテナをビルドして実行します。開発用の it Docker セッションに便利です。
3. make cleanup-testing - build-run-testing で作成したテストコンテナをクリーンアップします。

開発バージョン 💻

最新の機能と修正を含む開発バージョンを使用するには、Git で development ブランチに切り替えてください。

git checkout development

そして、以下を使用して最新バージョンに更新します。

git pull origin development

更新 ⬇️

安定版リリースで Osintgram を更新するには、Git を使用して最新のコミットをプルします。

1. git checkout master を実行して master ブランチにいることを確認します。
2. 最新バージョンをダウンロードします: git pull origin master

貢献 💡

Issue またはプルリクエストを開いて機能リクエストを提案できます。

以下は Osintgram の貢献者のリストです。

外部ライブラリ 🔗

Instagram API