https://github.com/arinbalyan/scrappy
Bulk job-board scraper with 100+ sites, email enrichment, deterministic quality scoring, and multi-format exports (CSV/JSONL/XLSX/Parquet). Designed for scheduled bulk-first operations with per-site rate limiting, proxy pools, and resume support.
https://github.com/arinbalyan/scrappy
ats csv data-engineering email-verification go golang job-board jsonl parquet proxy quality-scoring recruitment scraping socks5 web-scraping xlsx
Last synced: about 2 hours ago
JSON representation
Bulk job-board scraper with 100+ sites, email enrichment, deterministic quality scoring, and multi-format exports (CSV/JSONL/XLSX/Parquet). Designed for scheduled bulk-first operations with per-site rate limiting, proxy pools, and resume support.
- Host: GitHub
- URL: https://github.com/arinbalyan/scrappy
- Owner: arinbalyan
- License: other
- Created: 2026-05-19T17:33:25.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-26T17:07:04.000Z (about 21 hours ago)
- Last Synced: 2026-06-26T19:07:12.500Z (about 19 hours ago)
- Topics: ats, csv, data-engineering, email-verification, go, golang, job-board, jsonl, parquet, proxy, quality-scoring, recruitment, scraping, socks5, web-scraping, xlsx
- Language: Go
- Homepage: https://arinbalyan.github.io/scrappy/
- Size: 13 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
scrappy
Bulk job-board scraper
## Features
- **100+ job boards / ATS endpoints** -- LinkedIn, Indeed, Google Jobs, ATS suites, and niche boards
- **Bulk-first** -- fan out across all sites concurrently, process thousands of postings
- **Go-native** -- static binary (~10 MB), zero Python dependency
- **Email enrichment** -- MX-validated contact addresses from descriptions and company pages
- **Quality scoring** -- deterministic 0-100 score per posting without an LLM
- **Multiple exports** -- JSONL, CSV, XLSX, Parquet
- **Proxy support** -- SOCKS5/HTTP with TCP-dial health checks and round-robin
- **Memory-aware** -- configurable memory cap with automatic concurrency scaling
- **Browser fallback** -- optional Playwright-based rendering for anti-bot sites (monster)
## Quick start
### One-line install
```bash
# Linux & macOS
curl -fsSL https://arinbalyan.github.io/scrappy/install.sh | sh
# Windows (PowerShell)
irm https://arinbalyan.github.io/scrappy/install.ps1 | iex
```
### Manual install
```bash
# Linux (x86_64)
curl -fsSL https://github.com/arinbalyan/scrappy/releases/latest/download/scrappy_linux_amd64.tar.gz | tar xz && sudo mv scrappy_linux_amd64 /usr/local/bin/scrappy
# macOS (Apple Silicon)
curl -fsSL https://github.com/arinbalyan/scrappy/releases/latest/download/scrappy_darwin_arm64.tar.gz | tar xz && sudo mv scrappy_darwin_arm64 /usr/local/bin/scrappy
# macOS (Intel)
curl -fsSL https://github.com/arinbalyan/scrappy/releases/latest/download/scrappy_darwin_amd64.tar.gz | tar xz && sudo mv scrappy_darwin_amd64 /usr/local/bin/scrappy
```
```powershell
# Windows (PowerShell)
curl.exe -LO https://github.com/arinbalyan/scrappy/releases/latest/download/scrappy_windows_amd64.zip
Expand-Archive scrappy_windows_amd64.zip -DestinationPath .
.\scrappy_windows_amd64.exe --help
```
### Or install with Go
```
go install github.com/arinbalyan/scrappy/cmd/scrappy@latest
```
### First scrape
```bash
scrappy --sites remoteok --search "golang" --results-wanted 50
```
For the interactive wizard, run without arguments:
```bash
scrappy
```
## Documentation
| # | Document | Description |
|---|----------|-------------|
| — | `scrappy --help` | Complete CLI reference with flag descriptions |
| — | `.env.example` | All supported environment variables |
Use `scrappy doctor` to diagnose your setup.
## Sites supported
| Site | Site | Site | Site |
|------|------|------|------|
| `4dayweek` | `ats-rippling` | `freelancercom` | `nofluffjobs` |
| `academiccareers` | `ats-smartrecruiters` | `functionalworks` | `opensourcedesignjobs` |
| `adzuna` | `ats-successfactors` | `germantechjobs` | `powertofly` |
| `aijobs` | `ats-talentlyft` | `getonboard` | `pyjobs` |
| `androidjobs` | `ats-taleo` | `golangjobs` | `pythonjobs` |
| `arbeitnow` | `ats-teamtailor` | `google` | `railsjobs` |
| `arbeitsagentur` | `ats-trakstar` | `greenhouse` | `realworkfromanywhere` |
| `ats-adp` | `ats-ukg` | `greenjobsboard` | `reed` |
| `ats-ashby` | `ats-workable` | `guardianjobs` | `remotefirstjobs` |
| `ats-avature` | `ats-workday` | `gunio` | `remoteok` |
| `ats-bamboohr` | `authenticjobs` | `hackernews` | `remotive` |
| `ats-breezyhr` | `bayt` | `hasjob` | `simplyhired` |
| `ats-bullhorn` | `berlinstartupjobs` | `headhunter` | `snagajob` |
| `ats-comeet` | `builtin` | `higheredjobs` | `startupjobs` |
| `ats-crelate` | `canadajobbank` | `himalayas` | `stepstone` |
| `ats-deel` | `careerbuilder` | `hiringcafe` | `swissdevjobs` |
| `ats-fountain` | `careerjet` | `huggingfacejobs` | `talroo` |
| `ats-freshteam` | `careeronestop` | `icrunchdata` | `techcareers` |
| `ats-gem` | `clojurejobs` | `indeed` | `tesla` |
| `ats-hiringthing` | `conservationjobs` | `infojobs` | `themuse` |
| `ats-icims` | `coroflot` | `internshala` | `ukvisajobs` |
| `ats-ismartrecruit` | `crunchboard` | `ismartrecruit` | `undpjobs` |
| `ats-jazzhr` | `cryptocurrencyjobs` | `jazzhr` | `upwork` |
| `ats-jobscore` | `cryptojobslist` | `jobdataapi` | `usajobs` |
| `ats-jobvite` | `devitjobs` | `jobicy` | `virtualvocations` |
| `ats-jobylon` | `devopsjobs` | `jobindex` | `vuejobs` |
| `ats-joincom` | `dice` | `jobsacuk` | `web3career` |
| `ats-loxo` | `djinni` | `jobsch` | `wellfound` |
| `ats-manatal` | `jobicy` | `jobsdb` | `weworkremotely` |
| `ats-mercor` | `drupaljobs` | `jobsinjapan` | `wordpressjobs` |
| `ats-oracle` | `duunitori` | `jobspresso` | `workingnomads` |
| `ats-personio` | `ecojobs` | `jobstreet` | `wuzzuf` |
| `ats-phenom` | `echojobs` | `jobtechdev` | `ycjobs` |
| `ats-pinpoint` | `elixirjobs` | `joinrise` | `ziprecruiter` |
| `ats-recruitee` | `eurojobs` | `landingjobs` | |
| `ats-recruiterflow` | `exa` | `linkedin` | |
| `ats-recruitify` | `findwork` | `monster` | |
## Installation
Install via one-liner above, `go install`, or build from source with `go build ./cmd/scrappy`.
```go
import (
"github.com/arinbalyan/scrappy/pkg/scrappy"
)
engine := scrappy.NewEngine()
jobs, err := engine.Scrape(ctx, scrappy.ScraperInput{
Sites: []string{"linkedin", "indeed"},
SearchTerm: "software engineer",
Location: "San Francisco, CA",
ResultsWanted: 500,
})
```
## License
This project is licensed under the terms specified in the [LICENSE](LICENSE) file. Personal, non-commercial use only.
