Skip to content

feat: add TopCV.vn and VietnamWorks scrapers with tests (Vietnam tech jobs) - #137

Open
laurentketterle-hub wants to merge 2 commits into
mergeos-bounties:masterfrom
laurentketterle-hub:feat/vietnam-scrapers-topcv-vietnamworks
Open

feat: add TopCV.vn and VietnamWorks scrapers with tests (Vietnam tech jobs)#137
laurentketterle-hub wants to merge 2 commits into
mergeos-bounties:masterfrom
laurentketterle-hub:feat/vietnam-scrapers-topcv-vietnamworks

Conversation

@laurentketterle-hub

Copy link
Copy Markdown

Vietnam Tech Jobs Scrapers — TopCV.vn + VietnamWorks

Implements two new scrapers for the Vietnam tech job market:

TopCV.vn (topcv.py)

  • Public listing page parser with HTML snippet extraction
  • Offline sample data fallback for testing and CI
  • Rate limiting (2s minimum between requests)
  • _TopCVListingParser — lightweight HTML parser for job cards

VietnamWorks (vietnamworks.py)

  • Public search result parser with HTML snippet extraction
  • Offline sample data fallback for testing and CI
  • Rate limiting (2s minimum between requests)
  • _VNWListingParser — lightweight HTML parser for result items

Tests

  • test_topcv.py: 7 tests — parser unit test (sample + empty), integration tests (search, location filter, limit, fields)
  • test_vietnamworks.py: 8 tests — parser unit test (sample + empty), integration tests (search, location filter, limit, fields)

Registry

  • Both scrapers registered in available_scrapers() with env-var-based offline mode support

ToS Compliance

  • Conservative rate limiting (≥2s between requests)
  • Proper User-Agent header
  • Graceful fallback to offline sample data on HTTP errors
  • Public-facing pages only — no authenticated endpoints

Fixes #17

Closes #17

@laurentketterle-hub

Copy link
Copy Markdown
Author

/attempt 17

@laurentketterle-hub

Copy link
Copy Markdown
Author

Friendly ping 👋 — this PR has been open for 3 days. Is there anything needed for review? Thanks!

@laurentketterle-hub

Copy link
Copy Markdown
Author

/claim

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[50 MRG] Scraper: Vietnam tech jobs board adapter (TopCV or VietnamWorks public pages — ToS-safe)

1 participant