--- title: "Deploy cloak-biz-scraper" description: "Anti-detection browser in the cloud for your AI assistant" category: "Other" url: https://railway.com/deploy/cloak-biz-scraper --- # Deploy cloak-biz-scraper Anti-detection browser in the cloud for your AI assistant **[Deploy cloak-biz-scraper on Railway](https://railway.com/template/cloak-biz-scraper)** - **Creator:** Nick Yu's Projects - **Category:** Other - **Total deploys:** 2 ## Template content ### cloak-biz-scraper - **Source:** thisnick/cloak-biz-scraper - **Health check:** /healthz - **Public domain:** Yes ## Documentation # Deploy and Host cloak-biz-scraper on Railway A cloaked cloud browser your AI assistant can drive — patched Chromium that slips past anti-bot detection, running behind your own residential proxy. On top of it are built-in tasks that scrape BizBuySell search results and archive listings into your Notion. Your server, your data: one-click deploy, everything else configured in a web UI — no terminal. ## About Hosting cloak-biz-scraper 1. **Deploy.** Click to deloy. Railway generates your `APP_SECRET` for you and builds the server (~3 minutes). 2. **Turn on Serverless.** Railway → your service → **Settings** → enable **Serverless**, so it sleeps when idle. Skipping it costs roughly **$8–9/month** for a server doing nothing. 3. **Copy `APP_SECRET`.** Railway → your service → **Variables**. This is your dashboard password — there's no other account to make. 4. **Open your server's URL and log in** with `APP_SECRET`. 5. **Fill in Settings** (each page tests itself and shows what it found): - **CloakBrowser licence** — optional; blank runs the free public build (fewer bypasses). - **Evomi proxy** — optional, but listing sites block non-residential IPs, so add one before scraping them. - **Notion** — optional; needed only to save listings into a database. ## Common Use Cases - **Cloaked browser in the cloud** — patched Chromium (CloakBrowser) that passes bot-detection checks. Drive it live in the dashboard or hand it to your assistant. - **Residential routing** — send traffic through an Evomi residential proxy so sites see a real home IP in the country/region you choose, not a datacenter. - **Many browsers at once** — a pool of instances, with a reserve so an interactive session is never starved by a batch job. - **Profiles** — durable browser identities; each keeps its own cookies, logins, and settings across relaunches. Rename, delete, or rotate a profile's exit IP without losing its cookies. - **Built-in listing tasks** — sweep a BizBuySell search page into structured listings, dedupe into a Notion database, and archive full pages. - **Connect your own driver over CDP** — every instance hands back a CDP URL you can attach Playwright, or any other browser driver, to. - **`agent_browser` MCP tools** — your assistant (ChatGPT, Claude) can open and browse any website through the cloaked browser. ## Connect ChatGPT, Claude, or Claude Code Add your server as a connector using your URL with `/mcp` on the end (copy the exact link from the app's **Connect** page — it's pre-filled): ``` https://your-server.up.railway.app/mcp ``` Your assistant registers itself and sends you to your own login page; paste `APP_SECRET`, approve, and the tools appear. **ChatGPT (work)** — **Settings → Integrations → Plugins** → the **MCPs** tab → **Add Server** → give it a name, choose **Streamable HTTP**, paste the link → **Save** → click the **Authenticate** button that appears and enter your `APP_SECRET`. **ChatGPT (classic / web)** — **Settings → Plugins** → open the **Developer Mode** setting and turn it on → back in **Plugins**, click **Browse all plugins** → top-right **add a custom app** → add an **MCP server**, paste the link, choose **OAuth**, **Scan Tools**, then sign in with your `APP_SECRET`. **Claude** — **Settings → Connectors** → **Add custom connector** → paste the link (no client ID or secret — it uses dynamic registration) → **Connect** → sign in with your `APP_SECRET`. Team/Enterprise owners add it first under **Organization settings → Connectors**. [Anthropic's connector docs](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp). **Claude Code** — run `claude mcp add --transport http cloak-biz-scraper /mcp`, start Claude Code, type `/mcp`, then select the server and enter your `APP_SECRET`. Once it's connected, just ask: - *"Open my cloaked scraper, go to this listing, and tell me the asking price and cash flow."* - *"Search BizBuySell for California businesses under $2M cash flow, then sweep the first five pages using cloaked scraper."* - *"Sweep this search and save new listings to my Notion, skipping ones already there."* - *"Archive this listing's full page into my Notion."* - *"Launch my Default profile in cloaked scraper and give me a CDP URL"* — then drive it from Playwright yourself. ## Dependencies for cloak-biz-scraper Hosting None. ### Deployment Dependencies Optional: 1. CloakBrowser Pro License Key 2. Evomi residential proxy credentials ### Implementation Details - **One browser service, many doors.** A pool of cloaked Chromium instances behind a single service layer, reachable four ways: the **MCP** endpoint (`/mcp`), a **REST** API (`/api/*`), a per-instance **CDP** URL, and the **web portal**. All configuration lives on a `/data` volume; the deploy sets only `APP_SECRET`. - **Auth.** The web UI uses a cookie session (log in with `APP_SECRET`). `/mcp` and `/api/*` use OAuth 2.1 with dynamic client registration + PKCE — unauthenticated calls get a 401. CDP and live-view URLs carry short-lived, single-browser signed tokens, never your `APP_SECRET`. ## Why Deploy cloak-biz-scraper on Railway? This is the simplest way to get a cloak browser running the cloud that is self-hosted. You own all the data and you only pay for the resources you use. ## Similar templates - [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀 - [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform - [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy. Open this page in a browser: https://railway.com/deploy/cloak-biz-scraper