freehire-search

Search and retrieve tech job listings from the freehire.me aggregator API.

Updated Sep 23, 2026
One-click install
npx skills add https://github.com/zaheer037/job-search --skill freehire-search-zaheer037
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: freehire-search
Source: https://github.com/zaheer037/job-search/tree/main/.agents/skills/freehire-search
Command: npx skills add https://github.com/zaheer037/job-search --skill freehire-search-zaheer037

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Searching for tech jobs across dozens of applicant tracking systems and country markets normally means visiting many job boards with different schemas. This Skill queries the freehire.me aggregator's public JSON API, which normalizes postings from roughly 50 ATS platforms into one schema, so a single command searches many markets at once. ## Core Features & Use Cases - Faceted job search: Filter live listings by keyword, region, country, city, seniority, category, skills, company, work mode, and posting recency, with results returned as JSON, table, or plain text. - Full descriptions in one request: Search hits carry each posting's complete description via the agent search endpoint, so no per-result follow-up fetch is needed. - Single-posting lookup: Fetch full detail for one job by its slug or freehire.me URL, including closed postings that search no longer lists. - Use Case: Ask your agent to find remote senior backend roles in the EU posted in the last 14 days, and it returns a scannable table of matching jobs with slugs you can look up in full later. ## Quick Start Use the freehire-search skill to find remote senior backend engineer jobs in the EU posted within the last 14 days and show the results as a table.

Frequently Asked Questions about freehire-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for remote tech jobs from the command line?▼

Run the CLI's search command with bun, passing keywords and facet flags such as --remote remote, --region eu, or --seniority senior. Results come back as JSON by default, with table and plain formats available for quick scanning.

What job boards does the freehire.me API aggregate?▼

freehire.me normalizes postings from roughly 50 applicant tracking systems across many countries into one schema. Its faceted filtering for skills, category, and seniority is tuned tech-first, so it works best for software, data, and engineering roles.

Does the freehire API require an API key or authentication?▼

No authentication is needed for reads. The search, facets, and job detail endpoints are public and unauthenticated; only per-user tracking mutations like apply and save require a key, and this Skill does not use them.

Can I self-host the freehire backend instead of using freehire.me?▼

Yes. The freehire backend is an MIT-licensed Go and PostgreSQL project that starts via Docker Compose, and the CLI honors the FREEHIRE_API_URL environment variable to point at a local instance on port 8080 with the same API paths.

Why do some job search results have empty region or country fields?▼

Facets are derived per posting and geography is often unresolved when the source location text is ambiguous. An empty region means unknown, not inapplicable, so filtering by region silently drops those jobs; use --region none to include them.

What are the limitations of freehire for non-tech job searches?▼

freehire's corpus includes some non-tech postings, but its skills, category, and seniority dictionaries are tuned tech-first, so filtering quality for general roles is still maturing. The Skill deliberately scopes its triggers to technical positions.