[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [LeadOcean professional search](https://spiral.ai/integrations/gemini-cli/leadocean-professional-search)

# How to Use LeadOcean professional search in Gemini CLI

Returns professional records with names, headlines, current roles, employers, locations and contact availability flags. Use it to find relevant business roles at target companies before requesting individual profiles or contact details.

|  |  |
| --- | --- |
| Model | LeadOcean professional search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with LeadOcean professional search in Gemini CLI

- Use LeadOcean professional search to retrieve up to five public executive records at microsoft.com. Add their names, titles, employers and reported locations to the project's company research page.
- Use LeadOcean professional search to retrieve up to five public leadership records at salesforce.com with chief executive titles. Create a table in the project showing the returned names, titles and employers.
- Use LeadOcean professional search to retrieve up to five public executive records at adobe.com. Update the project's research view to show headline, current role and company.
- Use LeadOcean professional search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from LeadOcean professional search and tell me what changed since last week.

## How to set up LeadOcean professional search in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 LeadOcean professional 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": "leadocean/people/search",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds LeadOcean professional search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## LeadOcean professional search tools and prices

- [LeadOcean · People search](https://spiral.ai/tools/alexandria/leadocean/people/search) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free text over the person's name, title, headline, summary, skills, job descriptions, and company name. |
| sic |  | — | SIC codes of the employer. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
| city |  | — | City keywords for the person. |
| slim |  | — | Drop empty and heavy parts of each record. Default false. |
| count |  | — | Also return meta.total. With limit 1 this is a free sizing call: data is empty and meta.countOnly is true. A larger limit is a paid page plus the total. |
| limit | 1 to 10 | 1 | Rows to return, from 1 to 10. LeadOcean allows up to 100; this cap keeps a page within 100 Firecrawl credits. Each returned row costs 10 credits. An empty page costs nothing. Omitting it sends 1. |

## What can you do with LeadOcean professional search in Gemini CLI?

Build a company research view that shows public leaders' reported titles, employers and available career histories. Map current positions separately from past roles so the interface keeps those two contexts clear.

### Prepare a business meeting brief

Find public executives at a target company and summarize their reported roles and employers. Add available career history for the leaders attending the meeting.

### Research potential business partners

Identify public partnership leaders at companies such as Microsoft or Salesforce. Use their reported titles and professional backgrounds to prepare questions for a partnership discussion.

### Prepare conference speaker research

Find public business leaders with relevant role titles, then summarize available career history and skills for an event team's speaker research.

### Build a public executive research brief

Collect reported titles, employers and available career histories for public executives. Organize the results into background notes for business reporting.

### Compare leadership roles across companies

Compare the returned titles and employers of public leaders at selected businesses. Use detailed profiles to explain the professional experience behind those roles.

### Add context to company research

Supplement a company research brief with its public leadership's reported roles, locations and professional backgrounds. Keep current positions separate from past roles.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## LeadOcean professional search in other agents

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

## More Gemini CLI guides

- [LeadOcean professional profile](https://spiral.ai/integrations/gemini-cli/leadocean-professional-profile)
- [LeadOcean reverse contact lookup](https://spiral.ai/integrations/gemini-cli/leadocean-reverse-contact-lookup)
- [LeadOcean company search](https://spiral.ai/integrations/gemini-cli/leadocean-company-search)
- [LeadOcean work email](https://spiral.ai/integrations/gemini-cli/leadocean-work-email)
- [LeadOcean company people](https://spiral.ai/integrations/gemini-cli/leadocean-company-people)
- [Leadsforge business contact search](https://spiral.ai/integrations/gemini-cli/leadsforge-business-contact-search)

## Questions about LeadOcean professional search in Gemini CLI

**Can Gemini CLI use LeadOcean professional search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run LeadOcean professional search like any built-in tool.

**How much does LeadOcean professional search cost in Gemini CLI?**

Up to $0.034918 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use LeadOcean professional search in Gemini CLI?**

No. Spiral runs LeadOcean professional 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 LeadOcean professional search in Gemini CLI?**

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

**Does Gemini CLI wait while LeadOcean professional search runs?**

LeadOcean professional search runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does LeadOcean have contact details for every profile?**

No. Its November 13, 2026 figures list 996 million people, but only 424 million with an email and 190 million with a phone.

**Where does LeadOcean get its data?**

LeadOcean says it combines more than 20 licensed and proprietary sources into one schema.

**How fresh are LeadOcean records?**

Its privacy policy says records are refreshed continuously and removed when a source no longer supports them. That describes the database's maintenance process, rather than a fixed update interval for each profile.

**Does an email verification date show exactly when that address was checked?**

No. LeadOcean assigns one date to an entire verification batch, so it is not an individual address's verification timestamp.

**How complete is the career history?**

LeadOcean includes past roles, education, certifications and awards when held. Past employers lack company identifiers, so historical company matches must use names.

