Case Study
kleinanzeigen-bot-ui
An open-source web interface built around the upstream kleinanzeigen-bot
kleinanzeigen-bot-ui is a self-hosted open-source continuation built around the existing upstream kleinanzeigen-bot. It translates file-, CLI-, and browser-based automation into a modern interface for ads, jobs, messaging, and multiple isolated workspaces.
The challenge
The upstream bot provides powerful automation but requires careful handling of YAML files, CLI commands, browser sessions, and asynchronous states. Parallel browser runs can also create login conflicts and write races, while MFA and manual sign-in still need a visible and controllable path.
The solution
The continuation layers ad management, AI-assisted creation, state synchronisation, schedules, and messaging over the existing bot capabilities. A FIFO queue deliberately limits execution to one job, live logs explain its state, and MFA plus noVNC flows enable controlled intervention; workspace isolation separates each user's data and browser profile.
The outcome
The result is a substantial self-hosted management interface with 94 REST endpoints spanning ads, bot control, jobs, authentication, messaging, schedules, and system operations. It remains explicitly an open-source continuation around the upstream kleinanzeigen-bot and does not claim ownership of the original project.
System components
What the solution is made of
Three concrete components that turn the concept into a usable system.
Ads become a workspace
CRUD, images, templates, bulk actions, AI suggestions, and status synchronisation make the file-based inventory visually manageable.
Controlled bot execution
FIFO jobs, live logs, cancellation, MFA, and an embedded noVNC browser keep problematic runs visible and actionable.
Self-hosted and multi-user
Authentication, roles, and workspace isolation separate ads, settings, schedules, and browser profiles within one installation.