| name | scan |
| description | Scan company career pages for job openings that match your profile. Uses web search with site-scoped queries to find listings on Greenhouse, Lever, Ashby, SmartRecruiters, and other ATS platforms. Use when someone says 'scan for jobs', 'check careers page', 'find openings at', or 'search for roles'. |
| argument-hint | <company name, careers URL, or 'all' to scan watchlist> |
| user-invocable | true |
| allowed-tools | ["Read","Write","WebSearch","Glob"] |
Scan for Job Openings
Search company career portals for roles matching your profile.
Use ATS type and slug detection (see references/ats-endpoints.md) to build
targeted site-scoped WebSearch queries.
Step 0: Load Context
- Read
data/profile.yml for target roles, skills, seniority
- Read
config/portals.yml if it exists (company watchlist)
- Read
data/scan-history.md if it exists (dedup against seen postings)
- Read
data/applications.md to exclude roles already tracked
Step 1: Determine What to Scan
Parse user input:
- Company name: Look up in portals.yml for ATS type and slug.
If not found, use WebSearch to find their careers page and detect ATS.
- URL: Detect ATS type from URL pattern:
boards.greenhouse.io/{slug} or {company}.greenhouse.io -> Greenhouse
jobs.lever.co/{slug} -> Lever
jobs.ashbyhq.com/{slug} or {company}.ashbyhq.com -> Ashby
jobs.smartrecruiters.com/{slug} -> SmartRecruiters
- Other -> use WebSearch with
{company name} careers {role keywords}
- "all" / "scan my watchlist": Scan every enabled company in portals.yml.
If no portals.yml exists, tell the user:
"You don't have a company watchlist yet. Tell me some companies
you're interested in and I'll set one up."
- "scan {industry}": Use WebSearch to find companies hiring in that
industry, then scan their career pages.
Step 2: Fetch Job Listings
Tier 1: WebSearch (primary)
Use WebSearch with targeted site-scoped queries to find job listings.
Use the ATS type and slug identified in Step 1 to build precise queries.
Search strategy by ATS:
- Ashby:
site:jobs.ashbyhq.com/{slug} {target role keywords}
- Lever:
site:jobs.lever.co/{slug} {target role keywords}
- Greenhouse:
site:job-boards.greenhouse.io/{slug} {target role keywords}
(Note: Greenhouse pages are poorly indexed. If no results, try
{company name} careers {target role keywords} greenhouse)
- SmartRecruiters:
site:jobs.smartrecruiters.com/{slug} {target role keywords}
- Workday:
site:{tenant}.myworkdayjobs.com {target role keywords}
- Generic / unknown ATS:
{company name} careers {target role keywords} {current year}
Build target role keywords from the profile: combine primary_role,
secondary_roles, and top 3 skills. Example for a marketing director:
marketing director OR head of marketing OR VP marketing
Parse search results: Each result typically contains the job title
in the link text and the URL to the posting. Extract title and URL from
each search result. If the search returns descriptions, extract location
and department info as well.
Run multiple queries if needed: One for the primary role, one for
secondary roles. Deduplicate by URL before filtering.
Tier 2: Manual Fallback
If WebSearch fails to return results:
"I couldn't find listings automatically for {company}. Here's their
careers URL: {url}. You can browse it and paste any interesting
job postings for me to evaluate."
Step 3: Filter & Match
For each job listing found:
-
Title relevance: Compare against target roles from profile.yml
- Match target role keywords (primary + secondary roles)
- Exclude roles that don't match seniority level
- Exclude titles with negative keywords if profile has exclude_keywords
-
Quick relevance score (0-10):
- Title match to target roles: 0-4 points
- Skills/keyword overlap with profile: 0-3 points
- Location/remote match: 0-2 points
- Seniority alignment: 0-1 point
-
Dedup:
- Check URL against
data/scan-history.md (skip if seen)
- Check company + title against
data/applications.md (skip if tracked)
Step 4: Output
## Scan Results: {Company} - {date}
Found **{X}** openings, **{Y}** match your profile.
### Matches (by relevance)
| # | Role | Location | Relevance | Link |
|---|---|---|---|---|
| 1 | {title} | {location} | {score}/10 | {URL} |
| 2 | ... | ... | ... | ... |
### Filtered Out ({Z} roles)
{Brief list: "3 junior roles, 2 in unrelated departments, 1 requires
relocation to {city}"}
Step 5: Save & Next Steps
Add all matches to data/pipeline.md (create if doesn't exist):
# Job Pipeline
| Date Found | Company | Role | Relevance | URL | Status |
|---|---|---|---|---|---|
| {today} | {company} | {title} | {score}/10 | {url} | New |
Log ALL seen postings (matches + filtered) to data/scan-history.md:
| Date | Company | Role | URL | Action |
|---|---|---|---|---|
| {today} | {company} | {title} | {url} | Matched / Filtered: {reason} |
"Found {Y} matching roles at {company}.
Want me to:
- Evaluate the top match? Say 'evaluate #1'
- Triage the full pipeline? Say 'triage my pipeline'
- Scan another company? Say 'scan {company}'"