# AI use cases for Foxprofile (chienbm98/foxprofile) Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Use cases: 5 | Page: https://dedupedai.com/use-cases/chienbm98-foxprofile/ FoxProfile is a free, self-hosted manager for anti-detect browser profiles, each with its own fingerprint, cookies and proxy, that people and AI agents can run locally or on a VPS. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Keep several accounts in separate browser identities: https://dedupedai.com/use-cases/chienbm98-foxprofile/isolate-multiple-accounts-per-profile/ - Let an AI agent browse a logged-in profile: https://dedupedai.com/use-cases/chienbm98-foxprofile/let-ai-agent-browse-logged-in-profile/ - Run profiles on a VPS and view their screens remotely: https://dedupedai.com/use-cases/chienbm98-foxprofile/run-profiles-on-vps-with-remote-screen/ - Check exit IP, timezone and locale before a site test: https://dedupedai.com/use-cases/chienbm98-foxprofile/check-exit-ip-and-geo-before-testing/ - Move profiles between machines and export cookies: https://dedupedai.com/use-cases/chienbm98-foxprofile/move-profiles-and-export-cookies/ ## How to keep several accounts in separate browser identities with Foxprofile Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Difficulty: Intermediate | Time: 1 hour | Basis: From the README Give each account its own fingerprint, cookies, proxy and timezone so sessions never mix. **Who it is for:** A social media or ecommerce operator who manages several accounts on one machine and needs each to look like its own device. **The problem:** Logging into several accounts in one browser mixes cookies and fingerprints, so the sessions are easy to link and hard to manage. **The outcome:** Each account runs in its own profile with a stored device fingerprint, its own cookies and history, and a chosen proxy and locale. ### Steps 1. `git clone https://github.com/chienbm98/foxprofile.git`, then `cd foxprofile` 2. `python -m venv .venv`, then `source .venv/bin/activate` on Linux or macOS (use `.venv\Scripts\activate` on Windows) 3. `pip install -r requirements.txt`, then `python -m camoufox fetch` 4. Run `python -m src.main`, create one profile per account, and set its proxy and a pinned Locale in the profile dialog 5. Launch the profile, log in once, and let cookies and history persist in the profile directory for later sessions ### Prompt to paste into your agent ```text Using the repo chienbm98/foxprofile, set up one profile for the account with the proxy and locale . Report the profile name, engine and emulated device shown in the profile table. Verify that the profile table lists the new profile with its proxy hidden and the chosen locale. ``` ### Caveat The README says the browser fingerprint does not stop datacenter IP captchas, so a residential or mobile proxy matters more than any other setting for Cloudflare-protected sites. Risk, account pooling: Running many accounts through separate identities can breach the terms of the platforms involved, so check each platform's rules before operating multiple accounts. Risk, credentials: Logins and cookies for each account are stored in the profile directory on disk, so protect that machine and its data directory. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/chienbm98-foxprofile/isolate-multiple-accounts-per-profile/ ## How to let an AI agent browse a logged-in profile with Foxprofile Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Difficulty: Intermediate | Time: 1 hour | Basis: From the README Connect Claude Code to FoxProfile over MCP so the agent can open pages, click and take screenshots. **Who it is for:** A developer or analyst who wants an AI coding assistant to check a site inside a prepared browser profile instead of a fresh session. **The problem:** A plain automated browser starts with no history or logins, and the developer has to script every step of the check by hand. **The outcome:** The agent launches a named profile, browses with its saved cookies, and returns a screenshot or page text. ### Steps 1. Complete the setup with `python -m venv .venv`, `pip install -r requirements.txt` and `python -m camoufox fetch` 2. Start the desktop app with `python -m src.main` and keep it running 3. Add the MCP server to Claude Code with `claude mcp add --transport http foxprofile http://127.0.0.1:8000/mcp` 4. In Claude Code, ask the agent to open a profile by name, go to a URL and send a screenshot 5. Check that the agent used the launch_profile and browser_screenshot tools and that the screenshot matches the page ### Prompt to paste into your agent ```text Using the repo chienbm98/foxprofile through its MCP server at http://127.0.0.1:8000/mcp, launch the profile , navigate to , and take a screenshot. Return the screenshot and a one-line summary of the page title. Verify that the profile appears as running in running_profiles before you navigate. ``` ### Caveat The README says there is deliberately no delete tool for agents, but agents can still read the page and act on logged-in sessions, so review what they do. Risk, credentials: The agent can read and use the logins stored in the profile, so only connect profiles whose accounts you are willing to let an agent use. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/chienbm98-foxprofile/let-ai-agent-browse-logged-in-profile/ ## How to run profiles on a VPS and view their screens remotely with Foxprofile Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Difficulty: Advanced | Time: 2 hours | Basis: From the README Host FoxProfile in server mode and use the web panel to log in or solve captchas on hidden browsers. **Who it is for:** An operator who needs profiles running around the clock on a server, and who must step in by hand when a login or captcha appears. **The problem:** Browsers on a server run hidden, so the operator cannot see or interact with them when a login or captcha blocks the work. **The outcome:** Profiles run hidden on the VPS, and the operator views a profile's screen in the web panel and clicks or types into it. ### Steps 1. Generate a token with `python -c "import secrets; print(secrets.token_urlsafe(32))"` and save it as FOXPROFILE_API_TOKEN 2. Start the server with `python -m src.server --host 0.0.0.0` on the VPS 3. Put the server behind an HTTPS reverse proxy such as Caddy or Nginx so the token is not sent in clear text 4. Open the web panel at the server address, create and launch profiles, and open a profile's remote screen view 5. Confirm a profile shows as running in the panel before relying on it (inferred, check the README) ### Prompt to paste into your agent ```text Using the repo chienbm98/foxprofile in server mode on , launch the profile and report whether it is running. Verify that the API answers on port 8000 and that the server refused to start without FOXPROFILE_API_TOKEN set. ``` ### Caveat The README says the server refuses to start on a non-local address without a token of 24 characters or more, and that the Vietnamese deployment guide is in docs/DEPLOY.md. Risk, credentials: The web panel can view a profile's screen and move its cookies, so anyone with the token can reach those accounts, and the token must stay private. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/chienbm98-foxprofile/run-profiles-on-vps-with-remote-screen/ ## How to check exit IP, timezone and locale before a site test with Foxprofile Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Difficulty: Intermediate | Time: 45 minutes | Basis: From the README Confirm a proxy's country, timezone and datacenter status before a geo-specific test. **Who it is for:** A QA tester or web developer who must show a site as it appears to visitors in one country. **The problem:** A proxy can leave from an unexpected country or datacenter, and a random locale can make the test look wrong. **The outcome:** A profile with a checked exit IP, a pinned timezone and a fixed locale, ready for a consistent test run. ### Steps 1. Complete setup with `pip install -r requirements.txt` and `python -m camoufox fetch`, then start the app with `python -m src.main` 2. Create a profile and enter the proxy in the format host:port or socks5://user:pass@host:port 3. Open the profile dialog and set Timezone (for example Asia/Ho_Chi_Minh) and Locale (for example vi-VN) 4. Run Check IP on the profile and read the warnings for country or timezone mismatch and datacenter IPs 5. Launch the profile and load the target page to start the test ### Prompt to paste into your agent ```text Using the repo chienbm98/foxprofile, create or update the profile with the proxy , timezone and locale , then run Check IP. Return the exit IP and any warnings. Verify that the timezone and locale fields hold the values you set and are not blank. ``` ### Caveat The README warns that GeoIP databases can disagree, so a Vietnamese IP may get Asia/Bangkok instead of Asia/Ho_Chi_Minh unless you pin the timezone yourself. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/chienbm98-foxprofile/check-exit-ip-and-geo-before-testing/ ## How to move profiles between machines and export cookies with Foxprofile Repo: [chienbm98/foxprofile](https://github.com/chienbm98/foxprofile) | Difficulty: Intermediate | Time: 45 minutes | Basis: From the README Export a profile as a ZIP and its cookies as cookies.txt for tools like yt-dlp or curl. **Who it is for:** A user moving a set of profiles to a new computer, or a developer who needs a session's cookies for a download script. **The problem:** Rebuilding profiles by hand loses their fingerprints and logins, and command-line tools need cookies in a specific format. **The outcome:** A ZIP file holding the profile, with its fingerprint, that imports on another machine, plus a Netscape cookies.txt file for a download tool. ### Steps 1. Stop the profile's browser, since cookie export needs it stopped 2. Export the profile as a ZIP from the profile menu, choosing whether to include browser data 3. Copy the ZIP to the new machine, install FoxProfile there, and import the ZIP 4. Open Cookies & fingerprint for the profile and export cookies in Netscape cookies.txt format 5. Pass the cookies.txt file to the download tool, for example yt-dlp or curl ### Prompt to paste into your agent ```text Using the repo chienbm98/foxprofile, export the profile as a ZIP and its cookies as Netscape cookies.txt. Return the file paths and the number of cookies exported. Verify that the profile's browser was stopped before the export. ``` ### Caveat The README says the profile's browser must be stopped before cookies are read or written, and the fingerprint travels with the ZIP while the Chrome engine remains experimental. Risk, credentials: Exported ZIP files and cookie files contain live session data, so store and share them only with people who should hold those logins. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/chienbm98-foxprofile/move-profiles-and-export-cookies/