Status: [UNTESTED] Endpoints found: http://127.0.0.1:8787/v1/accounts/ACCOUNT_ID/actions Source: https://github.com/jdiab1207/Facebook_Army # Facebook Army Local **Facebook account station** for agencies and operators who manage client pages/groups with sticky ISP proxies, a fleet dashboard, and a REST API that client AI agents can call. > **Not affiliated with Meta.** Browser automation outside the Graph API can violate Facebook’s terms and risk account checkpoints. Use only on accounts you’re authorized to manage, with human-in-the-loop workflows. ![Fleet dashboard](docs/assets/fleet-dashboard.png) *Fleet view — each account is a mobile session tile with live status and icon actions. (Previews blurred for this public screenshot.)* ## What it does - Run many Facebook accounts as **isolated Chromium profiles** - Route each account through its own **sticky ISP proxy** (or this machine’s IP for testing) - **Dashboard** on localhost: phone tiles, session popup with live remote control, desktop/mobile toggle - **Open login** in a real desktop Chromium window (for 2FA / captchas) - Expose a **scoped REST API** so each client’s AI can post to groups, reply, and read engagement - Designed for an always-on **Mac Mini** (works on Windows for development too) ## Quick start **Requirements:** Node.js 20+ ```bash npm run setup # creates .env, folders, installs deps + Chromium npm run build npm start # http://127.0.0.1:8787 ``` Or for development (API + Vite): ```bash npm run setup npm run dev # dashboard http://127.0.0.1:5173 → proxies API on 8787 ``` 1. Open the dashboard → **Unlock dashboard** 2. **Add account** (leave proxy blank to use this PC’s IP, or paste `user:pass@host:port`) 3. **Open login window** → sign into Facebook in the Chromium window → **Mark ready** 4. Click a phone tile to **control the session** in the popup (live stream) 5. Create an **API key** for that client’s AI ## Architecture ``` apps/api Fastify API + Playwright workers + SQLite + live WebSocket control apps/dashboard React fleet UI packages/shared Share