Skip to main content

Recruiter Navigator

招聘工具导航器 — 纯导航 + 极简启动的统一入口

覆盖 47 个招聘工具,提供命令行和 Web 两种交互方式

Python Version License Status


项目简介

Recruiter Navigator 是一个招聘工具导航器,为 47 个招聘工具提供统一的导航入口和极简启动机制。

核心定位

  • 纯导航:不实现工具的具体功能,只提供导航和启动
  • 统一入口:一个命令访问所有招聘工具
  • 双界面:同时支持命令行(CLI)和 Web 可视化界面
  • 工作流可视化:展示工具间的上下游关系,构建完整招聘流程

覆盖场景

领域 工具数 典型工具
🔍 人才搜索 13 search-talent、linkedin-horse、maimai-cat
📄 简历处理 12 resume-oneclick、talent-lens、profile-claw
✉️ 候选人触达 4 cold-msg、recruiter-msg、replyme
📊 数据管理 8 excel-toolbox、excel-vis、talent-birdview
🔧 基础设施 10 llmdog、browser-dog、sting-agent

快速开始

安装

pip install recruiter-navigator

基本使用

# 查看所有工具
recruiter list

# 按分类筛选
recruiter list --category search

# 关键词搜索
recruiter list --keyword linkedin

# 启动工具
recruiter use search-talent

# 初始化本地配置
recruiter init

# 启动 Web 面板
recruiter web
recruiter web --port 9000 --open

Web 界面

启动 Web 服务后,访问 http://localhost:8080:

  • 主页:/home — 招聘流程信息图
  • 工具列表:/ — 工具卡片画廊

命令详解

recruiter list — 列出工具

recruiter list                              # 全部列出
recruiter list --category search            # 按分类筛选
recruiter list --keyword resume             # 关键词搜索
recruiter list --config ./my-registry.yaml  # 自定义配置

recruiter use — 启动工具

recruiter use search-talent                 # 启动工具
recruiter use search-talent -- --location "Beijing"  # 传递参数

recruiter web — 启动 Web 面板

recruiter web                               # 默认端口 8080
recruiter web --port 9000 --open            # 指定端口 + 自动打开浏览器
recruiter web --config ./my-registry.yaml   # 自定义配置

recruiter init — 初始化配置

recruiter init                              # 复制到当前目录
recruiter init --output ~/my-tools          # 指定输出目录
recruiter init --force                      # 覆盖已存在文件

Web API

路径 说明
/home 招聘流程信息图
/ 工具画廊
/api/tools 工具列表 JSON
/api/tool/{name} 工具详情 JSON
/api/launch-guide/{name} 启动指引 JSON
/api/workflow-graph 工作流拓扑 JSON

自定义配置

recruiter init                    # 生成 registry.yaml
vim registry.yaml                 # 编辑添加工具
recruiter list --config ./registry.yaml
recruiter web --config ./registry.yaml

配置文件结构:

tools:
  - name: my-tool
    display_name: "My Tool"
    description: "工具描述"
    category: search
    pypi_url: "https://pypi.org/project/my-tool/"
    launch:
      mode: cli
      command: "my-tool"
    docs:
      readme: "# My Tool\n> 描述"
      use_cases:
        - "使用场景1"
      workflow:
        prev_tools: []
        next_tools: [resume-oneclick]
      quick_start:
        install: "pip install my-tool"
        command_example: "my-tool --help"
        expected_output: "显示帮助"
      tags:
        - "#自定义"

技术架构

┌─────────────────────────────────────┐
│         CLI 层 (cli/)               │  ← 用户交互
│  init / list / use / web            │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│       核心层 (core/)                 │  ← 业务逻辑
│  models / registry / launcher        │
└─────────────────┬───────────────────┘
                  │
┌─────────────────▼───────────────────┐
│       数据层 (data/)                 │  ← 静态配置
│       registry.yaml                  │
└─────────────────────────────────────┘

技术栈

  • CLI:typer[all] + rich
  • 数据:pydantic + pyyaml
  • Web:fastapi + uvicorn + jinja2
  • 前端:alpine.js + tailwindcss

项目结构

recruiter_navigator/
├── __init__.py
├── cli/
│   ├── app.py          # Typer 主入口
│   ├── init.py         # recruiter init
│   ├── list.py         # recruiter list
│   ├── use.py          # recruiter use
│   └── web.py          # recruiter web
├── core/
│   ├── models.py       # Pydantic 数据模型
│   ├── registry.py     # YAML 注册表加载器
│   └── launcher.py     # 工具启动逻辑
├── data/
│   └── registry.yaml   # 47 个工具元数据
└── web/
    ├── app.py          # FastAPI 应用工厂
    ├── routes/
    │   ├── detail.py   # /api/tool/{name}
    │   ├── home.py     # /home 信息图
    │   └── index.py    # / 工具画廊
    ├── templates/
    │   ├── base.html
    │   ├── home.html
    │   └── index.html
    └── static/css/
        ├── base.css
        ├── common.css
        └── home.css

License

MIT

Metadata

Release files for recruiter-navigator 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for recruiter-navigator 0.1.0
File Size Uploaded Provenance Actions
recruiter_navigator-0.1.0.tar.gz 103.4 kB Without provenance Details for recruiter_navigator-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for recruiter-navigator 0.1.0
File Interpreter ABI Platform Actions
recruiter_navigator-0.1.0-py3-none-any.whl Python 3 none any Details for recruiter_navigator-0.1.0-py3-none-any.whl

Total release size: 178.0 kB

Release files / recruiter_navigator-0.1.0.tar.gz

Download URL recruiter_navigator-0.1.0.tar.gz
Size 103.4 kB
Tags Source
SHA-256 checksum
How to use checksums
27a4d3ac988bc73dd5105b1848a68b96cfba5ec87b8a3344f002d86bd871b23b
BLAKE2b-256 checksum
How to use checksums
9c7c97d56926de21d3e334bb9f5815993491851e84066c008bfd28a573526713
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Release files / recruiter_navigator-0.1.0-py3-none-any.whl

Download URL recruiter_navigator-0.1.0-py3-none-any.whl
Size 74.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7fe647eeb3f09ffc7933b3165440860de71bc47738b0e9b29376fdff96434eef
BLAKE2b-256 checksum
How to use checksums
622d05f980ccce015a81a76ab43a53246d47f847fd705eee87829d34f6f325a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Security for recruiter-navigator 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page