mcpField
J
jobbank-search

jobbank-search

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

About jobbank-search

jobbank-search is a CLI skill for searching Danish listings on Akademikernes Jobbank, a portal for highly educated candidates. It offers filters for job type, region, education, and remote work, and parses structured details from job pages.

Key features

  1. 01Search by keyword and exclude terms
  2. 02Filter by job type, region, function, and industry
  3. 03Narrow by education, remote status, and candidate suitability
  4. 04Fetch full descriptions and structured job details
  5. 05Output JSON, table, or plain text

Use cases

  1. 01Find graduate or trainee positions
  2. 02Search remote IT roles by region
  3. 03Review deadlines and company details for a 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 jobbank-search

After installing, type/jobbank-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-jsonld.test.ts
detail-url-normalization.test.ts
helpers.ts
missing-option-values.test.ts
reject-network.ts
repeated-filter-cli.test.ts
request-timeout.test.ts
retry-backoff.test.ts
rss-fetch.test.ts
rss-parsing.test.ts
search-normalization.test.ts

Details

From the project README

Jobbank Search Skill

Search live Danish job listings from Akademikernes Jobbank — Denmark's primary job portal for highly educated candidates. Uses the RSS feed for search (up to 100 results) and JSON-LD parsing for detailed job information. Jobbank may block automated requests with Cloudflare bot protection; if that happens, report the portal as unavailable and use WebSearch fallback instead of retrying.

When to use this skill

Invoke this skill when the user wants to:

  • Search for jobs, positions, or career opportunities in Denmark
  • Find academic, graduate, trainee, Ph.d., or postdoc positions
  • Look for jobs by keyword, industry, location, education background, or work function
  • Find remote or hybrid positions in Denmark
  • Get full details for a specific job posting on jobbank.dk
  • Check what positions are available at a specific company on jobbank.dk
  • Browse jobs suitable for new graduates or people with international backgrounds

Commands

Search jobs
bun run .agents/skills/jobbank-search/cli/src/cli.ts search [flags]

Key flags:

  • --key <text> — keyword search (title, company, keyword)
  • --exclude <text> — exclude keywords from results
  • --type <code> — job type: 3=Fuldtidsjob, 6=Graduate/trainee, 13=Deltidsjob, 8=Vikariat, 12=Ph.d. & Postdoc, 11=Freelance, 9=Praktikplads, 4=Studiejob (repeatable)
  • --location <code> — region: 2=Storkøbenhavn, 8=Østjylland (Aarhus), 7=Midtjylland, 6=Nordjylland, 13=Fyn (repeatable)
  • --work-area <code> — function: 31=IT-Software, 43=Data & Analyse, 26=Ledelse, 29=Marketing (repeatable)
  • --industry <code> — sector: 10331=IT & Tele, 10442=Forskning & Uddannelse, 10358=Finans (repeatable)
  • --education <code> — education field: 24=IT, 21=Økonomi & Revision, 34=Samfundsvidenskab (repeatable)
  • --remote <value> — helt (fully remote) or delvist (partially remote)
  • --suitable-for <code> — 2=Nyuddannede, 4=International baggrund, 5=Erfarne
  • --company <id> — filter by company ID
  • --since <YYYY-MM-DD> — jobs posted on or after this date
  • --limit <n> — cap results returned by CLI
  • --format json|table|plain

RSS limitation: The RSS feed returns max 100 items per request. No pagination is available via RSS. meta.total shows the true count; results is capped at 100.

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

id is the numeric job ID from search results. Fetches the job page and parses the embedded Schema.org JobPosting JSON-LD for structured data.


How to use effectively

Start with search, then use detail for full description.

  1. Use search with --key and/or filters to find matching jobs with IDs
  2. Call detail <id> to get the full HTML job description, exact deadline, and company details

Use repeatable flags for multi-value filters. Most filter flags can be repeated to match any of the values:

# IT or Finance industry, Copenhagen or Aarhus
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --industry 10331 --industry 10358 \
  --location 2 --location 8

Filter codes are documented in the README at skills/jobbank-search/cli/README.md.


Usage examples

Find data scientist jobs in Copenhagen
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --key "data scientist" \
  --location 2 \
  --format table
Graduate trainee positions for new graduates
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --type 6 \
  --suitable-for 2 \
  --format table
Remote IT software jobs
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --work-area 31 \
  --remote helt \
  --format table
Ph.d. and postdoc positions in research
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --type 12 \
  --industry 10442 \
  --format table
Recent full-time jobs posted since March 1
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --type 3 \
  --since 2026-03-01 \
  --format table
Full details for a specific job
bun run .agents/skills/jobbank-search/cli/src/cli.ts detail 1234567 --format plain
IT jobs in Aarhus or Copenhagen
bun run .agents/skills/jobbank-search/cli/src/cli.ts search \
  --key developer \
  --location 2 --location 8 \
  --work-area 31 \
  --format table

Output formats

FormatBest for
jsonDefault — programmatic use, passing IDs to detail
tableQuick human-readable list of results
plainSingle-job detail views (detail command)

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


Notes

  • Data is from the public jobbank.dk RSS feed and HTML pages. Jobbank may still block automated CLI requests with Cloudflare bot protection; treat that as a portal availability failure and fall back to WebSearch.
  • RSS feed returns max 100 results per query. For higher counts, meta.total shows the true total.
  • The detail command fetches a full job page and extracts the JSON-LD structured data block.
  • location values are region codes (e.g. 2 = Storkøbenhavn), not city names.
  • All filter codes are documented in skills/jobbank-search/cli/README.md.

Comments

Markdown supported