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

# How to Use ZipRecruiter job search in opencode

Returns job cards with employers, locations, pay, employment types, benefits, posting times, and job links. Use it to discover openings across employers before reading individual postings.

|  |  |
| --- | --- |
| Model | ZipRecruiter 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 ZipRecruiter job search in opencode

- Use ZipRecruiter job search for software engineer in Austin, TX. Add a report to this project showing returned titles, employers, locations, posting dates, pay, and job links.
- Use ZipRecruiter job search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ZipRecruiter job search and tell me what changed since last week.
- Check ZipRecruiter job search and summarize what you find in three bullet points.
- Pull the newest data from ZipRecruiter job search and give me the result as a table.

## How to set up ZipRecruiter 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 ZipRecruiter 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": "ziprecruiter-com/jobs/search_jobs",
    "input": {
      "title": "<title>"
    }
  }'
```

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

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

## ZipRecruiter job search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 25 | 1 | 1-based page number; 20 cards per page. Use next_page from the previous call. |
| location |  | — | US city and two-letter state, "City, ST" (e.g. "Austin, TX", "Los Angeles, CA"). Omit for the national title page. |
| min_annual_pay | 1 to 1000000 | — | Annual pay floor in USD (the site's own pay filter, refine_by_salary=), e.g. 150000. The site matches on the pay range it shows for a card, its estimate included; read pay.source to tell stated from estimated pay. |
| posted_within_days | 1 to 30 | — | Only postings from the last N days (the site's own date filter, days=; its UI offers 1, 5, 10 and 30). With this or min_annual_pay set, the call uses ZipRecruiter's interactive search (/jobs-search) instead of the directory page. |

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

Build a local hiring report that connects ZipRecruiter openings, full descriptions, and salary benchmarks. Use title and place suggestions to keep comparisons tied to the intended occupation and US market.

### Prepare a local hiring brief

Resolve the role and city, collect local openings, examine selected employers, and read the full requirements. Put advertised pay beside the title’s salary benchmark to support a hiring discussion.

### Compare employers competing for the same role

Choose consistent title and city wording, find employers advertising the role, and inspect their openings and descriptions. Compare their advertised requirements and pay against the local benchmark.

### Research staffing in two candidate cities

Resolve each city and a common job title, compare salary benchmarks, and sample local postings. Examine relevant employers’ openings and full descriptions to explain differences in the roles being advertised.

### Build a career exploration brief

Turn a partial occupation name and place into a defined search, compare the salary benchmark with advertised roles, and shortlist employers. Read full postings to identify recurring responsibilities and requirements.

## Overview

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

## ZipRecruiter job search in other agents

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

## More opencode guides

- [ZipRecruiter job details](https://spiral.ai/integrations/opencode/ziprecruiter-job-details)
- [ZipRecruiter job title suggestions](https://spiral.ai/integrations/opencode/ziprecruiter-job-title-suggestions)
- [ZipRecruiter company jobs](https://spiral.ai/integrations/opencode/ziprecruiter-company-jobs)
- [ZipRecruiter location suggestions](https://spiral.ai/integrations/opencode/ziprecruiter-location-suggestions)
- [Y Combinator launch posts](https://spiral.ai/integrations/opencode/y-combinator-launch-posts)
- [ZipRecruiter salary benchmarks](https://spiral.ai/integrations/opencode/ziprecruiter-salary-benchmarks)

## Questions about ZipRecruiter job search in opencode

**Can opencode use ZipRecruiter job search?**

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

**How much does ZipRecruiter 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 ZipRecruiter job search in opencode?**

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

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

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

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

**Which geographic market does this ZipRecruiter data cover?**

These endpoints cover ZipRecruiter’s US marketplace. Salary benchmarks cover a US city or the national market.

**How many jobs does a search page contain?**

Job search returns 20 cards per page. Use those cards to discover postings, then read full job details for the descriptions behind them.

**Does appearing in search mean a posting is recent?**

No. Alexandria documents that some ZipRecruiter search cards carry posting dates more than a year old.

**What does the salary benchmark measure?**

It describes yearly base pay for a title and market, with five reported points from the 10th through the 90th percentile. It is separate from a particular employer’s advertised offer.

**Why should I check location suggestions before choosing a city?**

The documented Austin example includes Austin Township in Oklahoma, Austin in Texas and Tennessee, and Austin suburbs. Match the city and state instead of accepting the first result.

