Skip to content

Indeed

Mode: 🍪 Browser (cookie) · Domain: www.indeed.com

Indeed sits behind Cloudflare and answers bare HTTP fetches with 403 and a cf-mitigated: challenge header, so the adapter drives a real browser session. DOM extraction happens against the rendered page.

Commands

CommandDescription
opencli indeed search <query>Keyword job search on the US site
opencli indeed job <jk> (alias detail, view)Read the full job posting by jk (job key)

Usage Examples

bash
# Quick start — first run will route through the browser session
opencli indeed search "rust developer" --limit 10

# Narrow to recent jobs in a location, sorted by date
opencli indeed search "site reliability engineer" \
  --location "Remote" --fromage 7 --sort date

# Read a job posting using the `id` surfaced by `search`
opencli indeed job dccc07ac5a6a3683

# JSON output
opencli indeed search "data engineer" -f json

Output Columns

CommandColumns
searchrank, id, title, company, location, salary, tags, url
jobid, title, company, location, salary, job_type, description, url

id is the Indeed job key (jk) — a 16-character lowercase hex identifier. Pipe it into opencli indeed job <jk> to drill into the full posting (per the listing↔detail ID pairing convention).

Args

ArgTypeDefaultNotes
query (positional, required)stringJob title / skill / company
--locationstring(none)E.g. "Remote", "New York, NY"
--fromagestring(none)Recency filter, days back: 1 / 3 / 7 / 14
--sortstringrelevancerelevance or date
--startint0Pagination offset (multiple of 10, 0-based)
--limitint15Max rows to return (1–25, capped to one page)

job

ArgTypeDefaultNotes
id (positional, required)stringJob key (16-char lowercase hex from search)

Prerequisites

Indeed protects the site with Cloudflare. The first run in a fresh browser session may surface the Just a moment… interstitial, in which case the adapter throws:

Indeed served a Cloudflare challenge page
hint: Open https://www.indeed.com in the connected browser and clear the
challenge, then retry.

Open the connected browser, complete the human check on indeed.com once, and the cookies will carry forward into subsequent adapter calls (Strategy.COOKIE).

Limitations

  • US site (www.indeed.com) only. Indeed runs region-specific subdomains (uk.indeed.com, de.indeed.com, ...) — adding them is mostly a question of swapping the origin and re-checking the DOM selectors.
  • Salary parsing pulls the visible text without normalizing currencies or ranges. Pipe through your own normalizer if you need structured values.
  • Tag column is a ·-joined free-text list (job type, schedule, etc.); Indeed's metadata pills change wording per A/B bucket so don't expect a fixed taxonomy.

Released under the Apache-2.0 License.