Back to Projects
Oct 2026

Kerjo

A Python and Svelte job-search workspace that collects real, dated vacancies from supported sources, records scraper progress, and manages applications locally.

Overview

Kerjo is a local-first job discovery and application tracking application. I built a Svelte browser interface over a Python standard-library API and SQLite, with real manual collection rather than background scraping or generated sample vacancies.

Ingestion pipeline

The workflow separates fetching from persistence:

Saved search + manual run
    -> source adapters
    -> normalize and classify
    -> validate publication date
    -> SQLite upsert + run log
    -> deduplicate and rank
    -> dashboard / application tracking

Workers can fetch multiple providers concurrently, but one provider is serialized and the coordinator owns database writes. Requests are capped by page and detail budgets; transient failures use bounded retries and provider rate limits are respected.

Strict freshness and provenance

The current Discover view accepts postings only if their verifiable publication timestamp is within the preceding 14 × 24 hours. Source discovery time and modification time do not substitute for publication time.

Optional public JobPosting JSON-LD and selected HTML pages can enrich job descriptions. Unknown dates and blocked sources are reported as limitations, not counted as successful discoveries.

Operator-controlled workflow

Scraping begins from the interface, with source-specific progress, failure states, and previews of records actually committed to SQLite. Users can remove individual results, multiple records, or all scrape results, with explicit confirmation and protection for application history.

Recruiter posts are imported through a controlled workflow; arbitrary LinkedIn guest scraping is not presented as supported.

Result and limits

Kerjo combines real, bounded collection with persistent history and a local job pipeline. Source availability varies, some job boards provide insufficient publication metadata, and automated or recurring scraping is intentionally not installed.

Gambaran umum

Kerjo adalah aplikasi pencarian lowongan dan pelacakan lamaran yang berjalan secara lokal. Saya membuat interface Svelte, API Python standard library, dan SQLite sebagai penyimpanan. Scraping dimulai hanya lewat aksi pengguna dan tidak menampilkan lowongan demo sebagai hasil nyata.

Pipeline ingestion

Pencarian tersimpan diteruskan ke adapter sumber, normalisasi, klasifikasi, validasi tanggal publikasi, lalu SQLite. Beberapa provider dapat diambil paralel dengan concurrency terbatas, tetapi request per provider terserialisasi dan penulisan database dikerjakan thread koordinator.

Freshness dan observability

Discover hanya menerima lowongan dengan tanggal publikasi terverifikasi dalam 14 hari terakhir. Job tanpa tanggal, bertanggal masa depan, atau terlalu lama tidak masuk batch baru. UI menampilkan progres, hasil yang benar-benar tersimpan, serta kegagalan provider; deskripsi dapat dilengkapi dari JobPosting JSON-LD secara terbatas.

Hasil dan batasan

Pengguna dapat menjalankan scraping manual, menghapus hasil dengan konfirmasi, dan melindungi riwayat lamaran. Situs dengan autentikasi atau CAPTCHA tidak dipaksa; detail dan tanggal mungkin tidak tersedia. Kerjo sengaja tidak menjadwalkan scraping otomatis.

Resumen

Kerjo es una aplicación local para descubrir vacantes y gestionar candidaturas. Construí la interfaz Svelte, una API Python estándar y almacenamiento SQLite. La recogida se activa manualmente; los resultados no se sustituyen por ofertas de ejemplo.

Pipeline de ingesta

Las búsquedas guardadas pasan por adaptadores, normalización, clasificación, verificación de fechas y persistencia en SQLite. Varios proveedores pueden consultarse en paralelo, pero las solicitudes por proveedor se serializan y las escrituras quedan en el hilo coordinador.

Vigencia y observabilidad

Discover exige una fecha de publicación verificable de los últimos catorce días. Se excluyen las ofertas sin fecha, futuras o antiguas. La interfaz muestra progreso, registros realmente almacenados y fallos. La descripción puede enriquecerse de forma limitada con JobPosting JSON-LD público.

Resultado y límites

La persona puede iniciar una recogida real, eliminar resultados con confirmación y proteger las candidaturas guardadas. No se eluden bloqueos de autenticación ni CAPTCHA; algunas fuentes no publican fechas o detalles. Kerjo no instala horarios automáticos.

Présentation

Kerjo est un outil local de découverte d’offres et de suivi des candidatures. J’ai construit l’interface Svelte, une API Python standard et le stockage SQLite. La collecte se lance manuellement; aucune offre de démonstration n’est présentée comme réelle.

Pipeline d’ingestion

Les recherches enregistrées passent par des adaptateurs, la normalisation, la classification, la validation des dates et SQLite. Plusieurs fournisseurs sont consultés en parallèle, mais les requêtes d’un même fournisseur sont sérialisées et le coordinateur contrôle les écritures.

Fraîcheur et suivi

Discover exige une date de publication vérifiée dans les quatorze derniers jours. Les offres sans date, futures ou anciennes sont exclues. L’interface présente progression, résultats persistés et erreurs. Un enrichissement limité peut lire des descriptions JobPosting JSON-LD publiques.

Résultat et limites

L’utilisateur peut lancer la collecte, supprimer des résultats après confirmation et préserver ses candidatures. Les restrictions d’authentification et CAPTCHA ne sont pas contournées; certaines sources manquent de dates ou détails. Aucun scraping planifié n’est installé.

Überblick

Kerjo ist eine lokal laufende Anwendung zur Stellensuche und Bewerbungsverfolgung. Ich entwickelte die Svelte-Oberfläche, eine Python-Standardbibliothek-API und SQLite-Speicherung. Datensammlung beginnt nur manuell; Beispieldaten erscheinen nicht als echte Stellen.

Ingestion-Pipeline

Gespeicherte Suchen laufen durch Quelladapter, Normalisierung, Klassifizierung, Datumsprüfung und SQLite. Mehrere Anbieter werden begrenzt parallel abgefragt, Anfragen an denselben Anbieter bleiben jedoch seriell und Datenbank-Schreibvorgänge erfolgen im Koordinator.

Aktualität und Beobachtbarkeit

Discover akzeptiert nur verifizierte Veröffentlichungen der letzten vierzehn Tage. Undatierte, zukünftige und ältere Stellen bleiben ausgeschlossen. Die UI zeigt echte persistierte Ergebnisse, Fortschritt und Fehler; öffentliche JobPosting JSON-LD-Daten können Beschreibungen begrenzt ergänzen.

Ergebnis und Grenzen

Nutzer können echte Abrufe starten, Ergebnisse nach Bestätigung löschen und Bewerbungen schützen. Authentifizierungsschranken und CAPTCHA werden nicht umgangen. Fehlende Datumsfelder begrenzen die Abdeckung; automatische Scraping-Zeitpläne gibt es nicht.

概要

Kerjoはローカル環境で求人を収集し応募を管理するアプリです。SvelteのUI、Python標準ライブラリのAPI、SQLite保存を実装しました。収集は手動で開始し、サンプル求人を実際の結果として表示しません。

収集Pipeline

保存した検索条件をSource Adapter、正規化、職種分類、投稿日検証へ渡し、SQLiteに保存します。複数Providerは上限付きで並列取得できますが、同じProviderのリクエストは直列化し、DB書き込みはCoordinatorが担当します。

鮮度と可観測性

Discoverは直近14日間に公開されたことを確認できる求人のみ表示します。投稿日不明、未来、古い求人は除外します。UIには進捗、実際に保存した結果、Providerエラーが表示され、公開JobPosting JSON-LDから説明を一部補完できます。

結果と制限

ユーザーは手動収集、確認付き削除、応募履歴の保護を操作できます。認証やCAPTCHAを回避しません。投稿日や説明が欠けるソースもあります。自動Scrapingはスケジュールしません。