// Findyet on the command line
Search and track
from the terminal.
Findyet is a small CLI — and an MCP server — over the
same job API the site runs on. One API key lets an AI agent or a script search and open jobs, track
applications, work through your application mail and tailor a CV to a vacancy — all without a browser. (You still apply on the employer's site;
the CLI records that you did.)
Not on the terminal? Every way to connect an agent — MCP hosts, ChatGPT, and your own client.
# install — no Go needed curl -fsSL https://findyet.devjoys.com/install.sh | sh # authenticate once (key from /my/api-keys) findyet auth login --token fyk_… # discover the market, then search findyet facets findyet search "golang" --remote --region eu
// commands
Discover
- findyet facets
- Every filter's live values + counts — the vocabulary to filter by.
- findyet market-fit --skills go,react
- How much of the live market your skills cover, and the gaps.
- findyet search <query>
- List matching jobs (add --remote, --region, --company).
- findyet job <slug>
- Show a job's full content.
- findyet company <slug>
- Show a company and its open jobs.
Track applications & notes
- findyet apply <slug>
- Mark a job applied for your account.
- findyet save <slug>
- Bookmark a job (unsave to remove).
- findyet stage <slug> <stage>
- Set the application stage.
- findyet note <slug> <text>
- Attach a free-text note.
- findyet my --filter applied
- Your tracked jobs (all|viewed|saved|applied).
- findyet profile
- Your saved search profile — skills, seniority, regions.
Application mail
- findyet inbox push --file mail.json
- Upload a batch your own client fetched (keyed by Message-ID, so a re-sync updates instead of duplicating).
- findyet inbox list --unclassified --body
- The agent's work queue: unjudged mail with bodies inline, and nothing gets marked read.
- findyet inbox triage <id> <signal>
- Record what a message is; a confident verdict moves the application forward.
- findyet inbox list --link suggested
- Proposed links awaiting your word — inbox confirm / inbox reject.
- findyet inbox list --link unlinked
- Mail with no application to attach to — inbox application records one from the message.
Contribute & moderate
- findyet contribute <url>
- Hand Findyet a job link; a board we don't track yet gets added and crawled.
- findyet contributions
- The boards you've contributed and their state.
- findyet submissions
- Jobs you submitted and where each one stands.
Start from findyet facets — it lists every filter's live
values so search and market-fit use real values, not guesses. Everything you
save, apply to and stage shows up on your Tracking board. stage takes a controlled value: preparing → applied → screening → responded → interview → offer → accepted, plus rejected / withdrawn.
Tailor a CV to a vacancy
After a match analysis, reframe your CV toward one job — grounded in what you actually did, never
fabricated — then export an ATS-ready PDF. cv context is the honest part: it splits the job's requirements into the ones your history already covers but
buries (reframe those) and the ones it doesn't (ask, don't invent), so an agent editing your CV
knows which is which.
findyet cv context <id> # the match analysis to reframe toward findyet cv get <id> # the CV document as JSON findyet cv edit <id> --set … # one edit by path (--ops for a batch) findyet cv render <id> --out cv.pdf
// mcp
Same key, any AI host
Findyet's hosted MCP server exposes the same search, market-fit and tracking tools over the Model Context Protocol — so Claude Desktop, Claude Code or any MCP host can drive Findyet directly. Nothing to install: point the host at the URL and send your API key as a bearer token.
In Claude Code it is one command:
claude mcp add --transport http findyet \ https://findyet.devjoys.com/api/v1/mcp/account \ --header "Authorization: Bearer fyk_…"
No key? https://findyet.devjoys.com/api/v1/mcp answers
catalogue questions — search, salaries, market stats, employers — anonymously and read-only.
Create a key under API keys.
Want the full tool set — CV tailoring and your experience bank too? Run the server locally
with npx -y findyet-mcp and pass the key as FINDYET_TOKEN.
{
"mcpServers": {
"findyet": {
"type": "http",
"url": "https://findyet.devjoys.com/api/v1/mcp/account",
"headers": { "Authorization": "Bearer fyk_…" }
}
}
}// for ai agents
Five skills, one per job
Each agent skill is named for the task, not the tool, so a host loads what the question needs instead of the whole surface. Download the skills and unzip them into a Claude Code (or compatible) skills directory.
Every command takes --json for the raw API
payload — results to stdout, errors to stderr, non-zero exit on failure. The same
endpoints are in the API reference.
- /job-search findyet-job-search
- Read the saved profile, ground every filter in facets, search, and shortlist.
- /track-applications findyet-track-applications
- Where each application stands, stage moves, and reporting one that never answered.
- /market-fit findyet-market-fit
- Score a stack against live vacancy demand and put a number on every gap.
- /tailor-cv findyet-tailor-cv
- Reframe a CV toward one vacancy — every claim cited, nothing invented.
- /triage-inbox findyet-mail-triage
- Push a mail batch, judge each message, and drain the two link queues.
Findyet — Find your next job. Apply smarter. The command-line client uses the same account and the same limits as the site.
