agentic-career-search
by Francis1998
Autonomous AI-agent orchestration engine for job discovery with decision traces, tool adapters, and production-grade run control.
101stars
15forks
Python
Added 8/13/2026
AI Agentsagentic-workflowai-agentai-orchestrationautomationautonomous-agentscareer-toolsfastapijob-searchllm-integrationmulti-agent-systemspython
Installation
# Add to your Claude Code skills
git clone https://github.com/Francis1998/agentic-career-searchGetting Started
Guides for using ai agents skills like agentic-career-search.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 8/13/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-08-13T05:40:54.661Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}agentic-career-search
AI-agent backend for autonomous job discovery, explainable decisions, and production-style operations.
Demo Gallery
Why this exists
Most job-search automation demos fail in real usage because they:
- cannot explain why a role is ranked highly,
- cannot recover cleanly when providers fail,
- have no durable event trace for debugging,
- become hard to maintain once features grow.
This project solves those issues with explicit agent engineering primitives:
- deterministic decision engine with rationale traces,
- state-machine run lifecycle and durable event log,
- tool/adapters abstraction for external integrations,
- safety controls (timeouts, bounded scope, cancellation),
- optional LLM enrichment via multiple providers.
Real use cases (problem -> solution)
| Problem | Why it hurts | How this repo solves it |
|---|---|---|
| Teams can scrape jobs but cannot justify recommendations | Low trust from users and reviewers | AgentDecisionEngine stores score, matched terms, priority tier, and rationale |
| Background runs are hard to debug | Silent failures block iteration speed | Durable run events (run.*, source.*, agent.*) support replay-style troubleshooting |
| Vendor lock-in around one model provider | High migration cost and brittle integrations | Configurable LLM enrichment supports GPT-5.5, Claude Sonnet 4.6, Gemini 3.x, and Kimi K2-style APIs |
| Model/API outages break the entire flow | System appears unreliable | Graceful fallback preserves deterministic baseline output when LLM enrichment is unavailable |
| Repo quality degrades over time | Contributors lose confidence | CI checks + daily automation loop maintain quality and push incremental improvements |
LLM API integration (consumes model outputs)
Provider integration is built into the code path:
- Gemini API
- Kimi (Moonshot, OpenAI-compatible)
- Claude (Anthropic Messages API)
- GPT-compatible APIs through OpenAI-style endpoint patterns
Enable provider enrichment:
LLM_ENABLE_ENRICHMENT=true
LLM_PROVIDER=gemini # or kimi / claude / gpt
Then set matching API keys in .env (see CONFIGURATION.md).
Engineering standards covered
This repository follows the requested standards:
- standalone repo architecture (not coupled to source repo internals),
- AI-agent-first design with deterministic decision traces,
- LLM output consumption from Claude/Gemini/Kimi and GPT-style integrations,
- production-minded layout (
src,tests,scripts, CI, env config, migrations), - high-quality docs (
README,QUICKSTART,CONFIGURATION,SAFETY,ARCHITECTURE), - branch-based merge workflow for controlled integration (no direct unsafe merges),
- lint/type/test validation before finalization,
- no Docker requirement for standard local verification,
- phase branches for development roadmap (
phase/01tophase/10), - commit-forward workflow with frequent incremental pushes.
API snapshot
POST /source-configscreate source adapter configsGET /source-configslist enabled sourcesPOST /runsenqueue autonomous runGET /runs/{run_id}inspect run stateGET /runs/{run_id}/eventsinspect event timelinePOST /runs/{run_id}/cancelrequest cancellationGET /jobsinspect normalized, scored, and enriched outputsGET /health/liveandGET /health/ready
Supported job sources
Each SourceConfig selects a source adapter by source_type:
source_type |
Adapter | How it parses | Best for |
|---|---|---|---|
greenhouse |
GreenhouseAdapter |
Scrapes div.opening anchors on public Greenhouse boards |
Greenhouse-hosted boards |
lever |
LeverAdapter |
Scrapes div.posting anchors on public Lever pages |
Lever-hosted boards |
ashby |
AshbyAdapter |
Recognises jobs.ashbyhq.com/{org}/{uuid} posting anchors by URL shape |
Ashby-hosted boards |
workable |
WorkableAdapter |
Recognises apply.workable.com/{company}/j/{shortcode} posting anchors by URL shape |
Workable-hosted boards |
recruitee |
RecruiteeAdapter |
Recognises {company}.recruitee.com/o/{slug} posting anchors by URL shape |
Recruitee-hosted careers sites |
smartrecruiters |
SmartRecruitersAdapter |
Recognises jobs.smartrecruiters.com/{company}/{jobId}-{slug} posting anchors by URL shape |
SmartRecruiters-hosted careers sites |
teamtailor |
TeamtailorAdapter |
Recognises {company}.teamtailor.com/jobs/{jobId}-{slug} posting anchors by URL shape |
Teamtailor-hosted careers sites |
personio |
PersonioAdapter |
Recognises {tenant}.jobs.personio.de/.com/job/{jobId} posting anchors by URL shape |
Personio-hosted careers sites (DACH/EU) |
bamboohr |
BambooHrAdapter |
Reads the public {tenant}.bamboohr.com/careers/list JSON board and maps each opening to /careers/{id} |
BambooHR-hosted careers sites (SMB tech/healthcare/services) |
jobvite |
JobviteAdapter |
Recognises jobs.jobvite.com/{company}/job/{jobId} posting anchors by URL shape (terminal singular job, alphanumeric id) |
Jobvite-hosted careers sites |
icims |
IcimsAdapter |
Recognises careers-{tenant}.icims.com/jobs/{jobId}/{slug}/job posting anchors by URL shape (terminal literal job, numeric id; slug optional) |
iCIMS-hosted careers portals (enterprise) and vanity-domain proxies |
workday |
WorkdayAdapter |
POSTs the public {tenant}.wd{N}.myworkdayjobs.com/wday/cxs/{tenant}/{site}/jobs JSON CXS board (page size 20) and maps each posting to {origin}/{locale}/{site}{externalPath} |
Workday-hosted enterprise careers sites |
oracle_taleo |
OracleTaleoAdapter |
Recognises Taleo/Oracle Cloud posting anchors via job= query ids or terminal /job/{id} / /jobs/{id} path shapes |
Oracle Taleo (*.taleo.net) and Oracle Cloud HCM careers portals |
successfactors |
SuccessFactorsAdapter |
Recognises SuccessFactors posting anchors via jobId / career_job_req_id query ids or terminal /job/{id} / /jobs/{id} path shapes |
SAP SuccessFactors (*.successfactors.com / *.successfactors.eu) careers portals |
zoho_recruit |
ZohoRecruitAdapter |
Recognises Zoho Recruit posting anchors via jobId / jid / job_id query ids or terminal /job/{id} / /jobs/{id} / /careers/{id} path shapes |
Zoho Recruit (*.zohorecruit.com) careers portals and vanity-domain proxies |
jazzhr |
JazzHrAdapter |
Recognises JazzHR posting anchors via /apply/{jobId} or /apply/{jobId}/{slug} path shapes |
JazzHR (*.applytojob.com/apply) careers portals and vanity-domain proxies |
breezyhr |
BreezyHrAdapter |
Recognises {company}.breezy.hr/p/{positionId} posting anchors by URL shape (terminal p, alphanumeric id; slug optional) |
Breezy HR-hosted careers sites (startup/SMB) |
freshteam |
FreshteamAdapter |
Recognises Freshteam careers posting anchors by job URL shape | Freshworks Freshteam-hosted careers boards |
phenom |
PhenomPeopleAdapter |
Recognises Phenom posting anchors via /job/{jobId}/{slug} or /jobs/{jobId} path shapes, rejecting list/index/login/apply-step links |
Phenom People-hosted enterprise and branded careers sites |
rippling |
RipplingAdapter |
Recognises Rippling posting anchors via terminal /jobs/{uuid} paths on *.rippling.com domains |
Rippling-hosted public careers boards |
pinpoint |
PinpointAdapter |
Recognises Pinpoint HR careers posting anchors by /postings/{uuid} or /jobs/{id} URL shape |
Pinpoint (*.pinpointhq.com) careers boards |
comeet |
ComeetAdapter |
Recognises Comeet careers posting anchors by /jobs/{company}/{companyId}/{jobSlug}/{jobId} URL shape |
Comeet (www.comeet.co / www.comeet.com) careers boards |
fountain |
FountainAdapter |
Recognises Fountain careers posting anchors by /apply/{company}/{positionId}, /apply/{slug}, /jobs/{id}, /openings/{id}, or /positions/{id} URL shape |
Fountain (*.fountain.com, web.fountain.com) careers boards |
gem |
GemAdapter |
Recognises Gem careers posting anchors by jobs.gem.com/{company}/{jobId}, /jobs/{jobId}, /openings/{id}, or {company}.gem.com/careers/... URL shapes |
Gem (jobs.gem.com / *.gem.com) careers boards |
avature |
AvatureAdapter |
Recognises Avature careers posting anchors by /JobDetail/{id}, /JobDetail.aspx?JobId={id}, /careers/{id}, /careers/job/{id}, /careers/VacancyDetail/{id}, /Vacancy/{id}, or /vacancies/{id} URL shapes |
Avature-hosted public careers portals |
eightfold |
EightfoldAdapter |
Recognises Eightfold careers posting anchors by /careers/job/{id}, /careers/job/{id}/{slug}, /career_detail/{id}, /position/{id}, or /jobs/{id} URL shapes |
Eightfold (*.eightfold.ai) careers boards |
jobscore |
JobScoreAdapter |
Recognises JobScore careers posting anchors by /careers/{company}/jobs/{slug}-{id}, /careers/{company}/jobs/{id}, /jobs/{id}, /jobs/{slug}/{id}, or /position(s)/{id} URL shapes |
JobScore (careers.jobscore.com / *.jobscore.com) careers boards |
hireology |
HireologyAdapter |
Recognises Hireology careers posting anchors by /jobs/{id}, /careers/job/{id}, or /job/{id}/{slug} URL shapes |
Hireology (careers.hireology.com) careers boards |
dayforce |
DayforceAdapter |
Recognises Dayforce careers posting anchors by /JobDetail/{id}, /careers/job/{id}, `/MyCareer/JobDetail?jobId={id |
Frequently Asked Questions
What is agentic-career-search?
agentic-career-search is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Francis1998. Autonomous AI-agent orchestration engine for job discovery with decision traces, tool adapters, and production-grade run control. It has 101 GitHub stars.
Is agentic-career-search safe to use?
Yes. agentic-career-search passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install agentic-career-search?
Clone the repository with "git clone https://github.com/Francis1998/agentic-career-search" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is agentic-career-search written in?
agentic-career-search is primarily written in Python. It is open-source under Francis1998 on GitHub, so you can review or fork the full source.
Are there alternatives to agentic-career-search?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agentic-career-search against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
239,787
36,396
JavaScript
AI Agentsai-agentsanthropic
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
200,415
60,102
TypeScript
MCP Serversaiapis
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
126,799
8,655
Rust
AI Agentsai-toolsclaude-code