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

# How to Use Workable job search in Hermes

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 Hermes

- Every weekday, use Workable job search to find software engineer roles in London and report postings newly observed since the previous check.
- Every Monday at 9am: use Workable job search to look this up and give me the result as a table.
- 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 Hermes

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

### Use the Spiral skill

1. **Send Hermes 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 Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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: Hermes finds Workable job search on Spiral, shows the price and runs it.

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

## 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 Hermes?

Produce a recurring report of changes in Workable's public employer information and advertised roles. A scheduled agent can compare successive results while allowing for Workable's documented delays in board publication.

### 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 Hermes guides](https://spiral.ai/integrations/hermes)

## 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)
- [Codex](https://spiral.ai/integrations/codex/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)
- [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 Hermes guides

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

## Questions about Workable job search in Hermes

**Can Hermes use Workable job search?**

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

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

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

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

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 Hermes?**

About two minutes: add the server and sign in, then check it.

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

Workable job search runs in the background. Hermes 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.

