# Freehire Job Search

Searches live tech job listings across many countries through the freehire.me API.

- Repository: https://github.com/ai-job-search-dev/ai-job-search (68713 stars)
- Category: Business
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add ai-job-search-dev/ai-job-search --skill freehire-search -g -a claude-code -y`
Codex: `npx skills add ai-job-search-dev/ai-job-search --skill freehire-search -g -a codex -y`
Cursor: `npx skills add ai-job-search-dev/ai-job-search --skill freehire-search -g -a cursor -y`
Gemini CLI: `npx skills add ai-job-search-dev/ai-job-search --skill freehire-search -g -a gemini-cli -y`

## Description

Use this skill to search live software / tech / data / engineering job listings across many countries and markets (and remote) via the freehire.me aggregator's public API, or to look up a specific posting. It aggregates roles from ~50 ATS platforms into one schema, so a single skill covers many markets, but its faceted filtering (skills, category, seniority) is tuned tech-first, so scope triggers to technical roles. Trigger phrases: find a tech job, software job search, developer jobs, engineering vacancies, data/ML jobs, DevOps roles, remote developer jobs, "are there any <tech role> jobs in <place>", look up this freehire job posting.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# freehire Search Skill

Search live job listings from the **[freehire.me](https://freehire.me)** job
aggregator, an open-source IT job board that normalizes postings from ~50 ATS
platforms across many countries into one schema. No authentication, no API key,
and **zero runtime dependencies**, it runs with just `bun`. The market is chosen
per query via facet flags (`--region`, `--country`), so the same skill works for a
forker in any market out of the box.

> This is a country-agnostic worked example of the repo's job-portal-skill pattern,
> like `linkedin-search`. Unlike the HTML-scraping portals, it queries freehire's
> public JSON API, so results are structured (skills, seniority, region facets)
> rather than parsed from markup.

## ⚠️ Scope: tech-focused

freehire's corpus already includes some non-tech postings (it crawls whole company
career pages), **but its faceted filtering, skills, categories, and seniority
dictionaries, is tuned tech-first today**, so this skill scopes its triggers to
software / data / engineering / tech roles, where the filtering is strong. Non-tech
coverage exists but is still maturing; don't rely on this skill for general
(non-technical) job coverage yet.

## ℹ️ Hosted-service dependency (best-effort, no SLA)

This skill depends on a third-party hosted service, freehire.me. Reads are
**public and unauthenticated**, the same zero-signup bar as `linkedin-search`.

**freehire.me is a personal project but actively maintained; it runs on a
best-effort basis (no formal SLA).** If the API is unreachable, the CLI fails
gracefully, a non-zero exit with a clear error message, so an outage degrades
this source rather than breaking the surrounding workflow.

The rest: https://github.com/ai-job-search-dev/ai-job-search/blob/HEAD/.agents/skills/freehire-search/SKILL.md