mcpField
J
jobindex-search

jobindex-search

github.com/ai-job-search-devProductivity67.2k197 installsUpdated 1d ago
Repository

About jobindex-search

jobindex-search is a CLI skill for searching live listings on Denmark's Jobindex.dk, for job seekers exploring roles across sectors. It combines keyword and recency searches with a separate command for full job details.

Key features

  1. 01Search Danish job listings by keyword
  2. 02Filter by posting age and sort by relevance or date
  3. 03Narrow city results by including the city in the query
  4. 04Fetch descriptions, deadlines, and application links
  5. 05Output JSON, table, or plain text

Use cases

  1. 01Find recent Python openings in Denmark
  2. 02Search for roles in a specific city
  3. 03Read full details for a selected listing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ai-job-search-dev/ai-job-search --skill jobindex-search

After installing, type/jobindex-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

url-reference.md
cli/
package.json
README.md
tsconfig.json
cli/src/
cli.ts
helpers.ts
cli/src/commands/
detail.ts
search.ts
cli/tests/
cli-contract.test.ts
cli-flag-validation.test.ts
detail-input.test.ts
detail-parsing.test.ts
documented-search.test.ts
helpers.ts
missing-option-values.test.ts
parsing.test.ts
request-timeout.test.ts
retry-backoff.test.ts
search-page.test.ts
sort-values.test.ts

Details

From the project README

Jobindex Search Skill

Search live Danish job listings from Jobindex.dk. No authentication needed. Covers thousands of job postings across all sectors, updated in real time.

When to use this skill

Invoke this skill when the user wants to:

  • Search for job openings in Denmark by keyword, job title, or technology
  • Find jobs in a specific Danish city (use keyword with city name, e.g. python aarhus)
  • Filter jobs by recency (posted today, last 7 days, last 30 days)
  • Get the full description of a specific job listing
  • Explore the Danish job market for a given profession or skill set

Commands

Search job listings
bun run .agents/skills/jobindex-search/cli/src/cli.ts search --query "<text>" [flags]

Key flags:

  • --query <text> / -q <text> — keyword search (job title, skill, company, city). Required. Searches without a query exit with MISSING_REQUIRED.
  • --jobage <days> — filter by posting age: 1 (today), 7, 14, 30, or 9999 (all, default)
  • --sort <order> — score (relevance, default) or date (newest first)
  • --page <n> — page number (1-indexed, 20 results per page, fixed)
  • --limit <n> — cap total results the CLI outputs (client-side)
  • --format json|table|plain

Area note: The Jobindex API does not support area filtering via params. To find jobs in a specific city, include the city in --query (e.g. --query "data engineer københavn" or --query "python aarhus").

Fetch full job detail
bun run .agents/skills/jobindex-search/cli/src/cli.ts detail <id> [--format json|plain]

id is the job ID from search results (e.g. h1647303). You may also pass the full Jobindex URL. Returns the full job description, deadline, employment type, hours, and apply link.


How to use effectively

Always start with search. Pass the job title, skill, or profession as --query. Combine with a city name in the query to narrow by location (e.g. --query "frontend developer odense").

Use --jobage 7 or --jobage 1 for fresh listings. Without it, results include all historical postings.

Use --sort date to see the most recently posted jobs first. Default score sorts by relevance.

Natural workflow: search → detail.

  1. Use search to find matching jobs and their id values.
  2. Call detail <id> to get the full description, deadline, and apply link.

Use --format table for quick scanning, --format json for data processing, and --format plain for reading a single job's full details.

Pagination: The API always returns 20 results per page. Use --page to navigate pages. Use --limit to cap results across one page fetch.


Usage examples

Find Python jobs posted in the last 7 days
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query python \
  --jobage 7 \
  --sort date \
  --format table
Data engineer jobs in Copenhagen
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query "data engineer københavn" \
  --sort score \
  --format table
Graphic designer jobs — all time, by relevance
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query "grafisk designer" \
  --limit 10 \
  --format table
Full-stack developer jobs, page 2
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query "full stack developer" \
  --page 2 \
  --format json
Jobs posted today for a keyword
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query python \
  --jobage 1 \
  --sort date \
  --limit 20 \
  --format table
Get full details for a specific job
bun run .agents/skills/jobindex-search/cli/src/cli.ts detail h1647303 --format plain
Marketing jobs in Aarhus
bun run .agents/skills/jobindex-search/cli/src/cli.ts search \
  --query "marketing aarhus" \
  --jobage 30 \
  --sort date \
  --format table

Output formats

FormatBest for
jsonDefault — programmatic use, data processing, passing IDs to detail
tableQuick human-readable overview and scanning
plainReading a single job's full detail (detail command)

All errors are written to stderr as { "error": "...", "code": "..." } and the process exits with code 1.


Notes

  • All data is from the public jobindex.dk API — no credentials required.
  • Page size is fixed at 20 results per page (Jobindex API limitation).
  • Area/region filtering via API params does not work — include city names in --query instead.
  • --jobage 9999 is the default and includes all postings regardless of age.
  • Total count in meta.total comes from the numeric searchResponse.hitcount embedded in the search page.
  • Job IDs are string-prefixed (e.g. h1647303) — pass them as-is to detail.

Comments

Markdown supported