jobseek

Job Seekを選ぶ理由

次の仕事は、すでに憧れている企業にあるかもしれません。あるいは、まだ知らない企業で見つかるかもしれません。企業の採用サイトを横断して検索し、候補企業をフォローすれば、同じページを何度も確認する手間を減らせます。

• 求人情報は掲載元から。 企業の採用ページやATSフィードを閲覧できます。各求人情報から元の掲載ページにアクセスできます。
• どこでも使えるフィルター。 職種、職位、勤務地、テクノロジー、勤務形態、給与、経験、掲載言語を組み合わせて検索し、ウォッチリストとして保存できます。
• 無料の求人検索ワークスペース。 Job Seekに保存した求人について、最大10件のウォッチリスト、毎週のメールダイジェスト、応募状況トラッカーを利用できます。
• Proで、さらに自分に合った求人を。 Narrowedは、職種名や標準フィルターだけでなく、個人の条件に照らして求人の説明を比較します。
• オープンソースで、さまざまなツールから利用可能。 ウェブアプリ、公開REST API、ホスト型MCPサーバーを利用できます。

jseek.coでできること

企業の採用ページを横断して求人を検索

アカウントなしで求人を探せます。フィルターを組み合わせ、エンジニアリングやデザインから、金融、オペレーション、医療などに至るまで、何千もの雇用主から関連する求人を見つけましょう。

企業をフォローして毎週の求人通知を受け取る

検討している方向性ごとに、ウォッチリストを保存できます。選んだ雇用主、職種、勤務地、またはその組み合わせを登録しましょう。通知を有効にすると、新たに条件に合った求人を毎週メールダイジェストで受け取れます。同じような仕事を探している人と、リンクでウォッチリストを共有できます。

応募、面接、内定を管理する

求人を保存し、応募した日を記録し、面接の段階や日程を追加して、結果を更新できます。応募トラッカーでは、元の求人情報と進捗状況を一緒に管理できます。パイプラインの統計を見れば、求職活動の状況を把握できます。

Narrowed で、職種名の裏にある仕事を見つける

同じ職種名でも、実際の業務内容は大きく異なることがあります。重視することを、普段の言葉で説明してください。

ユーザーと直接関わり、その課題を製品の改善につなげる仕事がしたいです。人の管理は希望しません。

Narrowed はウォッチリスト内の求人情報を確認し、条件に合う求人を選び出します。Job Seek Pro に含まれています。通常の検索、ウォッチリスト、週次メールダイジェスト、応募管理は引き続き無料です。Pro の詳細と現在の提供状況をご覧ください。

企業の採用状況を知る

企業ページでは、現在の求人、求人掲載の動向、類似企業をまとめて確認できます。求人の掲載元を開いたり、見つけた情報をもとに次のウォッチリストを作成したりできます。

求人検索を始める →

スイスの少人数チーム、Colophon Group が開発しています。English、Deutsch、français、italiano で利用できます。

AI ツールやコードから Job Seek を利用する

ホスト型 MCP エンドポイントでは、求人検索、求人情報のメタデータ、企業検索、フィルターの確認、条件を事前入力したウォッチリストへのリンクに利用できるツールを提供しています。また、次の 3 つの書き込みツールから、バグ報告、機能の提案、使いやすさに関するフィードバックも送信できます。

https://jseek.co/mcp

Streamable HTTP を使用し、認証は不要です。URL をカスタム MCP コネクターとして追加するか、公開済みパッケージをローカルで実行してください。

npx @jseek/mcp-server

クライアントごとのセットアップ方法とツールの使用例については、packages/mcp-server/README.md をご覧ください。HTTP 連携を直接行う場合は、公開 REST コントラクトを /openapi.json で確認できます。

企業を追加する

company-request ラベルが付いた未解決の Issue は、追加を待っている企業です。本番環境のバックログは、Hetzner でホストされた独立環境の Codex ランナーが処理します。リポジトリの指示に従うコーディングエージェントであれば、コントリビューターが Issue を解決できます。

ws はエージェント用のユーティリティです。 ワークフローを実行し、分離された状態を管理して、検証ゲートを適用します。手動設定して対話的に操作するウィザードではありません。

環境には git、認証済みの gh CLI、Python 3.13 以降、ウェブアクセスが必要です。ワークフローパッケージをインストールします。

pip install jobseek-crawler-setup

次に、コーディングエージェントに次のタスクを指示します。

ws task --issue <NUMBER> を実行し、表示された指示に従ってください。

ws は Issue を取得して重複を確認し、企業と関連するキャリアボードを調査して、モニターとスクレーパーの選択をガイドします。また、抽出したデータやブランドアセットを検証し、プルリクエストを作成します。登録済みのクローラー種別は、一般的な ATS API、サイトマップ、構造化データ、レンダリング済みページ、PDF、ベンダー固有の形式に対応しています。

追加したい企業の Issue がありませんか？依頼してください。 どなたでも依頼できます。

保守されているワークフローのリファレンスは docs/01-agent-workflow.md です。

アーキテクチャ

企業と取締役会の CSV が設定の信頼できる唯一の情報源です。クローラーは運用状態を独自の Postgres データベースで管理し、スケジューリングには Redis を使用し、検索可能なドキュメントを Typesense に公開して、詳細な説明を S3 互換のオブジェクトストレージに保存します。Web アプリは、認証、ウォッチリスト、応募管理データを別の Postgres 境界で管理します。

%%{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"]

メンテナンスされている ドキュメントインデックス から始めて、システム概要、クローラーのアーキテクチャ、Typesense リファレンスをお読みください。

自分で実行する

Job Seek はセルフホスト可能ですが、現在このリポジトリでは、運用者が管理するサービスを前提としています。ルートの docker-compose.yml は Postgres と Typesense 用の開発環境の足場であり、本番環境をワンコマンドでデプロイできる構成ではありません。

前提条件

• Python 3.13 以降と uv
• Node.js 22 以降と pnpm 10
• クローラーが所有する Postgres データベース
• Web アプリが所有する別の Postgres データベース。両方のデータベースを同じサーバーで実行してもかまいません
• Redis
• Typesense
• 求人情報の詳細説明を保存するための S3 互換オブジェクトストレージ

重要な環境の境界は次のとおりです。

これらのサービスをプロビジョニングしたら、apps/crawler/.env.example をひな形として apps/crawler/.env.local を作成し、apps/web/.env.local も作成してから、次の順序で初期化します。

git clone https://github.com/colophon-group/jobseek
cd jobseek
corepack enable
pnpm install

# Web-owned database
cd apps/web
pnpm db:migrate

# Crawler-owned database and derived stores
cd ../crawler
uv sync
uv run playwright install chromium-headless-shell  # required by run-browser
uv run alembic -c src/migrations/alembic.ini upgrade head
uv run crawler setup-typesense
uv run crawler sync

クローラーを完全にデプロイするには、次の 4 つのプロセスの役割を稼働させ続けます。

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

apps/web からフロントエンドを別途起動します。

pnpm dev                    # http://localhost:3000

本番環境の運用者は、スコープを限定した Typesense キーを使用し、docs/README.md からリンクされているデプロイと復旧の手順書を参照してください。

リポジトリの内容

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` package
docs/                     Architecture references, ADRs, routines, and runbooks
scripts/                  Deployment, reconciliation, backup, and maintenance tools

開発

apps/crawler から実行するクローラーのチェック：

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

apps/web から実行する Web アプリのチェック：

pnpm test
pnpm lint
pnpm typecheck
pnpm build

リポジトリ全体に適用されるコントリビューターとエージェント向けの指示は、AGENTS.md にあります。クローラー固有のコマンドと運用上の注意事項は、apps/crawler/AGENTS.md にあります。

ライセンス

• コード — MIT。無保証で使用、改変、再配布できます。
• 求人情報データ — CC BY-NC 4.0。研究および非商用の再利用は、帰属表示を行えば無料で利用できます。厳密な Open Knowledge Definition における「オープンデータ」ではありません。商用ライセンスについては、[email protected] までお問い合わせください。