whatisgithub

What is boss-zhipin-scraper-tui?

randolph555/boss-zhipin-scraper-tui — explained in plain English

Analysis updated 2026-05-18

17PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A terminal app for browsing BOSS Zhipin job listings, previewing job details, and sending or replying to messages, all without leaving the terminal.

Mindmap

mindmap
  root((BOSS Live TUI))
    What it does
      Browse job listings
      Preview job details
      Reply to messages
      Send greetings
    Tech stack
      Python
      Textual
      Chrome CDP
    Use cases
      Job search
      Message management
      AI agent integration
    Audience
      Job seekers
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search and browse job listings on BOSS Zhipin without opening a browser

USE CASE 2

Preview full job descriptions before deciding to apply

USE CASE 3

Reply to recruiter messages directly from the terminal

USE CASE 4

Draft and send an initial greeting message to a job posting

What is it built with?

PythonTextualChrome CDPuv

How does it compare?

randolph555/boss-zhipin-scraper-tui0petru/sentimoagi-eval-official/forte
Stars171717
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires launching an isolated Chrome profile and logging into BOSS Zhipin manually before first use.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

BOSS Live TUI is a terminal application for browsing job listings and handling messages on BOSS Zhipin, a Chinese job search platform. It connects to Chrome using the Chrome DevTools Protocol, then pulls the site's job list, job details, and chat conversations directly into your terminal, so you can search, page through results, preview postings, send greetings, and reply to messages without switching between browser windows. The tool is built in Python using the uv package manager and the Textual library for the terminal interface. Setup starts by installing dependencies, then launching an isolated Chrome browser session that you log into manually. From there you check that the connection and login are working, and start the live interface with a keyword and city to search. Inside the terminal, keyboard shortcuts control everything: paging through job listings, opening the message center, viewing details, drafting and sending greetings, and scrolling through job descriptions. Job details are only fetched after you press Enter on a listing, which limits how many requests get sent to the site, and any details you already viewed during the session are cached in memory so they do not need to be fetched again. Job listings and messages themselves are read live each time rather than stored locally. The project splits into two main parts internally: one part handles the Chrome connection and the actual data fetching, and the other handles the terminal display and keyboard interaction. The author notes that the fetching functions are built so they could later be wrapped as tools for an AI agent, letting something like Claude Code read the current job context and help with tasks such as rewriting a resume or preparing talking points, while the terminal interface stays focused on browsing and manual confirmation. The README states this project is for learning and personal research only, and asks users to follow BOSS Zhipin's terms of service and applicable law. It recommends using the isolated Chrome profile created during setup rather than your everyday browser. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up boss-zhipin-scraper-tui with uv and connect it to an isolated Chrome profile.
Prompt 2
Show me how to use LiveBossClient.build_agent_context() to feed job data into a custom AI agent.
Prompt 3
Write a Python script that uses fetch_page() from this project to pull AI Agent jobs in Shanghai.
Prompt 4
Explain the keyboard shortcuts in BOSS Live TUI for browsing listings and replying to messages.

Frequently asked questions

What is boss-zhipin-scraper-tui?

A terminal app for browsing BOSS Zhipin job listings, previewing job details, and sending or replying to messages, all without leaving the terminal.

What language is boss-zhipin-scraper-tui written in?

Mainly Python. The stack also includes Python, Textual, Chrome CDP.

What license does boss-zhipin-scraper-tui use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is boss-zhipin-scraper-tui to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is boss-zhipin-scraper-tui for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.