https://github.com/snap-bots/snapchat-score-bot
snapchat score bot
https://github.com/snap-bots/snapchat-score-bot
adb appium automation bot cli docker mobile mobile-automation nodejs playwright python snapchat snapchat-score-bot
Last synced: about 2 months ago
JSON representation
snapchat score bot
- Host: GitHub
- URL: https://github.com/snap-bots/snapchat-score-bot
- Owner: Snap-bots
- Created: 2025-10-07T18:25:18.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-07T18:31:08.000Z (9 months ago)
- Last Synced: 2025-10-07T20:37:43.628Z (9 months ago)
- Topics: adb, appium, automation, bot, cli, docker, mobile, mobile-automation, nodejs, playwright, python, snapchat, snapchat-score-bot
- Language: Python
- Homepage:
- Size: 1.63 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# snapchat score bot
Smart, modular automation to simulate safe, human-like Snapchat activity to build/track score at scale.
## Introduction
**snapchat score bot** helps growth hackers and QA teams automate routine Snapchat actions (open/send snaps, add friends, view stories, light chatting patterns) with realistic delays, device isolation, and proxy support. Built for phone-farm setups (real Android), emulators, or headless flows to test engagement and track score changes safely.
**Key Benefits**
- **Time-saving:** Schedule and batch actions across many devices/accounts.
- **Scalable:** Horizontal scaling via Docker + queue workers.
- **Safer:** Human-like randomness, device isolation, and proxy rotation.
## Features
- Human-like schedulers: randomized delays, day/night windows, action caps.
- Multi-device orchestration (ADB/Appium) with per-device profiles & proxies.
- Pluggable runners: **Python (Appium/ADB)** and **Node.js (Playwright/ADB)**.
- Score tracker: snapshots score before/after runs with CSV/JSON export.
- Task presets: open-snaps, send-snaps to streak list, add-friends, view-stories.
- Anti-pattern guards: cool-downs, max sends/hour, session rotation.
- .env-driven config + per-account YAML for overrides.
## Use Cases
- Warm-up new accounts gradually before real campaigns.
- QA/testing Snapchat flows on many devices automatically.
- Research: measure which activity patterns move score without flags.
- Phone-farm orchestration with reporting and audit trails.
## Contact
---
## Installation Instructions
### Pre-requisites
- **Python 3.10+**
- **Node.js 18+** (optional Node runner)
- **Java JDK 11+**, **Android Platform Tools (ADB)**
- **Appium Server** (if using Appium flows)
- **Docker** (optional for containerized workers)
- **Devices/Emulators:** Real Android (recommended) or Android emulator
- **Proxies (optional):** HTTP/SOCKS or mobile proxies per device
### Clone the Repo
```bash
git clone https://github.com/yourusername/snapchat-score-bot.git
cd snapchat-score-bot
```
---
## Run Commands
### Python (CLI)
```bash
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python cli.py run --preset streaks --accounts ./accounts --duration 45m
```
### Node.js (CLI)
```bash
npm i
node runner.js run --preset open-and-send --accounts ./accounts --duration 30m
```
### Docker
```bash
docker build -t snapchat-score-bot .
docker run --rm --env-file .env -v $PWD/accounts:/app/accounts -v $PWD/reports:/app/reports --network host snapchat-score-bot python cli.py run --preset streaks --accounts ./accounts
```