offercatcher

Category: Development & Coding | Uploader: NissonCX | Downloads: 0 | Version: v1.0（Latest）

Turn recruiting emails into native reminders. Use when user mentions "interview", "coding test", "assessment", "recruiting email", "sync to reminders", or "don't miss my interview". AI-powered parsing works for all languages and email formats.

Changelog: Source: GitHub https://github.com/NissonCX/offercatcher

Directory Structure

Current level: tree/main/

📁 agents/
- 📄 openai.yaml 302 B
📁 assets/
- 📄 banner.svg 5.2 KB
- 📄 showcase-detail.jpg 267.3 KB
- 📄 showcase-list.jpg 128.9 KB
📁 scripts/
- 📄 apple_reminders_bridge.py 12.0 KB
- 📄 list_mail_sources.py 1.4 KB
- 📄 manual_event.py 5.8 KB
- 📄 recruiting_sync.py 24.5 KB
📁 tests/
- 📄 test_manual_event.py 2.5 KB
- 📄 test_recruiting_sync.py 3.4 KB
📄 .gitignore 120 B
📄 CLAUDE.md 2.5 KB
📄 config.example.yaml 362 B
📄 install.sh 1.7 KB
📄 LICENSE 1.0 KB
📄 README.md 7.1 KB
📄 README_CN.md 6.9 KB
📄 SKILL.md 2.3 KB

SKILL.md

---
name: offercatcher
description: Turn recruiting emails into native reminders. Use when user mentions "interview", "coding test", "assessment", "recruiting email", "sync to reminders", or "don't miss my interview". AI-powered parsing works for all languages and email formats.
---

# OfferCatcher

## What It Does

Scans your Apple Mail for recruiting emails, extracts important events (interviews, assessments, deadlines) using LLM, and creates native Apple Reminders that sync to your iPhone.

## How To Use

### Trigger Phrases

- "Check my recruiting emails"
- "Any interviews coming up?"
- "Sync interview emails to reminders"
- "Don't let me miss my coding test"

### Workflow

```
1. Scan: --scan-only → returns JSON with raw emails
2. Parse: OpenClaw LLM extracts events from emails
3. Apply: --apply-events → creates Apple Reminders
```

### Step 1: Scan Emails

```bash
python3 scripts/recruiting_sync.py --scan-only
```

Returns raw email data for LLM to parse.

### Step 2: LLM Parses

For each email, extract:
- `company`: Company name
- `event_type`: interview / ai_interview / written_exam / assessment / authorization / deadline
- `timing`: `{"start": "YYYY-MM-DD HH:MM", "end": "..."}` or `{"deadline": "..."}`
- `role`: Job title
- `link`: Event URL

### Step 3: Apply Events

```bash
python3 scripts/recruiting_sync.py --apply-events /tmp/events.json
```

## LLM Parsing Prompt

```
Extract recruiting event information from this email. Return JSON.

Email:
{body}

Extract:
- company: Company name
- event_type: interview / ai_interview / written_exam / assessment / authorization / deadline
- timing: {"start": "YYYY-MM-DD HH:MM", "end": "..."} or {"deadline": "..."}
- role: Job title
- link: Event URL
- notes: Additional info
```

## Output Rules

- Reminder title: Company + Event type (e.g., "Google Interview", "Meta Coding Test")
- Include: Time, role, link in notes
- If no new events: respond `HEARTBEAT_OK`

## Configuration

`~/.openclaw/offercatcher.yaml`:

```yaml
mail_account: "Gmail"    # Apple Mail account name
mailbox: INBOX           # Folder to scan
days: 2                  # Scan last N days
max_results: 60          # Max emails
```

## Supported Languages

The LLM parser works with any language—Chinese, English, Japanese, German, etc. No regex, no language-specific rules.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

offercatcher

Directory Structure

SKILL.md

Report

Notice