Skip to content

JobSnap v0.2.0 - Faster saves, nicer extension UI

Pre-release
Pre-release

Choose a tag to compare

@Ahnaf19 Ahnaf19 released this 25 Dec 16:24
· 48 commits to main since this 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: --skip avoids 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" --skip

Re-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.html

CLI commands & arguments

  • save <bdjobs_url>: BDJobs job details URL (expects /jobs/details/<job_id>)
  • --out <dir>: output root folder (defaults to jobs/)
  • --skip: do not overwrite if the job already exists
  • reparse <job_dir|raw_html>: either a job folder containing raw.html or the path to raw.html
  • --help / -h: show usage + examples

Optional config:

  • Create a .env at the repo root with OUTPUT_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.html

Show help:

node ./cli/jobsnap.js --help
# or
npm run jobsnap -- --help

Output

  • raw.html (snapshot)
  • job.json (structured)
  • job.md (clean Markdown)
  • index.jsonl (append-only index)

Tests

node --test
# or
npm test

Extension

  • 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