From ebb78df0698afe9ddb2aa1c86e0a60d3eb4686af Mon Sep 17 00:00:00 2001 From: Ilya Strelov Date: Mon, 19 Oct 2026 14:25:28 -0300 Subject: [PATCH] freehire-search: us is a country, not a region (#630) * freehire-search: us is a country, not a region The docs and --help listed us as a --region value. In freehire's location dictionary us is a country code and the region is north_america, so --region us matched 168 'software engineer' postings against 100008 for --country us. List the real region vocabulary and send single-country searches to --country. * freehire-search: add uk to the region list; fix the README row * changelog: place the #630 entry under [Unreleased] Co-Authored-By: Claude Opus 5.5 --------- Co-authored-by: Mads Lorentzen Co-authored-by: Claude Opus 5.5 --- .agents/skills/freehire-search/SKILL.md | 2 +- .agents/skills/freehire-search/cli/README.md | 2 +- .agents/skills/freehire-search/cli/src/cli.ts | 4 +++- .agents/skills/freehire-search/url-reference.md | 2 +- CHANGELOG.md | 9 +++++++++ 5 files changed, 15 insertions(+), 4 deletions(-) diff --git a/.agents/skills/freehire-search/SKILL.md b/.agents/skills/freehire-search/SKILL.md index 01221fa4..c748a6a9 100644 --- a/.agents/skills/freehire-search/SKILL.md +++ b/.agents/skills/freehire-search/SKILL.md @@ -101,7 +101,7 @@ 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 ` — macro-region, e.g. `global`, `eu`, `us`, `apac`, `latam`, `cis`. `--region eu,us`. Use `none` to match jobs whose region could **not** be resolved (see "Partial data" below). +- `--region ` - macro-region: `global`, `eu`, `uk`, `north_america`, `latam`, `apac`, `mena`, `africa`, `cis`. `--region eu,uk`. `eu` does not include the UK; add `uk` for Europe as a whole. For a single country use `--country` instead - `us` is a country code, not a region, and `--region us` matches nothing. `--region`, `--country` and `--city` form one OR-group, so `--country us` alone scopes to the US. Use `none` to match jobs whose region could **not** be resolved (see "Partial data" below). - `--country ` — ISO-3166 alpha-2, e.g. `--country DE,GB` - `--city ` — city name(s), e.g. `--city Berlin` - `--seniority ` — `junior`, `middle`, `senior`, `staff`, `principal`, `lead`, … diff --git a/.agents/skills/freehire-search/cli/README.md b/.agents/skills/freehire-search/cli/README.md index 569a2682..63b8f8ce 100644 --- a/.agents/skills/freehire-search/cli/README.md +++ b/.agents/skills/freehire-search/cli/README.md @@ -75,7 +75,7 @@ See `../SKILL.md` for the full flag reference and the hosted-dependency note. | `--jobage` | | Posted within N days (`posted_within_days`). | | `--page` | | 1-indexed page. Default 1. | | `--limit` | `-n` | Results per page (API limit). Default 25. | -| `--region` | | Macro-region(s), comma = OR (e.g. `eu,us`). | +| `--region` | | Macro-region(s), comma = OR: `global`, `eu`, `uk`, `north_america`, `latam`, `apac`, `mena`, `africa`, `cis` (e.g. `eu,uk`). A country such as `us` goes in `--country`. | | `--country` | | ISO-3166 alpha-2 code(s). | | `--city` | | City name(s). | | `--seniority` | | Seniority level(s). | diff --git a/.agents/skills/freehire-search/cli/src/cli.ts b/.agents/skills/freehire-search/cli/src/cli.ts index 83f1be8e..12dd1507 100644 --- a/.agents/skills/freehire-search/cli/src/cli.ts +++ b/.agents/skills/freehire-search/cli/src/cli.ts @@ -89,7 +89,9 @@ SEARCH FLAGS full description is rendered (json output only). FACET FILTERS (values from freehire.me's controlled vocabularies; comma = OR) - --region Macro-region: global, eu, us, apac, latam, cis, ... e.g. --region eu,us + --region Macro-region: global, eu, uk, north_america, latam, apac, + mena, africa, cis e.g. --region eu,uk + (a country such as us goes in --country, not here) --country ISO-3166 alpha-2, e.g. --country DE,GB --city City name(s), e.g. --city Berlin --seniority junior, middle, senior, staff, principal, lead, ... diff --git a/.agents/skills/freehire-search/url-reference.md b/.agents/skills/freehire-search/url-reference.md index 38b3d307..8677ccf1 100644 --- a/.agents/skills/freehire-search/url-reference.md +++ b/.agents/skills/freehire-search/url-reference.md @@ -68,7 +68,7 @@ Query parameters used by the skill: | `limit` | `--limit` / `-n` | Page size. Default 25 in the CLI. | | `offset` | (derived) | `offset = (page - 1) * limit`. | | `posted_within_days` | `--jobage` | Restrict to postings from the last N days. | -| `regions` | `--region` | Repeatable; OR within the facet. Values like `global`, `eu`, `us`, `apac`, `latam`, `cis`. | +| `regions` | `--region` | Repeatable; OR within the facet. Values: `global`, `eu`, `uk`, `north_america`, `latam`, `apac`, `mena`, `africa`, `cis`. `us` is a country (`countries`), not a region. | | `countries` | `--country` | Repeatable; ISO-3166 alpha-2 (lowercased). | | `cities` | `--city` | Repeatable; display-name city. | | `seniority` | `--seniority` | Repeatable; `junior`, `middle`, `senior`, `staff`, … | diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b749f3d..5c7df633 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -45,6 +45,15 @@ per-file diff commands. budget fails the request at once with a message naming the requested wait. Giving up on a persistent 5xx still takes about 25 s over 7 calls, as before. +- **`freehire-search` docs list the real `--region` buckets and send a country to `--country`** + (#630, `.agents/skills/freehire-search/SKILL.md`, `url-reference.md`, `cli/README.md`, `--help`) - + the docs and `--help` offered `us` as a region, but in freehire's vocabulary `us` is a country code + and the macro-region that holds US postings is `north_america`. `--region us` returned 168 + software-engineer postings where `--country us` returned about 100,000, with nothing in the output + to say why (reported in #616). The docs now list the nine buckets (`global`, `eu`, `uk`, + `north_america`, `latam`, `apac`, `mena`, `africa`, `cis`) plus `none`, note that `eu` excludes + the UK, and point single-country searches at `--country`. + ## [1.7.3] - 2026-10-19 ### Added