job104-cli 0.1.1__tar.gz

job104_cli-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: CI / Publish
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync --dev
+      - run: uv run pytest -m "not smoke" -v --tb=long
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv python install 3.13
+      - run: uv sync --dev
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [test, lint]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv python install 3.13
+      - run: uv build
+      - run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}

job104_cli-0.1.1/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+*.so
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/

job104_cli-0.1.1/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: job104-cli
+Version: 0.1.1
+Summary: A CLI for Taiwan 104 Job Bank (104人力銀行) — search jobs from the terminal
+Project-URL: Homepage, https://github.com/weirenlan/job104-cli
+Project-URL: Repository, https://github.com/weirenlan/job104-cli
+Author: weirenlan
+License-Expression: Apache-2.0
+Keywords: 104,cli,job,recruitment,taiwan,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.12
+Requires-Dist: browser-cookie3>=0.19
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# job104 CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/job104-cli)](https://pypi.org/project/job104-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/job104-cli)](https://pypi.org/project/job104-cli/)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
+> **Taiwan 104 Job Bank CLI** — Search jobs, view details, and manage your career from the terminal. Built for developers and AI agents.
+
+台灣 104 人力銀行終端機工具。讓開發者和 AI agent 可以在終端機中搜尋 104 職缺。
+
+## Install
+
+```sh
+# Recommended (isolated environment)
+uv tool install job104-cli
+
+# Alternatives
+pipx install job104-cli
+pip install job104-cli
+```
+
+## Quick Start
+
+```sh
+# Search jobs
+job104 search "Python" --area 台北市
+
+# Filter by company type and job category
+job104 search "AI" --company-type 外商 --jobcat AI工程師 --area 台北市
+
+# View job detail by index
+job104 show 3
+
+# View job detail by URL hash
+job104 detail 8z5sl
+
+# Export results
+job104 export "Python" -n 50 -o jobs.csv
+
+# Search companies
+job104 company "Google" --zone 外商 --area 台北市
+
+# Filter by industry
+job104 search "護理師" --indcat 醫療服務業
+
+# Use raw category code for specific job titles
+job104 search "Python" --jobcat 2007001020
+
+# List supported areas, job categories, and industries
+job104 areas
+job104 categories
+job104 industries
+
+# Login via browser cookies
+job104 login
+
+# View personal center (requires login)
+job104 me
+job104 applied
+job104 saved
+job104 interviews
+job104 resume
+job104 resume-show        # first resume
+job104 resume-show 2      # second resume by index
+job104 viewers
+job104 follows
+job104 history
+job104 recommend
+
+# Edit resume (requires login) [Beta]
+job104 resume-edit bio --update --data '{"chi": "我的自傳..."}'
+job104 resume-edit experience --add --data '{"companyName": "Google", "jobName": "SWE"}'
+job104 resume-fields --json          # list all field definitions
+job104 resume-fill --from resume.json --dry-run
+```
+
+## Personal Center (需登入)
+
+透過瀏覽器 Cookie 登入後，可查看個人中心資料：
+
+```sh
+# Login
+job104 login
+job104 login --cookie-source chrome
+
+# View profile
+job104 me
+
+# View applied jobs (with pagination and status filter)
+job104 applied
+job104 applied -p 2
+job104 applied --status closed
+
+# View saved/bookmarked jobs
+job104 saved
+job104 saved --not-applied
+
+# View interview invitations
+job104 interviews
+
+# View resume list
+job104 resume
+
+# View full resume content (by index # or VNO)
+job104 resume-show          # default: first resume
+job104 resume-show 2        # second resume by index
+job104 resume-show <VNO>    # by VNO
+
+# View who viewed your resume
+job104 viewers
+
+# View followed companies
+job104 follows
+
+# View browsing history
+job104 history
+job104 history -p 2
+
+# View recommended jobs
+job104 recommend
+job104 recommend --group highchance
+
+# Structured output
+job104 applied --json
+job104 resume --yaml
+job104 resume-show --json
+job104 resume-show --md            # full Markdown (no truncation)
+job104 resume-show --md > resume.md  # save to file
+
+# Check login status / logout
+job104 status
+job104 logout
+```
+
+## Resume Editing (需登入) `Beta 開發中`
+
+編輯 104 履歷，支援互動模式與 agent 自動填入：
+
+```sh
+# Edit a single section (agent mode with --data JSON)
+job104 resume-edit bio --update --data '{"chi": "我的自傳內容..."}'
+job104 resume-edit experience --add --data '{"companyName": "Google", "jobName": "SWE"}'
+job104 resume-edit education --delete --index 2
+job104 resume-edit experience --update --index 1 --data '{"description": "新的描述"}'
+
+# Interactive mode (prompts for each field)
+job104 resume-edit bio --update
+
+# Preview without submitting
+job104 resume-edit bio --update --data '{"chi": "test"}' --dry-run
+
+# Auto-fill from external sources
+job104 resume-fill --from resume.json --dry-run
+job104 resume-fill --from resume.pdf --sections experience,education
+echo '{"bio": {"chi": "..."}}' | job104 resume-fill --stdin --yes
+
+# Merge strategy (default: replace)
+job104 resume-fill --from data.json --strategy merge --yes
+
+# View field definitions (for agents)
+job104 resume-fields --json
+job104 resume-fields --section experience --json
+
+# Autocomplete lookup
+job104 resume-autocomplete school 台灣大學
+job104 resume-autocomplete company Google --json
+job104 resume-autocomplete skill Python --json
+
+# Specify which resume to edit (default: first)
+job104 resume-edit bio --update --vno <VNO> --data '{"chi": "..."}'
+```
+
+## Filters
+
+```sh
+job104 search "Python" \
+  --area 台北市 \
+  --company-type 外商 \
+  --jobcat 軟體工程師 \
+  --indcat 軟體及網路相關業 \
+  --exp 3-5年 \
+  --edu 大學 \
+  --salary-type 月薪 --salary-low 50000 \
+  --remote 完全遠端 \
+  --isnew 7天內
+```
+
+## Structured Output
+
+All commands support `--json` and `--yaml` flags for agent-friendly output. `resume-show` also supports `--md` for full Markdown output. Resume edit commands support `--dry-run` to preview changes before submitting.
+
+```sh
+job104 search "Python" --json
+job104 company "AI" --zone 外商 --json
+job104 applied --json
+job104 resume --yaml
+job104 resume-show --md
+job104 resume-fields --json
+job104 resume-edit bio --update --dry-run --data '{"chi": "test"}'
+```
+
+## License
+
+Apache-2.0

job104_cli-0.1.1/README.md

@@ -0,0 +1,204 @@
+# job104 CLI
+
+[![PyPI version](https://img.shields.io/pypi/v/job104-cli)](https://pypi.org/project/job104-cli/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/job104-cli)](https://pypi.org/project/job104-cli/)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+
+> **Taiwan 104 Job Bank CLI** — Search jobs, view details, and manage your career from the terminal. Built for developers and AI agents.
+
+台灣 104 人力銀行終端機工具。讓開發者和 AI agent 可以在終端機中搜尋 104 職缺。
+
+## Install
+
+```sh
+# Recommended (isolated environment)
+uv tool install job104-cli
+
+# Alternatives
+pipx install job104-cli
+pip install job104-cli
+```
+
+## Quick Start
+
+```sh
+# Search jobs
+job104 search "Python" --area 台北市
+
+# Filter by company type and job category
+job104 search "AI" --company-type 外商 --jobcat AI工程師 --area 台北市
+
+# View job detail by index
+job104 show 3
+
+# View job detail by URL hash
+job104 detail 8z5sl
+
+# Export results
+job104 export "Python" -n 50 -o jobs.csv
+
+# Search companies
+job104 company "Google" --zone 外商 --area 台北市
+
+# Filter by industry
+job104 search "護理師" --indcat 醫療服務業
+
+# Use raw category code for specific job titles
+job104 search "Python" --jobcat 2007001020
+
+# List supported areas, job categories, and industries
+job104 areas
+job104 categories
+job104 industries
+
+# Login via browser cookies
+job104 login
+
+# View personal center (requires login)
+job104 me
+job104 applied
+job104 saved
+job104 interviews
+job104 resume
+job104 resume-show        # first resume
+job104 resume-show 2      # second resume by index
+job104 viewers
+job104 follows
+job104 history
+job104 recommend
+
+# Edit resume (requires login) [Beta]
+job104 resume-edit bio --update --data '{"chi": "我的自傳..."}'
+job104 resume-edit experience --add --data '{"companyName": "Google", "jobName": "SWE"}'
+job104 resume-fields --json          # list all field definitions
+job104 resume-fill --from resume.json --dry-run
+```
+
+## Personal Center (需登入)
+
+透過瀏覽器 Cookie 登入後，可查看個人中心資料：
+
+```sh
+# Login
+job104 login
+job104 login --cookie-source chrome
+
+# View profile
+job104 me
+
+# View applied jobs (with pagination and status filter)
+job104 applied
+job104 applied -p 2
+job104 applied --status closed
+
+# View saved/bookmarked jobs
+job104 saved
+job104 saved --not-applied
+
+# View interview invitations
+job104 interviews
+
+# View resume list
+job104 resume
+
+# View full resume content (by index # or VNO)
+job104 resume-show          # default: first resume
+job104 resume-show 2        # second resume by index
+job104 resume-show <VNO>    # by VNO
+
+# View who viewed your resume
+job104 viewers
+
+# View followed companies
+job104 follows
+
+# View browsing history
+job104 history
+job104 history -p 2
+
+# View recommended jobs
+job104 recommend
+job104 recommend --group highchance
+
+# Structured output
+job104 applied --json
+job104 resume --yaml
+job104 resume-show --json
+job104 resume-show --md            # full Markdown (no truncation)
+job104 resume-show --md > resume.md  # save to file
+
+# Check login status / logout
+job104 status
+job104 logout
+```
+
+## Resume Editing (需登入) `Beta 開發中`
+
+編輯 104 履歷，支援互動模式與 agent 自動填入：
+
+```sh
+# Edit a single section (agent mode with --data JSON)
+job104 resume-edit bio --update --data '{"chi": "我的自傳內容..."}'
+job104 resume-edit experience --add --data '{"companyName": "Google", "jobName": "SWE"}'
+job104 resume-edit education --delete --index 2
+job104 resume-edit experience --update --index 1 --data '{"description": "新的描述"}'
+
+# Interactive mode (prompts for each field)
+job104 resume-edit bio --update
+
+# Preview without submitting
+job104 resume-edit bio --update --data '{"chi": "test"}' --dry-run
+
+# Auto-fill from external sources
+job104 resume-fill --from resume.json --dry-run
+job104 resume-fill --from resume.pdf --sections experience,education
+echo '{"bio": {"chi": "..."}}' | job104 resume-fill --stdin --yes
+
+# Merge strategy (default: replace)
+job104 resume-fill --from data.json --strategy merge --yes
+
+# View field definitions (for agents)
+job104 resume-fields --json
+job104 resume-fields --section experience --json
+
+# Autocomplete lookup
+job104 resume-autocomplete school 台灣大學
+job104 resume-autocomplete company Google --json
+job104 resume-autocomplete skill Python --json
+
+# Specify which resume to edit (default: first)
+job104 resume-edit bio --update --vno <VNO> --data '{"chi": "..."}'
+```
+
+## Filters
+
+```sh
+job104 search "Python" \
+  --area 台北市 \
+  --company-type 外商 \
+  --jobcat 軟體工程師 \
+  --indcat 軟體及網路相關業 \
+  --exp 3-5年 \
+  --edu 大學 \
+  --salary-type 月薪 --salary-low 50000 \
+  --remote 完全遠端 \
+  --isnew 7天內
+```
+
+## Structured Output
+
+All commands support `--json` and `--yaml` flags for agent-friendly output. `resume-show` also supports `--md` for full Markdown output. Resume edit commands support `--dry-run` to preview changes before submitting.
+
+```sh
+job104 search "Python" --json
+job104 company "AI" --zone 外商 --json
+job104 applied --json
+job104 resume --yaml
+job104 resume-show --md
+job104 resume-fields --json
+job104 resume-edit bio --update --dry-run --data '{"chi": "test"}'
+```
+
+## License
+
+Apache-2.0

job104_cli-0.1.1/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: job104-cli
+description: Use job104 for ALL 104 人力銀行 operations — searching jobs, viewing details, managing applications, browsing resumes, and exporting results. Invoke whenever the user requests any job search or recruitment interaction on Taiwan's 104 Job Bank.
+author: weirenlan
+version: "0.1.0"
+tags:
+  - 104
+  - job-search
+  - taiwan
+  - recruitment
+  - cli
+  - ai-agent
+---
+
+# job104 — Taiwan 104 Job Bank CLI
+
+**Binary:** `job104`
+**Credentials:** browser cookies (auto-extracted from Chrome, Firefox, Edge, Brave, Arc, Safari, etc.)
+
+## Setup
+
+```bash
+# Install (requires Python 3.10+)
+uv tool install job104-cli
+# Or: pipx install job104-cli
+# Or: pip install job104-cli
+
+# Upgrade to latest
+uv tool install --upgrade job104-cli
+```
+
+## Authentication
+
+**IMPORTANT FOR AGENTS**: Many commands work without login (search, detail, export, company). Only personal center commands (me, applied, saved, resume, etc.) require authentication.
+
+### Step 0: Check if already authenticated
+
+```bash
+job104 status --json 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print('AUTH_OK' if d.get('ok') else 'AUTH_NEEDED')"
+```
+
+If `AUTH_OK`, skip to [Command Reference](#command-reference).
+If `AUTH_NEEDED` and personal center commands are needed, proceed to Step 1.
+
+### Step 1: Guide user to authenticate
+
+Ensure user is logged into 104.com.tw in any supported browser. Then:
+
+```bash
+job104 login                              # auto-detect browser with valid cookies
+job104 login --cookie-source chrome       # specify browser explicitly
+```
+
+Verify with:
+
+```bash
+job104 status
+job104 me --json
+```
+
+### Step 2: Handle common auth issues
+
+| Symptom | Agent action |
+|---------|-------------|
+| `未登入` or `not authenticated` | Run `job104 login` |
+| Cookie expired | Run `job104 logout && job104 login` |
+| Wrong browser | Run `job104 login --cookie-source <browser>` |
+
+## Agent Defaults
+
+All machine-readable output uses a consistent envelope:
+
+```json
+{"ok": true, "data": {...}}
+```
+
+- `--json` / `--yaml` / `--md` for explicit format
+- Rich table output goes to **stderr** (safe for pipes: `job104 search X --json | jq .data`)
+- Non-zero exit codes on failure
+
+## Command Reference
+
+### Search & Browse (No Login Required)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `job104 search <keyword>` | Search jobs with filters | `job104 search "Python" --area 台北市` |
+| `job104 show <index>` | View job #N from last search | `job104 show 3` |
+| `job104 detail <hash>` | View full job details by URL hash | `job104 detail 8z5sl --json` |
+| `job104 export <keyword>` | Export search results to CSV/JSON | `job104 export "Python" -n 50 -o jobs.csv` |
+| `job104 company <keyword>` | Search companies | `job104 company "Google" --zone 外商 --area 台北市` |
+| `job104 areas` | List supported areas | `job104 areas` |
+| `job104 categories` | List job categories | `job104 categories` |
+| `job104 industries` | List industry categories | `job104 industries` |
+
+### Personal Center (Login Required)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `job104 me` | View profile | `job104 me --json` |
+| `job104 applied` | View applied jobs | `job104 applied -p 1 --json` |
+| `job104 saved` | View saved/bookmarked jobs | `job104 saved --not-applied --json` |
+| `job104 interviews` | View interview invitations | `job104 interviews --json` |
+| `job104 resume` | List all resumes | `job104 resume --json` |
+| `job104 resume-show` | View full resume content | `job104 resume-show --json` |
+| `job104 resume-show <N>` | View Nth resume by index | `job104 resume-show 2 --md` |
+| `job104 viewers` | View who viewed your resume | `job104 viewers --json` |
+| `job104 follows` | View followed companies | `job104 follows --json` |
+| `job104 history` | View browsing history | `job104 history -p 2 --json` |
+| `job104 recommend` | View recommended jobs | `job104 recommend --json` |
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `job104 login` | Extract cookies from browser (auto-detect) |
+| `job104 login --cookie-source <browser>` | Extract from specific browser |
+| `job104 status` | Check authentication status |
+| `job104 logout` | Clear saved credentials |
+
+## Search Filter Options
+
+| Filter | Flag | Values |
+|--------|------|--------|
+| Area | `--area` | 台北市, 新北市, 桃園市, 台中市, 高雄市, etc. (use `job104 areas` for full list) |
+| Experience | `--exp` | 不限, 1年以下, 1-3年, 3-5年, 5-10年, 10年以上 |
+| Education | `--edu` | 不限, 高中以下, 高中/高職, 專科, 大學, 碩士, 博士 |
+| Salary Type | `--salary-type` | 月薪, 時薪, 日薪 |
+| Min Salary | `--salary-low` | Integer (e.g. 50000) |
+| Max Salary | `--salary-high` | Integer (e.g. 100000) |
+| Freshness | `--isnew` | 3天內, 7天內, 14天內, 30天內 |
+| Remote | `--remote` | 完全遠端, 部分遠端 |
+| Company Type | `--company-type` | 外商, 上市上櫃 |
+| Job Category | `--jobcat` | 軟體工程師, AI工程師, etc. (use `job104 categories`) |
+| Industry | `--indcat` | 半導體業, 軟體及網路相關業, etc. (use `job104 industries`) |
+| Sort Order | `--order` | 符合度, 日期, 刊登日, 經歷需求, 學歷需求, 應徵人數, 待遇 |
+
+## Agent Workflow Examples
+
+### Search → Detail pipeline (structured)
+
+```bash
+# Search and get job list
+job104 search "Python" --area 台北市 --json | jq '.data.jobs[0]'
+# View top result detail
+job104 show 1 --json
+```
+
+### Foreign company AI job search
+
+```bash
+job104 search "AI" --company-type 外商 --area 台北市 --salary-type 月薪 --salary-low 80000 --json
+```
+
+### Export pipeline
+
+```bash
+job104 export "golang" --area 台北市 -n 50 -o golang_jobs.csv
+job104 export "Python" -n 100 --format json -o python_jobs.json
+```
+
+### Daily job check workflow
+
+```bash
+job104 recommend --json                    # Check recommendations
+job104 search "Python" --area 台北市 --json  # Search specific jobs
+job104 applied --json                      # Check application status
+job104 interviews --json                   # Check interview invitations
+job104 saved --json                        # Check saved jobs
+```
+
+### Resume export
+
+```bash
+job104 resume-show --md > my_resume.md     # Export resume as Markdown
+job104 resume-show --json | jq '.data'     # Get structured resume data
+```
+
+### Profile check
+
+```bash
+job104 me --json | jq '.data'
+```
+
+## Limitations
+
+- **No job application** — cannot apply to jobs from CLI (requires browser interaction)
+- **No resume editing** — read-only resume access (editing support planned)
+- **No message sending** — cannot send messages to recruiters
+- **Single account** — one set of cookies at a time
+- **Taiwan only** — 104 Job Bank is a Taiwan-specific platform
+
+## Safety Notes
+
+- Do not ask users to share raw cookie values in chat logs.
+- Prefer local browser cookie extraction over manual secret copy/paste.
+- If auth fails, ask the user to re-login via `job104 login`.
+- Agent should treat cookie values as secrets (do not echo to stdout).

job104_cli-0.1.1/docs/draft/initial.md

@@ -0,0 +1,6 @@
+
+I want to to make 台灣104人力銀行的 104_cli, 目的是讓大家可以用coding agent工具如claude code來更好的查找相關資料(職缺等等)。
+
+而你可以參考 /Users/weirenlan/Desktop/self_project/labs/104_cli/docs/refs/boss-cli 的架構，我們的使用情境需求也會差不多。
+
+但是104的操作會有不同。