mcpField
A
amazon-jobs-research

amazon-jobs-research

github.com/crawlora-orgOther141 installsUpdated 1d ago
Repository

About amazon-jobs-research

amazon-jobs-research is a skill for searching Amazon's public careers listings through the Crawlora API. It filters roles by query, category, and country, and can retrieve full posting details and qualifications by job ID.

Key features

  1. 01Search by keyword or category
  2. 02Filter listings by country
  3. 03Sort by relevance or recency
  4. 04Paginate through results
  5. 05Retrieve posting details by job ID

Use cases

  1. 01Browse openings in a job category
  2. 02Find recent roles in a country
  3. 03Review a posting's qualifications
  4. 04Track a posting by its ID

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill amazon-jobs-research

After installing, type/amazon-jobs-researchin Claude Code to confirm it loaded.

Bundled filesreference/endpoints.mdscripts/crawlora.sh

Details

From the project README

Amazon Jobs search

Search Amazon's public careers site (amazon.jobs) and pull individual job postings as normalized JSON from the Crawlora API, no scraping amazon.jobs by hand.

When to use this skill

  • "Search Amazon for jobs in ." — keyword/category search on amazon.jobs.
  • "What is Amazon hiring for in ?" — filter by Amazon's own job-category taxonomy.
  • "Show me the full listing for Amazon job id ." — pull one posting's description and qualifications.
  • "What are the newest Amazon job postings for ?" — sort by most recently posted.

Setup (one-time)

  • Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
  • Set CRAWLORA_API_KEY in the environment before running the helper.
  • The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

  1. Search — /amazon-jobs/search queries amazon.jobs's credential-free search JSON. Either q (text query) or category (Amazon's own job-category taxonomy slug) is required — pass both to narrow further. Optional country (ISO 3166-1 alpha-3) filters by location, sort picks relevant (default) or recent, and limit/page paginate results. Each result already includes the full description and qualifications inline, so a detail call is only needed to re-fetch one posting later.
  2. Job detail — /amazon-jobs/job returns one posting by its numeric Amazon job id (the id field from a search result). Parsed from amazon.jobs's stable server-rendered job page — there is no separate JSON detail endpoint upstream.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Search by keyword + country, newest first:
scripts/crawlora.sh /amazon-jobs/search q="software development engineer" country=USA sort=recent | jq '.'

# Fetch one posting by id:
scripts/crawlora.sh /amazon-jobs/job id=2612345 | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for both Amazon Jobs endpoints this skill uses.

Examples

  • Category browse: /amazon-jobs/search category=hr-and-recruiting with no text query to list every open role in a category, then page through with page/limit.
  • Track one posting over time: save the id from a search hit, then poll /amazon-jobs/job id=<id> on a schedule to detect edits or removal (a missing/changed result signals the role closed or was updated).

Notes & limits

  • Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
  • Public data only — public Amazon.jobs postings; respect Amazon's terms.
  • Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
  • Either q or category is required on /amazon-jobs/search — a call with neither will fail.
  • Results are paginated — pass page/limit (max 100 per page) to walk the full list.

Comments

Markdown supported