hiring-demand-analysislisted
Install: claude install-skill Crawlora-org/crawlora-skills
# Hiring demand analysis
Measure the advertised openings observed in a defined corpus. Postings are not
completed hires, headcount growth, unique vacancies, or the entire labor market.
## Setup
Set `CRAWLORA_API_KEY` to your key from [crawlora.net](https://crawlora.net).
Run the bundled `scripts/crawlora.sh` from this skill directory or by absolute
path. It sends `x-api-key` to `https://api.crawlora.net/api/v1`; keep the key in
the environment. Read [reference/endpoints.md](reference/endpoints.md) for
jobs search, global facets, company discovery, and posting detail.
## Define the population before counting
1. Specify the role/skill question, locations, providers, employment/workplace
scope, observation date, and required sample coverage. Search
`/datasets/jobs/search`; open roles are the default. `include_closed=true`
adds stored closed roles but does not reconstruct past point-in-time vacancies.
2. Read `/datasets/jobs/facets?size=...` for corpus context and labels. **This
endpoint accepts only bucket size, not search filters.** Its `total_open`,
`remote_open`, and buckets are global. Do not use them as the denominator or
skill distribution for a filtered search. Buckets are capped, not exhaustive.
3. Use search fields that actually exist: `q` spans title/company/description;
`city`, `state`, `country`, `department`, and `job_family` have their documented
matching behavior. `workplace_type` accepts `onsite`, `hybrid`, `remote`.
Skill and seni