jpjobs

Unified scraper for Japan's major job boards, with AI-assistant integration.

Pure Python. No API keys. No account required. Output drops cleanly into Claude / ChatGPT / Codex for ranking, filtering, and cover-letter drafting.

Why this exists

• LinkedIn and Indeed index only a fraction of Japan's job market — the rest live on Japanese-language boards.
• HelloWork (Japan's largest government job board, hundreds of thousands of listings) has no working public scraper. Its JavaScript-locked Maba form defeats naive HTTP scrapers.
• Existing alternatives like python-jobspy are degrading under LinkedIn's anti-bot.
• No unified job schema exists across Japan boards.

jpjobs solves all four behind one CLI and LLM-friendly output.

Sources

10 active sources returning real jobs as of v0.2:

7 experimental (anti-bot or login walls — contributions welcome): indeed, careercross, jrecin, otta, wellfound, doda, enworld

A typical Tokyo IT-Support scan across the 10 active sources returns ~300–400 deduplicated jobs.

Install

pip install jpjobs
playwright install chromium   # one-time, only for hellowork / indeed

Quickstart

# List supported sources
jpjobs --list-sources

# Cast the widest net: every source, last 7 days
jpjobs --keyword="IT Support" --pages=2

# Tokyo English-friendly only, ready to paste into an AI assistant
jpjobs --sources=linkedin,tokyodev,japandev,gaijinpot \
       --keyword="IT Support" --prefecture=tokyo \
       --format=llm > jobs.txt

See USAGE.md for a step-by-step walkthrough including troubleshooting.

CLI reference

Output formats

Using with AI assistants

See AGENTS.md. Typical flow:

# 1. Scan
jpjobs --sources=linkedin,tokyodev,gaijinpot \
       --keyword="IT Support" --format=llm > jobs.txt

# 2. Open one of the prompts, paste your resume + jobs.txt into Claude / ChatGPT
cat prompts/rank-against-resume.md

Ready-made prompts:

• prompts/rank-against-resume.md
• prompts/filter-english-friendly.md
• prompts/extract-companies-for-research.md
• prompts/summarize-market-trends.md
• prompts/write-tailored-cover-letter.md

Job schema

Every source returns the same shape. Useful when piping to jq or AI assistants:

Configuration (optional)

Drop a jpjobs.config.json in your working directory:

{
  "sources": ["hellowork", "linkedin", "tokyodev"],
  "prefecture": "tokyo",
  "keywords": ["IT Support", "Helpdesk"],
  "pages": 2
}

No accounts, no API keys, no .env. Your resume and chat history go to whichever AI provider you paste them into — jpjobs never sees them.

Adding a source

See CONTRIBUTING.md. Short version: copy jpjobs/sources/_template.py, implement the scan() function, register the slug in aggregate.py.

Limitations

• Detail pages aren't scraped — listings only.
• Some boards (Wantedly full apply, Bizreach, Findy) are login-gated and intentionally unsupported.
• Heavy anti-bot sites (Wellfound, Doda from some networks) are shipped as experimental stubs.
• Rate limits apply. Large scans take minutes.

Ethical use

Scrape responsibly. Respect each site's robots.txt. Throttle requests. Identify yourself via the default User-Agent. Don't spam employers or mass-apply — job boards exist to serve job seekers and employers both.

License

MIT — see LICENSE.

Disclaimer

This project is not affiliated with HelloWork, MHLW, LinkedIn, Indeed, TokyoDev, JapanDev, Daijob, CareerCross, GaijinPot, JobsInJapan, Green, Forkwell, Wantedly, or any other listed board. All trademarks belong to their respective owners.