// 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.

terminal
# 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.

~/.claude.json
{
  "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.

Tailor your CV for this role?

We couldn't check your fit for this role — add a CV to your profile to see it next time.