go_job
Job search, resume optimization, career research, and application tracking — a Go MCP server exposing 28 tools across LinkedIn, Greenhouse, Lever, YC, HN, Indeed, Хабр, RemoteOK, WeWorkRemotely, Twitter/X, Google Jobs, and more.
MCP Tools
Search
Resume
Research
Interview & Career Prep
Application Workflow
Tracker & Utilities
Filters (job_search)
Architecture
go_job/
├── main.go
├── internal/
│ ├── engine/
│ │ ├── config.go # Config struct + Init()
│ │ ├── bridge.go # Source bridge wiring
│ │ ├── bridge_jobs.go # Job-specific bridge helpers
│ │ ├── bridge_llm.go # LLM bridge
│ │ ├── cache.go # 2-tier cache: L1 in-memory + L2 Redis
│ │ ├── search.go # SearchSearXNG, DedupByDomain
│ │ ├── metrics.go # Prometheus counters/histograms
│ │ ├── pipeline.go # Fan-out pipeline helpers
│ │ ├── types_jobs.go # Input/output types
│ │ ├── prompt.go # LLM instructions (shared)
│ │ ├── prompt_jobs.go # Job-specific LLM prompts
│ │ └── jobs/ # Job source + career tool implementations
│ │ ├── linkedin.go # LinkedIn Guest API + JSON-LD + geo_id + pagination
│ │ ├── indeed.go # Indeed iOS GraphQL API + SearXNG fallback
│ │ ├── remotejobs.go # RemoteOK + WeWorkRemotely + Remotive APIs
│ │ ├── habr.go # Habr Карьера scraper
│ │ ├── hnjobs.go # HN Who is Hiring (Algolia)
│ │ ├── ycjobs.go # YC workatastartup.com
│ │ ├── ats.go # Greenhouse + Lever + Ashby ATSes
│ │ ├── match.go # Jaccard keyword scoring (job_match_score)
│ │ ├── resume.go # resume_analyze, cover_letter_generate, resume_tailor
│ │ ├── research.go # research tool (salary / company / person)
│ │ ├── tracker.go # Job application tracker (SQLite)
│ │ ├── profile.go # User profile persistence
│ │ └── ... # algora, twitter, linkedin, bounty, opportunity, etc.
│ │ └── sources/ # Pluggable source connectors
│ │ ├── freelancer.go # Freelancer.com REST API
│ │ ├── github.go # GitHub jobs / PRs
│ │ ├── hackernews.go # HN source
│ │ └── ...
│ ├── jobserver/
│ │ ├── register.go # Tool registrations (28 MCP tools)
│ │ └── tool_*.go # Per-tool handler files
│ └── hunt/ # Hunt store + notifications
│ ├── notify/
│ │ └── telegram.go # Telegram notifications via go-kit ProductSink
│ └── ...
└── deploy/
└── go_job.service # systemd unit (MCP :8891, metrics :9891)
Key Implementation Details
job_search
- Unified platform:
remote_work_searchandfreelance_searchandtwitter_job_searchare folded intojob_searchviaplatform=remoteok|weworkremotely|remotive|twitter. Useraw=truewithplatform=twitterto skip LLM processing. - LinkedIn: no auth, Chrome TLS fingerprint via
bogdanfinn/tls-client; pagination withoffset; 42 geo locations. - Google Jobs:
platform=googlevia SearXNG. - UN sources:
platform=inspira(careers.un.org) /platform=undp/platform=un(fan-out both). Not included inplatform=all.
research tool
- Replaces three separate tools (
salary_research,company_research,person_research). subject=salary(role required),subject=company(company required),subject=person(name required).
job_tracker
- Single tool replaces
job_tracker_add,job_tracker_list,job_tracker_update. action=add(title+company required),action=list,action=update(id required).
Data Storage
- Job tracker DB:
$UPLOADS_ROOT/go-job/tracker/tracker.db(SQLite, tablejobs). Default path:$HOME/uploads/go-job/tracker/tracker.db. Override viaUPLOADS_ROOT. - User profile:
$UPLOADS_ROOT/go-job/profile/profile.json. Default:$HOME/uploads/go-job/profile/profile.json. - L1 cache: in-memory (
sync.Map), lost on restart. - L2 cache: Redis (optional), persistent.
Notifications
- New hunt entries trigger Telegram notifications via
internal/hunt/notify/telegram.gousing go-kitProductSink(own bot, rate-limited fan-out). - Requires
TELEGRAM_BOT_TOKEN+HUNT_NOTIFY_CHAT_IDenv vars.
Running
# HTTP mode (default MCP port 8891, metrics port 9891)
MCP_PORT=8891 PROM_PORT=9891 LLM_API_KEY=... ./bin/go_job
# stdio mode
./bin/go_job --stdio
Build & Deploy
make build # → bin/go_job
make deploy # build + copy service + restart systemd unit
make restart # restart only
Config (env vars)
Health check
curl http://localhost:8891/health
# {"status":"ok","service":"go_job","version":"v1.21.0"}
#
# `version` is `git describe --tags` taken at build time — the release tag that
# release-please cut, never a number maintained by hand here. A build that
# cannot reach git reports "dev".
Metrics
curl http://localhost:9891/metrics
Spillover store
Large MCP responses can exceed the MCP envelope limit (~25KB). go-job spills oversized payloads to a Postgres table oversize_responses (auto-migrated on startup).
When a tool response exceeds GO_JOB_OVERSIZE_THRESHOLD_BYTES (default 24576), the client receives a small envelope with oversize_id and a sample. Use the oversize tool to retrieve the full payload.
Requires DATABASE_URL. Gracefully falls back to direct response if unset.