jobs_search
Find job postings and check whether a posting is still open. Use it to: find jobs by role and place (query, with location, remote or posted_within_days); read one posting by url and tell whether it is still open; check up to 10 posting urls in one call; list a company's open roles from its own job board (company, a name or domain; add query for one role there); and see who is hiring for a role (query with group_by "employer"). Every row has the same normalized fields: title, company, location, remote, posted_at as the board states it, url, source, a status, and checked_at, the time Firecrawl read it. status is open when the posting was read from the employer's board or live posting page in this call, and unverified when it comes from a job site and was not confirmed on the employer's board. A posting checked by url can also be closed, not_found or error. A single url returns the full description; list rows carry it with include_description. A company search names the boards it read and what each covers; when no board is found, rows come from job sites and notes says so. boards_only searches employers' own boards only. Each provider read is charged its listed price; max_credits caps the call. Example: {"query":"data engineer","location":"Berlin","posted_within_days":14}.
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": {
"objective": "<objective>"
},
"name": "jobs_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | One posting URL to read in full and check: whether it is still open, with its description. | |
| urls | No | Up to 10 posting URLs to check in one call; each comes back with its status. | |
| limit | No | Rows wanted from a search by query or company, 1 to 100, default 10. Leave it out with url or urls. | |
| query | No | Job title or keywords, e.g. "data engineer". With company, the role to look for there. | |
| cursor | No | next_cursor from an earlier call with the same input, for more rows. | |
| remote | No | true returns remote roles only. | |
| company | No | Company name or domain, e.g. "example.com". Lists that company's open roles from its own job board. | |
| group_by | No | "employer" groups the postings found by employer, to see who is hiring for a role. | |
| location | No | City, region or country, e.g. "Berlin" or "Canada". | |
| provider | No | Ask only this provider, e.g. "indeed". Leave it out to let Firecrawl choose. | |
| objective | Yes | The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words. | |
| boards_only | No | true searches employers' own job boards only; every row is confirmed open on its board. | |
| max_credits | No | Most credits the call may spend. Set it only to a budget the user gave; left out, it is 200. A provider that could pass it is not started. | |
| posted_within_days | No | Only postings the board dates within this many days, 1 to 365. | |
| include_description | No | true adds the description to each list row. A single url always returns it. |