# Freelance Job Scraper

> Autonomous freelance job monitoring agent. Scans Hacker News Who is Hiring, YC jobs board, and remote job aggregators for high-value automation and AI gigs, scores them by relevance and payout, and flags actionable leads.

- Skill: `lord1egypt/freelance-job-scraper` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/freelance-job-scraper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/freelance-job-scraper/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/freelance-job-scraper

---


# Freelance Job Scraper

Scans multiple job boards and freelance platforms for AI/automation-related gigs. Scores each opportunity by relevance, payout, and competition level.

## What It Does

- Scrapes HN "Who is Hiring" monthly threads
- Monitors YC jobs board for automation/AI-related postings
- Checks remoteok.com, weworkremotely.com for relevant gigs
- Scores opportunities by payout, competition, and AI fit
- Generates a prioritized daily digest report

## Prerequisites

- `gh` CLI authenticated (for HN comments/jobs access)
- Python 3.6+ (standard library only)
- Browser or web fetch for job board scraping

## Quick Start

```bash
# Scan all sources and generate report
python3 scripts/scan_jobs.py

# Filter by keyword
python3 scripts/scan_jobs.py --keyword "automation"

# Output to file
python3 scripts/scan_jobs.py --output freelance_leads.md
```

## Scoring Criteria

| Score | Factor |
|-------|--------|
| High payout ($100+) | +3 pts |
| AI/automation relevant | +3 pts |
| Remote OK | +1 pt |
| Few competition (fewer replies) | +2 pts |
| YC company | +2 pts |

## Output Format

```markdown
## Freelance Lead Digest — 2026-03-27

### 🔥 Hot Leads (score >= 7)
1. **[Company] — Role/Task** | $AMOUNT | YC | 3 replies
   - Link: https://...
   - Why: AI/automation fit

### 🎯 Medium Leads (score 4-6)
...

### 💤 Low Priority
...
```

## Architecture

- `scripts/scan_jobs.py` — Main scraper (Python stdlib only)
- `references/hn_jobs_guide.md` — How to navigate HN jobs
- Uses `gh api` for HN content, web fetch for external boards