Read a job posting link
read_job_linkRead a link to a job posting into its title, company, location and full text. Spends no analysis. Postings on Greenhouse, Lever, Ashby, SmartRecruiters, Workday, Workable and Recruitee are read through the board's public API, which also says whether the posting is still open; other links come from a copy a radar already saved (source=pool; open_confirmed_at null means nobody confirmed it is still open) or from the page through the job posting it declares or its main text; partial=true means only a board's short summary could be had. The text goes to analyze_vacancy as description, with title, company, location and url; existing_analysis_id means this user already analyzed the link and get_vacancy_detail shows that analysis. A link that gives no posting comes back with unavailable set to the reason: posting_closed, blocked, unreadable, or login_required (LinkedIn and Glassdoor pages are not read). Errors: rate_limited (20 links an hour, 10 a day on the free plan, 60 on a paid one; a link the user already analyzed is not counted), invalid_payload.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"input": "<input>"
},
"name": "read_job_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The link, cleaned of tracking parameters. | |
| title | No | The posting's title as the page or the job board names it. | |
| source | No | Where the text came from: ats = the job board's public API, read now; page = the page itself, read now; pool = a copy a radar saved when it found the posting, used where the board has no public API or it did not answer. | |
| company | No | The employer, when the posting names one. | |
| partial | No | True when the text is only a board's short summary: the page itself gave nothing longer. | |
| location | No | Where the job is, as the posting says it. | |
| captured_at | No | When the text was taken from its source (UTC, ISO 8601): for pool, when a radar found the posting; for ats and page, when it was read, up to a day ago for a link read recently. | |
| description | No | The posting's full text, up to 20 000 characters. | |
| unavailable | No | Why the link gave no posting; null when it was read. posting_closed = the site answered that the page does not exist (404/410) or the board lists the posting as closed: the job was filled, moved or never existed, and these cases look the same; blocked = the site refused to show the page to a reader; login_required = the site shows its postings only to signed-in visitors; unreadable = the page did not answer or holds no readable posting. In the last three cases the posting text has to be pasted. When set, the posting text is empty and url is the link as given; nothing was spent. title and existing_analysis_id still name this user's analysis of the link when there is one. | |
| open_confirmed_at | No | When the job board last answered that the posting is open (UTC, ISO 8601): for ats, when its API served it; for pool, the radar's nightly check of a kept match. Null means openness is not confirmed, not that the posting is open: a page and most pool copies are never checked, and the posting may have closed since captured_at. | |
| existing_analysis_id | No | This user's analysis of the same link, when there is one; get_vacancy_detail shows it. |