freehire-search
Skill6 starsChanged 23 days agoMITView on GitHub
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.
6 other projects use a version of this, 6 of them edited.
Adopted by
Most recently taken up by
- Mateus-Nogueira-GT/ai-job-search-brasiledited, first seen Nov 16, 2026
- MadsLorentzen/ai-job-searchedited, first seen Nov 9, 2026
- ai-job-search-dev/ai-job-searchedited, first seen Oct 25, 2026
- JiemsLBJ/offer-harvesteredited, first seen Sep 5, 2026
- fn-jakubkarp/crocthejobedited, first seen Aug 11, 2026
- arafat1023/job-application-assistantedited, first seen Jul 12, 2026
Used with
Projects with it also use jobbank-search, jobdanmark-search and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
mikkelkrogsholmSkilljobbank-search
Make sure to use this skill whenever the user mentions anything related to job searching on Akademikernes Jobbank, jobbank.dk, or looking for academic or highly educated positions in Denmark — even if they don't mention jobbank.dk explicitly. Also invoke this skill for questions about Danish job listings, graduate trainee positions, Ph.d. jobs, or finding work in specific industries or regions in Denmark. Trigger phrases include: jobbank, akademikernes jobbank, jobs denmark, academic jobs denmark, find job denmark, highly educated jobs, graduate job denmark, trainee position denmark, ph.d. position denmark, postdoc denmark, studiejob, fuldtidsjob, deltidsjob, vikariat, freelance job, praktikplads, job søgning, jobsøgning, søg job, ledige stillinger, nye jobs, it jobs denmark, engineering jobs denmark, marketing jobs denmark, finance jobs denmark, healthcare jobs denmark, remote job denmark, fjernarbejde, job københavn, job aarhus, job odense, nyuddannede job, job til nyuddannede, international job denmark, jobbank søgning, find stilling, data scientist job, software developer job, projektleder stilling, konsulent job, data analyse job.
Also in 3 projects that use this
mikkelkrogsholmSkilljobdanmark-search
Make sure to use this skill whenever the user mentions anything related to Danish job listings, job search in Denmark, finding work in Denmark, or job vacancies on Jobdanmark — even if they don't explicitly mention jobdanmark.dk. Also invoke this skill for questions about specific Danish job categories, municipalities, job types, or salaries in a job-search context. Trigger phrases include: danish jobs, jobs in denmark, find job denmark, job search denmark, danish job listings, jobdanmark, job opslag, find job, jobsøgning, ledige stillinger, stillingsopslag, job i Danmark, fuldtidsjob, deltidsjob, studiejob, praktikplads, elev, fleksjob, IT job denmark, sygeplejersker job, håndværker job, ingeniør job, pædagog job, kontor job, leder job, salg job, hotel job, kirke job, job aarhus, job københavn, job odense, job aalborg, job sjælland, job jylland, job fyn, jobkategorier denmark, ledige job, ansøgningsfrist, søg job, job opslaget, jobopslag, danish vacancies, work in denmark, employment denmark, job denmark, jobs near me denmark, apprentice denmark, internship denmark, part-time denmark, full-time denmark.
Also in 3 projects that use this
- +2 more from mikkelkrogsholm
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 6
- ai-job-search-dev/ai-job-search★ 72k73% same
- MadsLorentzen/ai-job-search★ 72k73% same
- JiemsLBJ/offer-harvester★ 499% same
- Mateus-Nogueira-GT/ai-job-search-brasil★ 275% same
- arafat1023/job-application-assistant★ 092% same
- fn-jakubkarp/crocthejob★ 099% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- profile.example/CLAUDE.mdCLAUDE.md
- tests/CLAUDE.mdCLAUDE.md
- tools/CLAUDE.mdCLAUDE.md
- linkedin-searchSkill
- appSkill
- job-application-assistantSkill
- scrapeSkill
- networkingSkill
- upskillSkill
The file
We split this skill into the rules it gives an agent
6 rules. 3 are common, 0 are distinctive, and 3 are very specific to this project.
3
Common
Most of the 6 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Common: line 20
Search live job listings from the freehire.me job aggregator - an open-source IT job board that normalizes postings from ~50 ATS platforms …
- Common: line 69
Search for tech job openings by keyword, in a given region/country or remotely - each result comes back with its full description, no …
- Common: line 72
Look one freehire posting up by its slug (including a closed one)
- Very specific: line 95
Do not loop detail over search hits to read their descriptions - reach for detail only to look one posting up by slug (e.g.
- Very specific: line 131
Use it for a posting you already have a slug for - a tracked application, a shared link, or a closed posting search no longer lists.
- Very specific: line 165
Search JSON is { "meta": { "count", "page", "total" }, "results": [...] }.
“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
freehire Search Skill
Search live job listings from the 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.
Self-hosting / swappable base URL. The freehire backend is a separate
MIT-licensed repo - strelov1/freehire
(Go + PostgreSQL + Meilisearch) - that stands up with one command via Docker
Compose (make up → API on :8080, same /api/v1/... paths). The skill honors a
base-URL env var, FREEHIRE_API_URL (default https://freehire.me), so pointing
it at a local instance is a one-line change:
FREEHIRE_API_URL=http://localhost:8080 bun run .agents/skills/freehire-search/cli/src/cli.ts search -q "go"Caveat: standing up the API is light, but keeping a full, continuously-fresh mirror (millions of postings across ~50 platforms) is resource-heavy - a self-hoster would either crawl a scoped subset of sources or point the env var back at the hosted API.
When to use this skill
- Search for tech job openings by keyword, in a given region/country or remotely - each result comes back with its full description, no per-hit follow-up needed
- Filter by seniority, category, skills, or recency (posted within N days)
- Look one freehire posting up by its slug (including a closed one)
Commands
Search job listings
bun run .agents/skills/freehire-search/cli/src/cli.ts search [-q "<keywords>"] [facet flags]Key flags:
--query <text>/-q <text>- keyword search (title, skill, role). Full-text; optional.--jobage <days>- posted within N days (maps toposted_within_days).--page <n>- 1-indexed page. Default 1.--limit <n>/-n <n>- results per page (API limit). Default 25.--format json|table|plain- defaultjson.--description-format markdown|text|html- how each result's full description is rendered. Defaultmarkdown, which keeps the posting's headings and requirement lists intact.jsonoutput only.
Search results already carry the full description. This skill queries freehire's
agent search endpoint, which replaces the index's truncated preview with each
posting's complete text, so a search of 20 roles is 1 request rather than 1 + 20.
Do not loop detail over search hits to read their descriptions - reach for
detail only to look one posting up by slug (e.g. from the tracker, or a posting
already closed and therefore absent from search). Full descriptions are verbose:
keep --limit modest, and pre-filter on title/company before reading bodies -
or pass --no-description for a cheap discovery pass that keeps every other
field and drops the bodies entirely (fetch a shortlisted job's body with
detail, or re-run the search without the flag).
Facet filters (values come from freehire's controlled vocabularies; comma-separate for OR within a facet):
--region <codes>- macro-region, e.g.global,eu,us,apac,latam,cis.--region eu,us. Usenoneto match jobs whose region could not be resolved (see "Partial data" below).--country <codes>- ISO-3166 alpha-2, e.g.--country DE,GB--city <names>- city name(s), e.g.--city Berlin--seniority <levels>-junior,middle,senior,staff,principal,lead, …--category <cats>-backend,frontend,fullstack,devops,ml_ai,qa, …--skill <names>- canonical skill(s), e.g.--skill go,kubernetes--company <slug>- company slug (from a result'scompany_slug)--remote <mode>-remote|hybrid|onsite(work_modefacet)--facet <key=value>- any other facet param (repeatable), e.g.--facet salary_min=100000
Location is a facet, not free text. Unlike
linkedin-search's--location, freehire filters geography through the structured--region/--country/--cityfacets. Discover the live values for a market at/api/v1/jobs/facets(append?q=<role>to scope it) - never invent facet values.
Fetch full job detail
bun run .agents/skills/freehire-search/cli/src/cli.ts detail <slug|url> [--format json|plain]slug is the id from a search result (e.g. golang-zensar-2bxu6dxm). You may
also pass a full https://freehire.me/jobs/<slug> URL. Returns the full (HTML-stripped)
description, skills, region/country, and - when the posting is enriched - seniority,
category, employment type, and salary.
Use it for a posting you already have a slug for - a tracked application, a shared
link, or a closed posting search no longer lists. Re-fetching a hit that search
just returned only re-reads a description you already have.
Usage examples
# Senior backend roles, table view
bun run .agents/skills/freehire-search/cli/src/cli.ts search -q "backend engineer" --seniority senior --limit 10 --format table
# Remote React roles in the EU
bun run .agents/skills/freehire-search/cli/src/cli.ts search -q "react" --remote remote --region eu --format table
# DevOps roles in Germany posted in the last 14 days
bun run .agents/skills/freehire-search/cli/src/cli.ts search --category devops --country DE --jobage 14 --format table
# ML/AI roles anywhere, fully remote
bun run .agents/skills/freehire-search/cli/src/cli.ts search -q "machine learning" --category ml_ai --remote remote --format table
# Descriptions as plain text instead of Markdown
bun run .agents/skills/freehire-search/cli/src/cli.ts search -q "platform engineer" --limit 5 --description-format text
# Full details for a specific job
bun run .agents/skills/freehire-search/cli/src/cli.ts detail golang-zensar-2bxu6dxm --format plainOutput formats
| Format | Best for |
json | Default - programmatic use; the only format carrying each hit's description |
table | Quick human-readable scanning |
plain | Reading a single job's full detail (detail command) |
Search JSON is { "meta": { "count", "page", "total" }, "results": [...] }; each
result carries at least id (the freehire slug), title, company, location,
date, url, and description (missing values are null). table and plain
omit the description - it would swamp a scannable list. All errors are written to
stderr as { "error": "...", "code": "..." } and the process exits with code 1.
Partial data
Facets are derived per-posting and can be incomplete - geography especially.
A job may resolve its work_mode (e.g. remote) but leave its region or
country undetermined when the source's location text is ambiguous (freehire's
dictionaries never guess). So:
- A missing region/country means "not resolved", not "not applicable" -
filtering on
--region eusilently drops jobs whose region wasn't resolved, even if they are in fact EU. Widen or drop the facet if you need those back. - There is a dedicated facet value for the unresolved bucket:
--region nonematches jobs with no resolved region - useful to sweep up remote roles that never pinned a geography. It ORs with real regions, e.g.--region eu,none. result.regions/countries/citiesmay be empty arrays for the same reason; treat empty as unknown, not as "none of the above".
Notes
- Data is from freehire.me's public API - no credentials required. Only per-user tracking (apply/save) needs a key, and this skill deliberately does not touch it: it is search + detail only.
idin search results is the freehirepublic_slug- pass it as-is todetail.dateis the posting date (posted_at); it may benullfor undated postings.- Facet values are controlled vocabularies. Use
/api/v1/jobs/facetsto see the live values (with counts) for a query before filtering. - The API retries 429/5xx with exponential backoff; an unreachable API exits non-zero with a clear message (best-effort service, see the dependency note above).
searchcalls/api/v1/agent/jobs/search(public, like the rest). A self-hosted instance older than that endpoint answers 404, and the CLI reports it as an error naming the endpoint - never as an empty result set.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

