← Back to Skills Marketplace
lanxevo3

Freelance Job Scraper

by lanxevo3 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
141
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install freelance-job-scraper
Description
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,...
README (SKILL.md)

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

# 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

## 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
Usage Guidance
This skill is partially implemented and overpromises: it claims to monitor HN, YC, and remote job boards but the included script only queries Hacker News via the gh CLI. Before installing or running it: 1) Inspect the script locally (you already have it) — it only uses the gh CLI and prints results. 2) Be aware gh runs using your GitHub auth (ensure the token has minimal scopes you are comfortable with). 3) The script has bugs: it assumes reply_count is 0 (so it always awards 'low competition' points), and when you pass --output it actually writes an empty file because it never captures the printed report into a string. 4) If you expect YC or remote board scraping, do not rely on this package — those features are not implemented. 5) Run it in a disposable environment or inspect/patch the script to fix/report-capture and to implement or remove advertised sources before trusting production use.
Capability Analysis
Type: OpenClaw Skill Name: freelance-job-scraper Version: 1.0.0 The freelance-job-scraper skill is a legitimate tool designed to identify job opportunities by searching for Hacker News 'Who is Hiring' threads via the GitHub CLI. The Python script (scripts/scan_jobs.py) implements basic keyword-based scoring and uses safe subprocess execution with argument lists. Although there is a discrepancy between the documentation and the actual implementation (the script only searches HN and lacks the mentioned remote board scraping), and it contains a minor bug in its output-capturing logic, there are no indicators of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
The README/description promises scraping HN, YC jobs, and remote aggregators, but the included code (scripts/scan_jobs.py) only implements a simple HN 'Who is Hiring' search via the gh CLI. It also references files (references/hn_jobs_guide.md) that are not present. The required tooling (gh CLI) matches the code, but several claimed capabilities are not implemented.
Instruction Scope
SKILL.md asks for gh CLI auth, Python 3.6+, and 'browser or web fetch' for external boards. The Python file only calls gh to query GitHub search and prints results; it does not attempt to read other system files or environment variables. However the instructions and Quick Start imply broader scraping (YC, remoteok, weworkremotely) that the code does not perform.
Install Mechanism
No install spec and only a small Python script are provided. Nothing is downloaded or written by an installer. This low-install footprint is consistent with an instruction-only skill.
Credentials
No environment variables or credentials are declared. The script does require an authenticated gh CLI to access GitHub; that is proportional to the HN search use. No unrelated credentials or config paths are requested.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent/always-on privileges or modify other skills. Autonomous model invocation remains enabled by default but is not combined with broad credentials or suspicious behaviors here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install freelance-job-scraper
  3. After installation, invoke the skill by name or use /freelance-job-scraper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- First public release of the freelance-job-scraper. - Scans Hacker News Who is Hiring, YC jobs board, and major remote job aggregators for freelance automation and AI opportunities. - Scores leads based on relevance, payout, competition, and company type. - Generates a prioritized daily digest report of actionable freelance gigs. - Provides command-line options for filtering by keyword and outputting results to a file.
Metadata
Slug freelance-job-scraper
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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,... It is an AI Agent Skill for Claude Code / OpenClaw, with 141 downloads so far.

How do I install Freelance Job Scraper?

Run "/install freelance-job-scraper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Freelance Job Scraper free?

Yes, Freelance Job Scraper is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Freelance Job Scraper support?

Freelance Job Scraper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Freelance Job Scraper?

It is built and maintained by lanxevo3 (@lanxevo3); the current version is v1.0.0.

💬 Comments