Spiral gives your agent every tool with one account. Browse the tools →

Codex · Lead Gen

How to Use Greenhouse job listings in Codex

Returns a board’s published posts with IDs, titles, locations, dates, and public links. Use it to inventory an employer’s advertised roles before reading individual descriptions.

Prompts to try with Greenhouse job listings in Codex

Copy an example into Codex, or ask in your own words.

Use Greenhouse job listings for Discord and create a CSV of posting IDs, titles, locations, and public links.

Greenhouse job listingsCodex
Try asking
  • Use Greenhouse job listings to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Greenhouse job listings and tell me what changed since last week.

  • Check Greenhouse job listings and summarize what you find in three bullet points.

  • Pull the newest data from Greenhouse job listings and give me the result as a table.

How to set up Greenhouse job listings in Codex

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

Use Spiral's MCP server

  1. Add the hosted server
    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Greenhouse job listings

    One request; the result comes back by polling or a webhook.

    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": "greenhouse-io/jobs/jobs",
        "input": {
          "board_token": "<board_token>"
        }
      }'

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

Greenhouse job listings providers and prices

Spiral runs Greenhouse job listings through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
Greenhouse job boards · Jobs
greenhouse-io/jobs/jobs

Settings you can ask for

Ask Codex for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Page1 to 100001

1-based page over the (filtered) list; pass next_page back here.

Per page1 to 20050

Items per page.

Every API field of Greenhouse job boards · Jobs is on its tool page: open its card above.

What can you do with Greenhouse job listings in Codex?

Build an employer hiring report from Greenhouse’s board information, organizational categories, and published posts. A coding agent can turn the returned data into project files for comparison and review.

Employer hiring brief

Identify the employer, map its departments and offices, inventory advertised posts, and search for priority roles. Read selected descriptions to produce a brief with requirements and public links.

Competitor recruiting comparison

Build comparable employer summaries from board introductions, team structures, office categories, and advertised roles. Search matching disciplines and inspect descriptions before comparing recruiting priorities.

Campus recruiting shortlist

Introduce each employer, review its teams and locations, then search advertised posts for internships and entry-level roles. Check individual descriptions for eligibility requirements before recommending employers to students.

Business opportunity research

Create company briefs for a recruiting agency or training business. Combine employer context, team and office maps, a posting inventory, focused searches, and role requirements to identify relevant service needs.

Role requirements comparison

Find comparable engineering or sales posts at known employers, then compare their published responsibilities and qualifications with links to the original listings.

Questions about Greenhouse job listings in Codex

Can Codex use Greenhouse job listings?

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

How much does Greenhouse job listings cost in Codex?

$0.00873 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 Greenhouse job listings in Codex?

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

How long does it take to set up Greenhouse job listings in Codex?

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

Does Codex wait while Greenhouse job listings runs?

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

Can I search every Greenhouse employer at once?

These lookups work within one employer’s board. The source provides no directory of boards, so a cross-company comparison starts with known employer boards.

Does the number of posts equal the number of jobs?

No. A single Greenhouse job can have multiple posts, so label a board total as advertised posts rather than distinct jobs.

Are departments and offices always a flat list?

Greenhouse supports departments within departments and offices within offices. Preserve that hierarchy when comparing teams or regions.

Why do employers expose different custom fields?

Each employer chooses which custom job fields to expose through the Job Board API. Those exposed fields are publicly visible.

What does the public job data cover?

Greenhouse’s Job Board API covers published jobs together with employer offices and departments. It describes what an employer advertises on that board.

Get started

Start using Greenhouse job listings in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options