Skip to main content
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

Every component reads 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, with query in place of q. Each include filter has an exclude_ 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_size defaults to 5. The tool never requests more than max_page_size (default 25, at most 100), whatever the model asks for.
  • Called with a ToolCall, the tool returns a ToolMessage whose artifact holds 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_jobs is required and has no default, because the feed streams every matching job and bills each one that is new to you. Pass max_jobs=None to opt in to reading the whole feed.
  • max_jobs is an upper bound. The loader reads whole, equal batches that fit under it, so max_jobs=2500 loads 2,499 jobs in three batches of 833.
  • Persist loader.last_cursor and pass it back as cursor= 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.