Jobseek

Why Job Seek

Your next role might be at a company you already admire—or one you haven’t discovered yet. Search across employer career sites, follow a shortlist of companies, and spend less time checking the same pages for updates.

• Jobs from the source. Browse employer career pages and ATS feeds. Every listing links back to the original posting.
• Filters that travel with you. Combine role, seniority, location, technology, work mode, salary, experience, and posting language, then save your search as a watchlist.
• A free job-search workspace. Up to 10 watchlists, weekly email digests, and an application tracker for jobs saved on Job Seek.
• A closer fit with Pro. Narrowed reads job descriptions against your personal criteria, beyond job titles and standard filters.
• Open-source and accessible from your tools. Use the web app, public REST API, or hosted MCP server.

What you get on jseek.co

Search jobs across company career pages

Explore without an account. Combine filters to find relevant openings across thousands of employers, from engineering and design to finance, operations, healthcare, and more.

[Job search with company results and filters for role, location, and work preferences]

Follow companies and get weekly job alerts

Save a watchlist for each direction you’re considering: selected employers, a role, a location, or a combination. Enable notifications to receive a weekly email digest of new matches. Share a watchlist by link with someone else looking for similar work.

[A watchlist following ABB, Google, and Siemens for software engineering jobs in Switzerland]

Track applications, interviews, and offers

Save a job, record when you apply, add interview rounds and dates, and update the outcome. Your application tracker keeps the original job details alongside your progress; pipeline statistics help you see how the search is going.

[Application tracker showing saved jobs, applied roles, offers, and interview controls beside the job description]

Find the work behind the job title with Narrowed

Two roles can have the same title and very different responsibilities. Describe what matters to you in plain language:

I want to work directly with users and turn their problems into product improvements. No people management.

Narrowed checks the descriptions in your watchlist and picks out the matches. It is included with Job Seek Pro; regular search, watchlists, weekly email digests, and application tracking remain free. See Pro details and current availability.

[Narrowed results in a Swiss robotics watchlist, with the matching request and selected jobs]

Get to know an employer’s hiring

Company pages bring together current openings, posting activity, and similar employers. Open a role at its source or use what you find to build your next watchlist.

[Stripe company page with hiring activity, company details, and open jobs]

Start your job search →

Built by Colophon Group, a small team in Switzerland. Available in English, Deutsch, français, and italiano.

Use Job Seek from AI tools and code

The hosted MCP endpoint exposes tools for job search, posting metadata, company lookup, filter discovery, and prefilled watchlist links. It also accepts bug reports, feature suggestions, and usability feedback through three write tools:

https://jseek.co/mcp

It uses Streamable HTTP and does not require authentication. Add the URL as a custom MCP connector, or run the published package locally:

npx @jseek/mcp-server

See packages/mcp-server/README.md for client-specific setup and tool examples. For direct HTTP integrations, the public REST contract is available at /openapi.json.

Add a company

Open issues labelled company-request are companies waiting to be added. The production backlog is processed by an isolated, Hetzner-hosted Codex runner; contributors can resolve an issue with any capable coding agent that follows the repository instructions.

ws is an agent utility. It renders the workflow, manages isolated state, and enforces the validation gates; it is not intended as a hand-configured interactive wizard.

The environment needs git, an authenticated gh CLI, Python 3.13+, and web access. Install the workflow package:

pip install jobseek-crawler-setup

Then give your coding agent this task:

Run ws task --issue <NUMBER> and follow the printed instructions.

ws fetches the issue, checks for duplicates, researches the company and all relevant career boards, guides monitor and scraper selection, validates extracted data and brand assets, and opens the pull request. The registered crawler types cover common ATS APIs, sitemaps, structured data, rendered pages, PDFs, and vendor-specific formats.

No issue for the company you want? Request it. Anyone can.

The maintained workflow reference is docs/01-agent-workflow.md.

Architecture

Company and board CSVs are the configuration source of truth. The crawler keeps operational state in its own Postgres database, uses Redis for scheduling, publishes searchable documents to Typesense, and stores full descriptions in S3-compatible object storage. The web app owns authentication, watchlists, and application-tracker data in a separate Postgres boundary.

%%{init: {"flowchart": {"rankSpacing": 24}}}%%flowchart TD    Requests["Company requests"] --> Agent["Coding-agent PR"]    Agent --> CSV["companies.csv + boards.csv"]    CSV --> Runtime["Crawler runtime<br/>sync · Redis · HTTP/browser workers · crawler Postgres"]    Runtime --> ReadLayer["Published read layer<br/>Typesense · S3-compatible descriptions"]    ReadLayer --> Web["Next.js<br/>web app · REST API · MCP"]    Web <--> WebDB["Web Postgres"]

Start with the maintained documentation index, then read the system overview, crawler architecture, and Typesense reference.

Run it yourself

Job Seek is self-hostable, but the repository currently expects operator-managed services. The root docker-compose.yml is development scaffolding for Postgres and Typesense, not a complete one-command production deployment.

Prerequisites

• Python 3.13+ and uv
• Node.js 22+ and pnpm 10
• A crawler-owned Postgres database
• A separate web-owned Postgres database; both databases may run on the same server
• Redis
• Typesense
• S3-compatible object storage for job descriptions

The important environment boundaries are:

After provisioning those services, create apps/crawler/.env.local (using its .env.example as a starting point) and apps/web/.env.local, then initialize in this order:

git clone https://github.com/colophon-group/jobseekcd jobseekcorepack enablepnpm install
# Web-owned databasecd apps/webpnpm db:migrate
# Crawler-owned database and derived storescd ../crawleruv syncuv run playwright install chromium-headless-shell  # required by run-browseruv run alembic -c src/migrations/alembic.ini upgrade headuv run crawler setup-typesenseuv run crawler sync

A complete crawler deployment keeps four process roles running:

uv run crawler run          # HTTP workersuv run crawler run-browser  # Playwright workersuv run crawler export       # Postgres → Typesense CDCuv run crawler drain        # descriptions → object storage

Start the frontend separately from apps/web:

pnpm dev                    # http://localhost:3000

Production operators should use scoped Typesense keys and read the deployment and recovery runbooks linked from docs/README.md.

What's in the repo

apps/crawler/              Python ingestion, normalization, scheduling, and export  src/core/monitors/       Career-board discovery: ATS APIs, sitemaps, DOM, feeds  src/core/scrapers/       Posting extraction: JSON-LD, DOM, PDF, vendor formats  src/workers/             HTTP workers, browser workers, and description drain  src/exporter.py          CDC from crawler Postgres to Typesense  src/labeller/            Daily gold-dataset labelling and Hugging Face upload  src/workspace/           `ws` workflow and Codex company-request runner  data/companies.csv       Company configuration source of truth  data/boards.csv          Career boards with monitor + scraper configuration
apps/web/                  Next.js 16, Drizzle, Lingui, and Better Auth  app/[lang]/              Localized product routes: en / de / fr / it  app/api/v1/              Public REST API  app/mcp/                 Hosted Streamable HTTP MCP endpoint  src/db/schema.ts         Web-owned Postgres schema
packages/mcp-server/       Published `@jseek/mcp-server` packagedocs/                     Architecture references, ADRs, routines, and runbooksscripts/                  Deployment, reconciliation, backup, and maintenance tools

Development

Crawler checks, from apps/crawler:

uv run pytest tests/uv run ruff check .uv run pyright

Web checks, from apps/web:

pnpm testpnpm lintpnpm typecheckpnpm build

Repository-wide contributor and agent instructions live in AGENTS.md. Crawler-specific commands and operational cautions live in apps/crawler/AGENTS.md.

License

• Code — MIT. Use, modify, and redistribute it without warranty.
• Job-posting data — CC BY-NC 4.0. Free for research and non-commercial reuse with attribution. It is not “open data” under the strict Open Knowledge Definition. For commercial licensing, contact [email protected].