[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [PredictLeads company enrichment](https://spiral.ai/integrations/codex/predictleads-company-enrichment)

# How to Use PredictLeads company enrichment in Codex

Retrieve a company's core record, including its name, website description, structured location, ticker, and parent company information where available. Use it to identify the business behind a domain and add context to company research.

|  |  |
| --- | --- |
| Model | PredictLeads company enrichment |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.017459 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with PredictLeads company enrichment in Codex

- Use PredictLeads company enrichment for stripe.com and add its company description and location to our research table.
- Use PredictLeads company enrichment to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from PredictLeads company enrichment and tell me what changed since last week.
- Check PredictLeads company enrichment and summarize what you find in three bullet points.
- Pull the newest data from PredictLeads company enrichment and give me the result as a table.

## How to set up PredictLeads company enrichment 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 PredictLeads company enrichment**: 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": "predictleads/companies/enrich",
    "input": {
      "id_or_domain": "<id_or_domain>"
    }
  }'
```

Then paste one of the prompts above: Codex finds PredictLeads company enrichment on Spiral, shows the price and runs it.

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

## PredictLeads company enrichment tools and prices

- [PredictLeads · Company enrichment](https://spiral.ai/tools/alexandria/predictleads/companies/enrich) (Alexandria): $0.017459 per call.

## What can you do with PredictLeads company enrichment in Codex?

Build a company research table inside an internal tool or repository. A coding agent can turn PredictLeads records into reviewable company comparisons, keeping evidence beside the conclusions drawn from it.

### Build an account research shortlist

Find businesses in a target market, expand the search with lookalikes, and check company identity. Review hiring, news, and technology evidence to give each shortlisted business a specific reason for further research.

### Prepare a competitor briefing

Build a peer list through company discovery and similarity results. Add company context, compare advertised roles and detected technologies, and summarize relevant news with links to the evidence.

### Screen potential integration partners

Find candidate businesses and comparable companies, then check their company records. Use technology evidence, technical hiring descriptions, and company announcements to prepare questions for a partnership discussion.

### Prepare a company comparison for investment research

Find businesses in a sector and identify potential comparables. Assemble company descriptions, hiring priorities, technology evidence, and reported events into a comparison that separates source observations from research conclusions.

### Research demand for a technical service

Compare job descriptions with detected technologies at candidate companies. Use the evidence to identify businesses worth interviewing about migration, implementation, or support needs.

### Expand a competitor watchlist

Start with a known business, review similar companies, and verify the businesses returned. Use their news and hiring descriptions to decide which companies belong on an ongoing research list.

## Overview

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

## PredictLeads company enrichment in other agents

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

## More Codex guides

- [PredictLeads company discovery](https://spiral.ai/integrations/codex/predictleads-company-discovery)
- [PredictLeads company job openings](https://spiral.ai/integrations/codex/predictleads-company-job-openings)
- [People Data Labs person search](https://spiral.ai/integrations/codex/people-data-labs-person-search)
- [PredictLeads company news events](https://spiral.ai/integrations/codex/predictleads-company-news-events)
- [People Data Labs person enrichment](https://spiral.ai/integrations/codex/people-data-labs-person-enrichment)
- [PredictLeads company technology detections](https://spiral.ai/integrations/codex/predictleads-company-technology-detections)

## Questions about PredictLeads company enrichment in Codex

**Can Codex use PredictLeads company enrichment?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run PredictLeads company enrichment like any built-in tool.

**How much does PredictLeads company enrichment cost in Codex?**

$0.017459 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 PredictLeads company enrichment in Codex?**

No. Spiral runs PredictLeads company enrichment on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up PredictLeads company enrichment in Codex?**

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

**Does Codex wait while PredictLeads company enrichment runs?**

PredictLeads company enrichment runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does PredictLeads cover companies outside English-speaking markets?**

PredictLeads describes its coverage as global, with a slight bias toward websites that have an English version.

**How fresh is PredictLeads data?**

PredictLeads says website refreshes range from twice daily to once every two weeks, depending on website activity. That is a collection schedule, so a response should not be read as proof that every underlying page was checked today.

**Can I republish PredictLeads material?**

The published website terms prohibit republishing and selling, renting, or sublicensing its material. Those website terms do not establish redistribution rights for an API dataset; check the applicable data license before publishing records.

**Does one page contain every result?**

PredictLeads paginates responses containing lists of objects. Additional pages can contain more results, so a single page is a partial view.

