langchain-jobo is a LangChain integration package for the Jobo API. It depends on langchain-core, httpx, and pydantic only, and needs Python 3.10 or later.
The package is built and tested but not on PyPI yet, so
pip install langchain-jobo does not resolve today.
For what all connectors share, see the connectors overview.
Install and authenticate
JOBO_API_KEY, or takes api_key=.... The key is held as a SecretStr and is only written into the X-Api-Key header.
A sandbox key works with the search tool, the details tool, and the retriever. JoboFeedLoader needs a live key.
Agent
handle_tool_error=True hands an API error, such as a rate limit or an empty wallet, back to the model as the tool’s answer. Without it the tool raises a ToolException and the run stops.
Search tool
- The arguments are the filters of
POST /api/jobs/search, withqueryin place ofq. Each include filter has anexclude_twin where the API has one. - Enum filters take the API’s lowercase values. An unknown value is rejected before any request, because the API answers it with zero results rather than an error.
page_sizedefaults to 5. The tool never requests more thanmax_page_size(default 25, at most 100), whatever the model asks for.- Called with a
ToolCall, the tool returns aToolMessagewhoseartifactholds the raw jobs, paging, warnings, and the usage the API reported.
Retriever
page_content is self-contained prose. metadata carries the id, URLs, title, company, location, salary, and dates; a key is present only when the posting has the value. Each query bills up to k jobs.
Feed loader
max_jobsis required and has no default, because the feed streams every matching job and bills each one that is new to you. Passmax_jobs=Noneto opt in to reading the whole feed.max_jobsis an upper bound. The loader reads whole, equal batches that fit under it, somax_jobs=2500loads 2,499 jobs in three batches of 833.- Persist
loader.last_cursorand pass it back ascursor=to resume. A cursor keeps the filters of the scan it came from. - The filters are the feed’s own, not the search tool’s: see
POST /api/jobs/feed.
Cost
Search bills every job a response returns; the feed bills a job once per 30 days; job and company lookups are free (cost model).402 is never retried.
An agent that searches in a loop spends per job returned on every call. Keep max_page_size low and say in the prompt when to stop searching.
Related: MCP server
For an assistant or coding agent you don’t write yourself, the MCP server exposes the same search without any code.

