hanyxd/osgr-tool
GitHub: hanyxd/osgr-tool
一款基于浏览器 Cookie 认证的 Instagram OSINT 侦察工具，用于批量采集和分析目标账户资料、动态及社交关系网络。
Stars: 0 | Forks: 0
# osgr - Instagram OSINT 侦察工具
用于 OSINT 调查的高级 Instagram 资料分析、快拍追踪、帖子分析和数据导出工具。
## ⚡ 快速开始（30秒）
```
# 1. 安装依赖
pip install instaloader browser-cookie3
# 2. Clone & install
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
# 3. 在 Chrome 中登录 Instagram（使用 burner account！）
# 打开 Chrome → instagram.com → 登录
# 4. 运行你的首次扫描
osgr nasa --analytics --stories --save
```
就这些！结果将保存到 `~/osgr_output/`
## 📦 跨平台安装
### Linux（所有发行版）
#### Debian/Ubuntu/Mint/Pop!_OS/Kali/Parrot
```
# 系统包
sudo apt update && sudo apt install -y python3 python3-pip python3-venv git chromium-browser
# Python 依赖
pip3 install instaloader browser-cookie3
# Clone & install
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### Fedora/RHEL/CentOS/AlmaLinux/Rocky
```
sudo dnf install -y python3 python3-pip python3-virtualenv git chromium
pip3 install instaloader browser-cookie3
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### Arch/Manjaro/EndeavourOS/Garuda
```
sudo pacman -S python python-pip git chromium
pip install instaloader browser-cookie3
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### openSUSE (Tumbleweed/Leap)
```
sudo zypper install python3 python3-pip git chromium
pip3 install instaloader browser-cookie3
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### Alpine Linux
```
apk add python3 py3-pip git chromium
pip3 install instaloader browser-cookie3
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### NixOS
```
# 添加到 configuration.nix 或使用 nix-shell
nix-shell -p python3 python3Packages.instaloader python3Packages.browser-cookie3 chromium git
# 或者永久配置：
# environment.systemPackages = with pkgs; [ python3 python3Packages.instaloader python3Packages.browser-cookie3 chromium git ];
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
```
#### 使用虚拟环境（推荐用于所有发行版）
```
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
python3 -m venv venv
source venv/bin/activate
pip install instaloader browser-cookie3
# 使用 venv python 运行
./osgr nasa --analytics --stories --save
```
### Windows (10/11)
#### 选项 A：原生 Windows (PowerShell)
**前置条件：**
1. 安装 [Python 3.11+](https://python.org/downloads) ✓ "将 Python 添加到 PATH"
2. 安装 [Git for Windows](https://git-scm.com/download/win)
3. 安装 [Chrome](https://www.google.com/chrome/)（获取 cookie 必需）
```
# 以管理员身份打开 PowerShell
# 1. 安装 Python 包
pip install instaloader browser-cookie3
# 2. Clone repository
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
# 3. 使用 python 运行（Windows 上不需要 chmod）
python osgr nasa --analytics --stories --save
# 4. 可选：添加到 PATH 以使用全局 'osgr' 命令
# 将 osgr 复制到 PATH 中的文件夹，或者创建一个 batch wrapper：
echo python "%~dp0osgr" %* > C:\Windows\osgr.bat
# 现在你可以运行：osgr nasa --analytics
```
#### 选项 B：WSL2 (Windows Subsystem for Linux) — **推荐**
WSL2 为您提供完整的 Linux 兼容性：
```
# 1. 启用 WSL2（在 PowerShell Admin 中运行）
wsl --install
# 重启计算机，然后从开始菜单打开 Ubuntu
# 2. 在 Ubuntu 终端中，按照上面的 Linux (Debian/Ubuntu) 说明操作：
sudo apt update && sudo apt install -y python3 python3-pip python3-venv git chromium-browser
pip3 install instaloader browser-cookie3
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
# 3. 在 WSL 内部登录 Chrome（或者使用带 cookie 共享的 Windows Chrome）
# 要访问 Windows Chrome cookie，请安装支持 Windows 的 browser-cookie3：
pip install browser-cookie3[windows]
```
**WSL2 + Windows Chrome Cookie 访问：**
```
# 在 WSL 中，指向 Windows Chrome cookie 数据库
export CHROME_COOKIE_PATH="/mnt/c/Users/YOUR_USERNAME/AppData/Local/Google/Chrome/User Data/Default/Network/Cookies"
# 如果安装了 browser-cookie3[windows]，osgr 会自动检测
```
### macOS（Intel 与 Apple Silicon）
```
# 1. 安装 Homebrew（如果未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装依赖
brew install python3 git chromium
# 3. Python 包
pip3 install instaloader browser-cookie3
# 4. Clone & install
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
chmod +x osgr
sudo ln -s $(pwd)/osgr /usr/local/bin/osgr
# 5. 登录 macOS 上的 Chrome，然后运行
osgr nasa --analytics --stories --save
```
## 🐳 Docker（任意平台）
```
# 构建镜像
git clone https://github.com/hanyxd/osgr-tool
cd osgr-tool
# 创建 Dockerfile
cat > Dockerfile << 'EOF'
FROM python:3.11-slim
RUN apt-get update && apt-get install -y chromium git && rm -rf /var/lib/apt/lists/*
RUN pip install instaloader browser-cookie3
WORKDIR /app
COPY . .
RUN chmod +x osgr
ENTRYPOINT ["python", "osgr"]
EOF
docker build -t osgr .
# 运行（需要挂载 Chrome cookie 目录）
docker run -it --rm \
-v ~/osgr_output:/root/osgr_output \
-v ~/.config/chromium:/root/.config/chromium:ro \
osgr nasa --analytics --stories --save
```
## 🔧 浏览器 Cookie 配置
| 浏览器 | Linux 路径 | Windows 路径 | macOS 路径 |
|---------|------------|--------------|------------|
| Chrome | `~/.config/google-chrome/Default/Cookies` | `%LOCALAPPDATA%\Google\Chrome\User Data\Default\Network\Cookies` | `~/Library/Application Support/Google/Chrome/Default/Cookies` |
| Chromium | `~/.config/chromium/Default/Cookies` | `%LOCALAPPDATA%\Chromium\User Data\Default\Network\Cookies` | `~/Library/Application Support/Chromium/Default/Cookies` |
| Brave | `~/.config/BraveSoftware/Brave-Browser/Default/Cookies` | `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\User Data\Default\Network\Cookies` | `~/Library/Application Support/BraveSoftware/Brave-Browser/Default/Cookies` |
| Edge | `~/.config/microsoft-edge/Default/Cookies` | `%LOCALAPPDATA%\Microsoft\Edge\User Data\Default\Network\Cookies` | `~/Library/Application Support/Microsoft Edge/Default/Cookies` |
**自动检测适用于所有平台上的 Chrome/Chromium/Brave/Edge。**
对于非默认配置文件，请设置环境变量：
```
export BROWSER_COOKIE3_CHROME_PROFILE="Profile 2"
osgr nasa --analytics
```
## 🚀 运行示例
```
# 快速 profile 扫描
osgr nasa
# 带导出的完整 OSINT package
osgr target_username --full --save
# 仅 analytics + stories
osgr nasa --analytics --stories --save
# Follower network mapping
osgr target --followers 200 --following 200 --csv
# Post engagement deep-dive
osgr target --posts 50 --analytics --verbose
# Likers 分析（必须先在 Chrome 中关注目标！）
osgr target --likes 10 --save
# 用于脚本化的 JSON
osgr target --json | jq '.profile | {username, followers, following, posts_count}'
```
## 📁 输出结构
```
~/osgr_output/
├── target_20260711_143022.json # Full JSON data
├── target_posts.csv # Posts (shortcode, likes, comments, hashtags, etc.)
├── target_highlights.csv # Story highlights
├── target_followers.csv # Follower sample
├── target_following.csv # Following sample
├── target_likes.csv # Post likers
└── target_report.md # Human-readable report
```
## ⚠️ 重要注意事项
| 平台 | 注意事项 |
|----------|-------|
| **所有** | 使用 **一次性 Instagram 账号** — 自动化操作会触发安全验证 |
| **Windows** | 以管理员身份运行 PowerShell 以执行等效于 `ln -s` 的操作；首选 WSL2 |
| **Linux** | 必须安装 Chrome/Chromium 才能提取 cookie |
| **macOS** | 在“系统偏好设置” -> “安全性与隐私”中为终端授予“完全磁盘访问权限”以读取 cookie |
| **Docker** | 挂载宿主机的 Chrome cookie 目录以进行身份验证 |
## 📋 环境要求摘要
| 组件 | Linux | Windows | macOS |
|-----------|-------|---------|-------|
| Python | 3.8+ | 3.11+ | 3.8+ |
| pip 包 | `instaloader`, `browser-cookie3` | 相同 | 相同 |
| 浏览器 | Chrome/Chromium/Brave/Edge | Chrome/Edge | Chrome/Brave/Edge |
| Git | ✓ | ✓ | ✓ |
| Shell | bash/zsh/fish | PowerShell/WSL2 | bash/zsh |
## License
MIT — 仅限用于教育/OSINT 目的，请负责任地使用。
标签：ESC4, Instagram, meg, OSINT, Python, 信息安全, 命令控制, 数据泄露, 数据采集, 无后门, 请求拦截, 逆向工具