JobSeek Expat 🌍

JobSeek Expat is a powerful, open-source CLI tool designed to help expats and international job seekers find English-speaking jobs in non-English speaking countries (like Germany, France, Netherlands, etc.).

It scrapes major job boards, filters out local-language requirements, and presents you with a clean, curated list of opportunities.

🚀 Features

• Multi-Platform Scraping: Search LinkedIn, Indeed, and Glassdoor simultaneously.
• Smart Filtering:
  • English Only: Automatically detects job description language.
  • No "Local Language" Required: Filters out jobs requiring C1/Fluent local language skills (customizable).
  • Experience Level: Filter by Seniority (Entry, Mid-Senior, etc. - Best on LinkedIn).
• Flexible Locations: Search multiple cities or "Remote" in your target country.
• Advanced Search:
  • Multiple Keywords: Search for "Developer, Designer" in one go.
  • Exclusion Lists: Hates specific terms? --exclude "intern, thesis".
• Output Options:
  • Beautiful CLI Tables: Clickable links, color-coded output.
  • JSON: Machine-readable format for automation.

📦 Installation

From PyPI (Recommended)

pip install jobseek-expat

From Source

git clone https://github.com/electricalgorithm/jobseek-expat.git
cd jobseek-expat
pip install .

🛠️ Usage

Once installed, the jobseek-expat command (and its short alias je) is available globally.

Generic syntax:

jobseek-expat "KEYWORD" --country "COUNTRY_NAME" [OPTIONS]
# or simply:
je "KEYWORD" --country "COUNTRY_NAME" [OPTIONS]

Examples

1. The Classic Expat Search (Berlin) Find "Software Engineer" jobs in Germany (Berlin) that likely don't require German.

jobseek-expat "Software Engineer" --location "Berlin"

2. Multi-City & Remote Search Search for "Product Manager" in Amsterdam and Remote within the Netherlands.

jobseek-expat "Product Manager" \
  --country "Netherlands" \
  --location "Amsterdam, Remote" \
  --local-language "Dutch"

Note: We specify --local-language "Dutch" so it filters out "Dutch required" jobs.

3. The "Broad Net" Strategy Search for Developer OR Data Scientist roles in France, specifically Paris, excluding internships.

jobseek-expat "Developer, Data Scientist" \
  --country "France" \
  --location "Paris" \
  --local-language "French" \
  --exclude "intern, stage, internship" \
  --results-wanted 50

Command Line Options

🤝 Contributing

We welcome contributions! Whether it's adding a new filter, improving the language detection, or supporting more job boards.

1. Fork the Project
2. Create your Feature Branch
3. Commit your Changes
4. Push to the Branch
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

Built with ❤️ for the global expat community.