Remote Job Hunter

Remote Job Hunter

Automated remote job search tool. Searches multiple sources, matches against user's profile, verifies job links are still open, and delivers reports via email or console.

When to Use

Invoke this skill when the user:

• Asks to search for remote jobs or job opportunities
• Wants to find job matches based on their resume/skills
• Requests a daily job hunting setup or job alerts
• Says keywords like "job hunt", "find remote jobs", "search jobs", "job alert", "remote work"

Quick Commands

The skill provides these entry points for the agent to call directly:

1. Instant Job Search (run now, output to console)

python3 run_now.py --dry-run

This runs the full pipeline (search -> match -> verify) and prints results to console without sending email. Use this when the user wants to see jobs immediately.

2. Full Pipeline with Email Report

python3 daily_scheduler.py

Runs the complete pipeline and sends email report if matches are found. Use for scheduled daily runs.

3. Setup / Reconfigure

python3 setup.py

Interactive setup. Use when config.json is missing or user wants to change settings.

4. Quick Setup from Template (non-interactive)

python3 setup.py --quick --name "User Name" --title "Job Title" --email "user@example.com"

Generates config.json without interactive prompts. Use when user provides info inline.

Agent Usage Guide

If user says "帮我搜一下远程工作" or "find me remote jobs":

1. Check if config.json exists. If not, ask user for: name, job title, email.
2. Run: python3 run_now.py --dry-run
3. Show the user the top matches from the output.

If user says "set up daily job alerts" or "每天帮我找":

1. Ensure config.json exists (run setup.py if needed).
2. Run: python3 daily_scheduler.py once to test.
3. Help user set up cron or TRAE automation to run daily.

If user wants to change keywords, skills, or filters:

• Edit config.json directly — it's plain JSON. No need to re-run setup.
• Key fields to modify:
  • search.keywords — what jobs to search for
  • profile.skills — your skills for matching
  • search.location_filter — region preferences
  • email.* — where to send reports

Configuration

config.json controls all behavior. Key sections:

Location Filter Modes

• "all" — no filtering, show all remote jobs
• "exclude_only" — only remove jobs matching exclusion keywords
• "include_global" — prioritize preferred regions + exclude unwanted

File Structure

remote-job-hunter/
├── SKILL.md              # Agent instructions (this file)
├── run_now.py            # Instant search entry point (agent-friendly)
├── daily_scheduler.py    # Full pipeline with email
├── setup.py              # Interactive or quick setup
├── config.json           # User configuration (generated)
├── config.template.json  # Config template
├── scripts/
│   ├── search_jobs.py    # Multi-source search
│   ├── match_jobs.py     # Resume-to-job scoring
│   ├── verify_jobs.py    # Link verification
│   └── send_email.py     # Email reports
└── README.md             # Human documentation

Troubleshooting

No config.json found: Run python3 setup.py or python3 setup.py --quick with required flags.

No jobs found: Check config.json -> search.keywords. Try setting location_filter.mode to "all".

Email not received: Check spam folder; verify SMTP credentials in config.json.

SMTP / Gmail App Password: Generate at https://myaccount.google.com/apppasswords

---

License: MIT-0