[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Workable job search](https://spiral.ai/integrations/codex/workable-job-search)

# How to Use Workable job search in Codex

Find postings across employers on the Jobs by Workable board. Use it to discover hiring companies and roles before researching an employer or reading a posting in full.

|  |  |
| --- | --- |
| Model | Workable job search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.003492 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Workable job search in Codex

- Use Workable job search to find software engineer roles in London and add a table of employers, titles, locations and source links to this project's research page.
- Use Workable job search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Workable job search and tell me what changed since last week.
- Check Workable job search and summarize what you find in three bullet points.
- Pull the newest data from Workable job search and give me the result as a table.

## How to set up Workable job search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Workable job search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "workable/jobs/search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Workable job search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Workable job search tools and prices

- [Workable · Search the Workable job board](https://spiral.ai/tools/alexandria/workable/jobs/search) (Alexandria): $0.003492 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| query |  | — | Keywords matched against title and description. |
| cursor |  | — | next_cursor from the previous page; send the same filters with it. |
| location |  | — | City, region or country as typed on the board. |
| day_range | 1, 7, 30 | — | Only postings from the last 1, 7 or 30 days. |
| workplace |  | — | workplace |
| experience |  | — | experience |

## What can you do with Workable job search in Codex?

Build a searchable employer research view from Workable's public profiles, careers locations and job postings. A coding agent can turn the returned data into project tables and link role summaries to their source descriptions.

### Build an employer research brief

Discover employers advertising relevant roles, review their board profiles, map careers-page departments and locations, and read selected postings. Produce a brief that links each hiring observation to its source.

### Map an employer's advertised hiring footprint

Compare board postings with careers-page locations and departments. Read selected job descriptions for location restrictions before describing where the company is recruiting.

### Audit public careers information

Compare a company's board profile, careers overview, job lists and selected posting text. Flag differences in descriptions, locations and visible roles for the employer to review.

### Prepare a competitor hiring comparison

Compare public hiring by department, location and role requirements across selected companies. Use employer overviews for context and individual postings for evidence about the work being advertised.

### Check remote-job eligibility

Find remote roles, compare advertised locations and read the full descriptions for geographic restrictions. Build a shortlist that distinguishes explicit eligibility from an unexplained remote label.

### Research demand for technical skills

Collect relevant software or engineering postings and extract the technologies and experience employers request. Compare requirements across employers without treating posting counts as confirmed hires.

### Monitor changes in public hiring

Compare repeated observations of employer profiles, careers locations, job lists and selected descriptions. Report newly observed roles and wording changes while accounting for board publication delays.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Workable job search in other agents

- [Amp](https://spiral.ai/integrations/amp/workable-job-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/workable-job-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/workable-job-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/workable-job-search)
- [Cline](https://spiral.ai/integrations/cline/workable-job-search)
- [Cursor](https://spiral.ai/integrations/cursor/workable-job-search)
- [Devin](https://spiral.ai/integrations/devin/workable-job-search)
- [dots](https://spiral.ai/integrations/dots/workable-job-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/workable-job-search)
- [Gemini](https://spiral.ai/integrations/gemini/workable-job-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/workable-job-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/workable-job-search)
- [goose](https://spiral.ai/integrations/goose/workable-job-search)
- [Grok](https://spiral.ai/integrations/grok/workable-job-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/workable-job-search)
- [Hermes](https://spiral.ai/integrations/hermes/workable-job-search)
- [Instinct](https://spiral.ai/integrations/instinct/workable-job-search)
- [Manus](https://spiral.ai/integrations/manus/workable-job-search)
- [Muse](https://spiral.ai/integrations/muse/workable-job-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/workable-job-search)
- [n8n](https://spiral.ai/integrations/n8n/workable-job-search)
- [Notion](https://spiral.ai/integrations/notion/workable-job-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/workable-job-search)
- [opencode](https://spiral.ai/integrations/opencode/workable-job-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/workable-job-search)
- [Raycast](https://spiral.ai/integrations/raycast/workable-job-search)
- [VS Code](https://spiral.ai/integrations/vscode/workable-job-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/workable-job-search)
- [Zapier](https://spiral.ai/integrations/zapier/workable-job-search)

## More Codex guides

- [Workable job board posting details](https://spiral.ai/integrations/codex/workable-job-board-posting-details)
- [Workday job details](https://spiral.ai/integrations/codex/workday-job-details)
- [Workable employer job listings](https://spiral.ai/integrations/codex/workable-employer-job-listings)
- [Workday job search](https://spiral.ai/integrations/codex/workday-job-search)
- [Workable employer job details](https://spiral.ai/integrations/codex/workable-employer-job-details)
- [Y Combinator batch counts](https://spiral.ai/integrations/codex/y-combinator-batch-counts)

## Questions about Workable job search in Codex

**Can Codex use Workable job search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Workable job search like any built-in tool.

**How much does Workable job search cost in Codex?**

$0.003492 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use Workable job search in Codex?**

No. Spiral runs Workable job search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Workable job search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Workable job search runs?**

Workable job search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does Workable show every role an employer is hiring for?**

Public coverage excludes confidential jobs, which Workable hides from both job boards and careers pages. A public listing count therefore cannot establish an employer's total hiring activity.

**Why can the job board and an employer's careers page show different roles?**

Workable lets employers publish roles on their careers page while keeping them off job boards. Check the employer's careers listings when researching a known company.

**How quickly do new jobs appear on job boards?**

Workable says an approved job may take 12 to 36 hours to appear on job boards because each board runs its own review. That is a publication delay, not a documented refresh schedule for these endpoints.

**Does a remote label mean applicants can work from any country?**

Workable asks employers to specify at least a country or a US state when recruiting for remote roles. Employers can also hide remote-job locations on their careers page, so the remote label alone does not establish worldwide eligibility.

**Why might a company's board description be outdated?**

Workable says publishing a job triggers the company-description update on Jobs by Workable. Editing the description alone may therefore leave the board profile unchanged.

