Home
Docs

Install the scraper stack

This app reads threads through reddit-scraper-express-server on your machine (default port 3037). Clone both repos, set .env files, then run the health check — there is no hosted Railway backend for cloners. http://localhost:3037

Open-source repositories

Clone and run reddit-scraper-express-server and free-reddit-scraper-web on your machine.

Scraper API

Open on GitHubREADME setup
git clone https://github.com/Luckee-Core/reddit-scraper-express-server.git

Web UI

Open on GitHub
git clone https://github.com/Luckee-Core/free-reddit-scraper-web.git

Setup checklist

  1. 1

    Clone both repos

    Pull reddit-scraper-express-server and free-reddit-scraper-web from Luckee-Core (commands below).

  2. 2

    Install & configure Express

    In the API repo: npm install, copy .env.example → .env, set APIFY_API_TOKEN and SCRAPER_API_KEY, then npm run dev (port 3037).

    # reddit-scraper-express-server/.env
    APIFY_API_TOKEN=your_apify_token
    SCRAPER_API_KEY=your_shared_secret
  3. 3

    Configure this web app

    Copy .env.example → .env.local. Set REDDIT_SCRAPER_EXPRESS_URL and the same SCRAPER_API_KEY (server-only).

    # free-reddit-scraper-web/.env.local
    REDDIT_SCRAPER_EXPRESS_URL=http://localhost:3037
    SCRAPER_API_KEY=your_shared_secret
  4. 4

    Run health check

    Start both dev servers, open /dashboard, then run Check scraper API. The scrape form unlocks when Express responds.

Express URL: http://localhost:3037

curl -s http://localhost:3037/api/health