[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [SmartRecruiters job search](https://spiral.ai/integrations/opencode/smartrecruiters-job-search)

# How to Use SmartRecruiters job search in opencode

Finds public job postings across SmartRecruiters employers. Use it to discover relevant openings across companies before narrowing your research to an employer.

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

## Prompts to try with SmartRecruiters job search in opencode

- Use SmartRecruiters job search to find engineering postings mentioning Kubernetes and create a table of returned employers, titles, and locations.
- Use SmartRecruiters job search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from SmartRecruiters job search and tell me what changed since last week.
- Check SmartRecruiters job search and summarize what you find in three bullet points.
- Pull the newest data from SmartRecruiters job search and give me the result as a table.

## How to set up SmartRecruiters job search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 SmartRecruiters 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": "smartrecruiters-com/jobs/search_jobs",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## SmartRecruiters job search tools and prices

- [SmartRecruiters · Search jobs](https://spiral.ai/tools/alexandria/smartrecruiters-com/jobs/search_jobs) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| query |  | — | Keywords matched against posting titles and content. |
| company |  | — | SmartRecruiters company identifier: the first path segment of jobs.smartrecruiters.com/<company> (e.g. ServiceNow, BoschGroup). find_companies resolves a name to it. Matched case-insensitively upstream. Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$. |
| location_type | remote, hybrid, onsite | — | Workplace type filter. |

## What can you do with SmartRecruiters job search in opencode?

Build a hiring research table from SmartRecruiters employer identities and public postings. A coding agent can combine employer discovery, job inventories, and selected descriptions with your project's reporting files.

### Prepare an employer hiring brief

Resolve ServiceNow's employer identity, find engineering openings, inventory its advertised roles, and read selected descriptions. Produce a brief organized by location and responsibilities.

### Compare advertised skills across employers

Find engineering postings across employers, resolve the companies selected for comparison, collect their relevant openings, and read the qualifications. Count explicit skill mentions in the collected advertisements.

### Research hiring locations

Discover relevant roles, resolve each employer, and collect company openings by location. Read selected descriptions to explain what work the advertised teams perform in each city.

### Build a focused job shortlist

Search for applications engineering roles, confirm the employers' SmartRecruiters identities, review their other openings, and read each shortlisted advertisement. Compare qualifications and application links.

### Check a role before applying

Find a relevant public opening and read its full responsibilities, qualifications, and additional information. Return a concise role summary with the application link.

## Overview

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

## SmartRecruiters job search in other agents

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

## More opencode guides

- [SmartRecruiters job details](https://spiral.ai/integrations/opencode/smartrecruiters-job-details)
- [Sumble account signal search](https://spiral.ai/integrations/opencode/sumble-account-signal-search)
- [SmartRecruiters company lookup](https://spiral.ai/integrations/opencode/smartrecruiters-company-lookup)
- [Sumble company search](https://spiral.ai/integrations/opencode/sumble-company-search)
- [SmartRecruiters company jobs](https://spiral.ai/integrations/opencode/smartrecruiters-company-jobs)
- [Sumble company signals](https://spiral.ai/integrations/opencode/sumble-company-signals)

## Questions about SmartRecruiters job search in opencode

**Can opencode use SmartRecruiters job search?**

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

**How much does SmartRecruiters job search cost in opencode?**

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

**Do I need an Alexandria account to use SmartRecruiters job search in opencode?**

No. Spiral runs SmartRecruiters 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 SmartRecruiters job search in opencode?**

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

**Does opencode wait while SmartRecruiters job search runs?**

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

**Does SmartRecruiters cover every employer's vacancies?**

Coverage is bounded by jobs published through SmartRecruiters. A vacancy advertised only on another recruiting platform falls outside that published-posting source.

**How fresh are the job descriptions?**

SmartRecruiters describes posting data as snapshots from the last publication. Employers must repost a job for changed content to appear through the Posting API.

**Does a job list contain the complete advertisement?**

SmartRecruiters warns that some fields may be absent from list results. Read the individual posting for the full object before comparing responsibilities or qualifications.

**Can one source response contain all of a large employer's jobs?**

SmartRecruiters' underlying company postings API caps a response at 100 elements. Its pagination uses an offset, a limit, and a total result count.

**What text does a detailed job advertisement contain?**

The documented sections cover company description, job description, qualifications, and additional information. Detailed posting objects also document location and application links.

