Read an employer's board
read_boardRead one employer's live job board when search_jobs finds nothing, returning postings, apply links, and dates. Use for employers outside this index on supported ATS vendors.
Instructions
Read one employer's public job board live, whether or not the employer is in this index.
Use it when the user names an employer this index does not carry (search_jobs returned the empty-result object, or the employer is outside AI infra, autonomous driving and embodied AI) and has, or can find on the employer's careers page, a board URL on a vendor this index knows how to read: Greenhouse (job-boards.greenhouse.io/), Lever (jobs.lever.co/), Ashby (jobs.ashbyhq.com/), Moka (app.mokahr.com/apply//), 北森 (.zhiye.com), Workable (apply.workable.com/), SmartRecruiters (jobs.smartrecruiters.com/) or Workday (.wd5.myworkdayjobs.com/). Any sector. To keep the employer, add_employer puts the same board into the user's own index.
What you get: the board's own postings with title, location, the board's own posting
date and days_open where it reports one (date_signal: not_reported_by_ats otherwise),
a direct apply link on the employer's own tenant, and a description excerpt. What you
do not get: skills, ghost_score, relist history or watches, which need repeated
observation; and nothing is stored. If the employer turns out to be in the index the
result says so and search_jobs is the richer source.
Refused with ERR_UNSUPPORTED_BOARD, with the reason: a Feishu Hire / Lark portal (request signatures, an access control this index never bypasses), SuccessFactors, Taleo, iCIMS, LinkedIn, JobsDB or BOSS直聘. Tell the user to open that page themselves; never look for another way in.
Politeness: one live read per board per 15 minutes per server process (a repeat within
that window is answered from memory, from_cache: true), with the same request headers
as the weekly crawl. A board that does not answer is reported as such, never as a fact
about the employer.
Privacy: sends only the board's tenant to the vendor's public endpoint. Nothing about the user is sent anywhere, and nothing read is stored.
Args:
url: the careers or board URL as the user pasted it.
location: only postings whose location text contains this, in either language
(香港 = Hong Kong = HK, 广州 reaches 天河区).
title: words in the job title, any match ("hr" reaches HR, HRBP, recruiter, talent
acquisition); the filter for roles no skill tag names.
limit / offset: page through total_matching (newest posting date first, undated last).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| limit | No | ||
| title | No | ||
| offset | No | ||
| location | No |