Repository navigation
JobSnap v0.2.0 - Faster saves, nicer extension UI
Pre-release
Pre-release
JobSnap now adds a skip mode for the CLI, improved text cleanup, and a richer extension popup with a paste-URL flow.
What’s new
- CLI:
--skipavoids re-downloading when a job already exists. - Parser cleanup: drops placeholder values like
Vacancy: --, fixes double punctuation, and adds spacing after sentence breaks. - Extension: redesigned popup with a stronger call-to-action, a “Paste URL” download option, and branded icons.
- Tests: new fixture covering placeholder cleanup and punctuation fixes.
Requirements
- Node.js 18+ (tested with Node 22)
Quick start (CLI)
Save a circular:
node ./cli/jobsnap.js save "https://bdjobs.com/jobs/details/1436685"
# or
npm run jobsnap -- save "https://bdjobs.com/jobs/details/1436685"Skip if already downloaded:
node ./cli/jobsnap.js save "https://bdjobs.com/jobs/details/1436685" --skip
# or
npm run jobsnap -- save "https://bdjobs.com/jobs/details/1436685" --skipRe-parse an existing snapshot (no re-download):
node ./cli/jobsnap.js reparse jobs/1436685
node ./cli/jobsnap.js reparse jobs/1436685/raw.html
# or
npm run jobsnap -- reparse jobs/1436685
npm run jobsnap -- reparse jobs/1436685/raw.htmlCLI commands & arguments
save <bdjobs_url>: BDJobs job details URL (expects/jobs/details/<job_id>)--out <dir>: output root folder (defaults tojobs/)--skip: do not overwrite if the job already existsreparse <job_dir|raw_html>: either a job folder containingraw.htmlor the path toraw.html--help/-h: show usage + examples
Optional config:
- Create a
.envat the repo root withOUTPUT_DIR=...to change the default output directory.
Examples (covering every arg):
node ./cli/jobsnap.js save "https://bdjobs.com/jobs/details/1436685"
node ./cli/jobsnap.js save "https://bdjobs.com/jobs/details/1436685" --out ./jobs
node ./cli/jobsnap.js save "https://bdjobs.com/jobs/details/1436685" --skip
node ./cli/jobsnap.js reparse jobs/1436685
node ./cli/jobsnap.js reparse jobs/1436685/raw.htmlShow help:
node ./cli/jobsnap.js --help
# or
npm run jobsnap -- --helpOutput
raw.html(snapshot)job.json(structured)job.md(clean Markdown)index.jsonl(append-only index)
Tests
node --test
# or
npm testExtension
- Load unpacked from
extension/(Developer mode ON), open a BDJobs job details page, click “Download from current tab”, or paste a BDJobs link and click “Download from URL”.
Known limitations
- Targets
https://bdjobs.com/jobs/details/<job_id>pages (no “Applied jobs” automation) - PDF export + Bangla support are not in this release yet