Files
ai-job-search/.claude/skills/job-scraper/search-queries.md
T
Yash Rajeshbhai DarjiandCursor 0a8fc194e5 docs: sync onboarding with linkedin-search + freehire-search reality (#150)
/setup still told non-DK users that built-in CLIs are Denmark-specific.
Align setup, /add-portal, and search-queries.md with shipped country-agnostic
CLIs and /scrape auto-discovery (post #85 / #95 / #102).

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-14 14:30:49 +02:00

3.2 KiB

Search Queries for Job Scraper

Installed portal CLIs (primary for /scrape)

/scrape discovers every portal skill under .agents/skills/*/SKILL.md and runs its CLI first. Shipped country-agnostic CLIs include linkedin-search and freehire-search; Danish demos and any skill you add with /add-portal are included the same way. You do not need a matching site: line below for those CLIs to run.

The site: query templates in this file are the WebSearch fallback — for portals without a CLI, company career pages, or when a CLI fails.

Search Sites

Primary (your market's job boards - scaffold one with /add-portal):

  • [YOUR_JOB_BOARD] - your market's largest general job board
  • linkedin.com/jobs - LinkedIn job listings (filter: [YOUR_COUNTRY] / [YOUR_CITY]); also covered by linkedin-search CLI
  • [YOUR_INDUSTRY_JOB_BOARD] - a niche/industry board for your field (optional)
  • [YOUR_ADDITIONAL_JOB_BOARD] - another major board for your market (optional)

Secondary (company career pages via Google):

  • Direct Google searches with site: filters for known target companies

Query Categories

Queries are grouped by priority. Each query should be combined with your location terms (e.g. your city, region, or metro area) where the site supports it.

Priority 1: [YOUR_PRIMARY_ROLE_TYPE]

These match your strongest and most desired career direction.

site:[YOUR_JOB_BOARD] "[YOUR_PRIMARY_JOB_TITLE]" [YOUR_CITY]
site:[YOUR_JOB_BOARD] "[YOUR_KEY_SKILL]" [YOUR_CITY]
site:linkedin.com/jobs "[YOUR_PRIMARY_JOB_TITLE]" [YOUR_COUNTRY]

Priority 2: [YOUR_DOMAIN_EXPERTISE]

These match your domain expertise.

site:[YOUR_JOB_BOARD] [YOUR_DOMAIN_KEYWORD_1] [YOUR_CITY] OR [YOUR_REGION]
site:[YOUR_JOB_BOARD] [YOUR_DOMAIN_KEYWORD_2] [YOUR_COUNTRY]
site:linkedin.com/jobs [YOUR_DOMAIN_KEYWORD_1] [YOUR_CITY] [YOUR_COUNTRY]

Priority 3: [YOUR_ADJACENT_ROLE_TYPE]

Adjacent roles you could pivot into.

site:[YOUR_JOB_BOARD] "[YOUR_ADJACENT_TITLE_1]" [YOUR_KEY_SKILL] [YOUR_CITY]
site:[YOUR_JOB_BOARD] "[YOUR_ADJACENT_TITLE_2]" [YOUR_KEY_SKILL] [YOUR_CITY]

Priority 4: Broader Technical / Consulting

Wider net for general technical roles.

site:[YOUR_JOB_BOARD] [YOUR_KEY_SKILL] developer [YOUR_CITY]
site:linkedin.com/jobs "[YOUR_KEY_SKILL] developer" [YOUR_CITY]
site:[YOUR_JOB_BOARD] "technical consultant" [YOUR_DOMAIN] [YOUR_CITY]

Location Filter

When evaluating results, verify the job location is within reasonable commute distance from your home. Define acceptable areas:

  • [YOUR_CITY] and surrounding areas
  • [ACCEPTABLE_AREA_1]
  • [ACCEPTABLE_AREA_2]
  • [BORDERLINE_AREA] (borderline - ~X min by transit)
  • [TOO_FAR_AREA] (too far)

Date Filter

Only include jobs posted within the last 14 days, or with an application deadline that has not yet passed. If a posting date cannot be determined, include it but flag as "date unknown".

Adapting Queries

If the user specifies a focus area, select queries from the matching category and also generate 2-3 custom queries for that focus. For example:

  • "/scrape [focus_area]" -> relevant category queries + custom focus-specific queries