Liepin Agentic Sourcing v2

Overview

Automated candidate sourcing pipeline for Liepin (猎聘). Submits a background job that searches, evaluates, and communicates with candidates via browser automation + LLM evaluation.

Prerequisites

1. Environment variables (in .env):
• LIEPIN_USERNAME / LIEPIN_PASSWORD
• JD_WORKER_LLM_PROVIDER, JD_WORKER_LLM_MODEL, JD_WORKER_LLM_API_KEY, JD_WORKER_LLM_BASE_URL
• RESUME_WORKER_LLM_PROVIDER, RESUME_WORKER_LLM_MODEL, RESUME_WORKER_LLM_API_KEY, RESUME_WORKER_LLM_BASE_URL

1. Active Liepin session — must be saved before first use:

```bash

cd skills/liepin-agentic-sourcing

python3 scripts/login_and_save_session.py

python3 scripts/session_persistence_probe.py

```

How to Run

Step 1: Prepare criteria file

Create a JSON file (e.g. criteria.json) with all required fields:

{
  "position_name": "职位名称",
  "target_count": 3,
  "position_scope": "完整的职位描述/JD文本",
  "cities": ["上海", "深圳"],
  "seniority": "5-10年",
  "must_have_signals": ["关键词1", "关键词2"],
  "preferred_signals": ["加分项1"],
  "hard_rejects": ["排除项1"]
}

> ⚠️ City and seniority must be explicitly provided. Do not let JD-worker guess them.

Step 2: Submit the job

cd skills/liepin-agentic-sourcing
python3 scripts/jd_search_and_communicate.py --criteria-file path/to/criteria.json

Dry-run (validate criteria without launching):

python3 scripts/jd_search_and_communicate.py --criteria-file path/to/criteria.json --dry-run

Output: Started Liepin runtime job:

Architecture

┌─────────────┐
│   Launcher   │── starts 4 workers as subprocesses
└──────┬──────┘
       │
  ┌────┴──────────────────────────────────────────┐
  │                                               │
  ▼                                               ▼
┌──────────┐  search plan  ┌──────────────┐
│ JD-Worker │──────────────▶│ Browser-Worker│
│ (LLM)     │              │ (Playwright) │
└──────────┘              └──────┬───────┘
                                 │ candidate data
                                 ▼
                          ┌──────────────┐  decisions  ┌──────────────┐
                          │ Resume-Worker │───────────▶│ Orchestrator │
                          │ (LLM)         │             │              │
                          └──────────────┘              └──────┬───────┘
                                                                │ replan signal
                                                                ▼
                                                         ┌──────────┐
                                                         │ JD-Worker│
                                                         │ (widen/   │
                                                         │  tighten) │
                                                         └──────────┘

Worker responsibilities

Candidate lifecycle

pending_preview_eval → completed(skip) / completed(open_detail)
                                      ↓
pending_detail_harvest → detail_harvested → completed(skip) / pending_communication
                                                                   ↓
                                                           completed(link)

Adaptive search

• result_count > 200: immediately tighten — abandons pending work, requests narrower plan
• result_count ≤ 200: drains current pool first, then widen if target not reached
• Max 5 search plan iterations per job

Browser session model

• Preview collection: standalone session, up to 5 pages (100 candidates)
• Detail + Communication: shared session per page
• Navigate to target page once
• Click card → harvest detail → if link: click "立即沟通" in same modal → close → next
• No repeated login or page navigation within a page

Known Page Quirks

AI 帮搜 Wizard Overlay

What it is: Liepin displays a full-screen wizard modal (step 1/3) called "AI 帮搜" on first load of the search page. It renders as

overlay = page.locator('[class*="overlay--"]').first
if await overlay.is_visible(timeout=2000):
    close_btn = overlay.locator('text=✕').first
    await close_btn.click(force=True, timeout=2000)
    await asyncio.sleep(1)

cd skills/liepin-agentic-sourcing
pytest tests/ -q