whatisgithub

What is job-searcher?

itssosunny/job-searcher — explained in plain English

Analysis updated 2026-05-18

12PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A read-only Claude Code skill pack that collects and normalizes public job postings from 22 job platforms into one JSON format.

Mindmap

mindmap
  root((job searcher))
    What it does
      Collect job postings
      Normalize to one schema
      Compute deadline status
    Tech stack
      Python
      curl_cffi
      Claude Code plugin
    Use cases
      Multi site job search
      Open postings filter
      Per platform scripts
    Audience
      Job seekers
      Claude Code users
    Notes
      Read only no login
      22 platforms 21 verified

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask a Claude Code agent to collect job postings for a specific role across several Korean job boards.

USE CASE 2

Filter collected postings down to ones that are still open based on normalized deadline status.

USE CASE 3

Run a single platform's collector script directly to pull postings without installing the full plugin.

USE CASE 4

Combine postings from multiple sources into one table since every collector outputs the same schema.

What is it built with?

Pythoncurl_cffiBeautifulSouplxmlClaude Code

How does it compare?

itssosunny/job-searcheraim-uofa/reasonmatchairbone42/360-data-athlete
Stars121212
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/55/54/5
Audiencevibe coderresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installed as a Claude Code plugin, which auto-installs its Python dependencies, can also be run as standalone per-platform scripts.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

job-searcher is a Claude Code skill pack that collects public job postings from 22 Korean and international job platforms and normalizes them into a single JSON format. The idea is to let an AI agent handle the repetitive task of checking multiple job boards like JobKorea, Saramin, Wanted, and Jumpit, rather than a person visiting each site manually. It also normalizes each posting's deadline into a status of open, closing soon, closed, or rolling, so a user can quickly filter to postings that are still accepting applications. The tool is explicitly read only. It does not log in anywhere, does not save data on its own, and does not submit job applications. It only fetches public search, listing, or RSS pages using GET requests. The recommended way to use it is as a Claude Code plugin, after which a user can ask in plain language for things like postings for a specific role from specific sites, and the agent collects them. It can also be run directly as Python scripts per platform, each of which is self contained with its own fetching, parsing, and output logic. Of the 22 supported platforms, 21 were verified live and working as of the README's writing, each returning real postings through public pages or APIs. One platform, RocketPunch, uses a JavaScript-only page with anti-bot protection, so its collector honestly reports that a browser is needed rather than fabricating data. The project states a design principle of honesty: any field a source does not expose is left null rather than guessed, and a collected posting is not guaranteed to still be open. Installing requires the Python packages curl_cffi, beautifulsoup4, and lxml, which the agent installs automatically when used as a plugin. The project is MIT licensed.

Copy-paste prompts

Prompt 1
Install the job-searcher plugin and collect the latest 20 marketer postings from JobKorea.
Prompt 2
Collect data engineer postings from Wanted and Jumpit and show me only the ones that aren't closed yet.
Prompt 3
Run the jobkorea-collect script directly with a search query for backend engineer roles.
Prompt 4
Explain what the deadline_date and status fields mean in this project's JobPosting schema.

Frequently asked questions

What is job-searcher?

A read-only Claude Code skill pack that collects and normalizes public job postings from 22 job platforms into one JSON format.

What language is job-searcher written in?

Mainly Python. The stack also includes Python, curl_cffi, BeautifulSoup.

What license does job-searcher use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is job-searcher to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is job-searcher for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.