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

# How to Use Icypeas professional profile search in Gemini CLI

Returns matching professional records with names, LinkedIn URLs, job information, locations, and employer details. Use it to research a business audience when a count alone is insufficient.

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

## Prompts to try with Icypeas professional profile search in Gemini CLI

- Use Icypeas professional search count and Icypeas professional profile search to compare matching records for Microsoft and Salesforce, then add an aggregate company comparison to this project's research view.
- Use Icypeas professional profile search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Icypeas professional profile search and tell me what changed since last week.
- Check Icypeas professional profile search and summarize what you find in three bullet points.
- Pull the newest data from Icypeas professional profile search and give me the result as a table.

## How to set up Icypeas professional profile 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 Icypeas professional profile 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": "icypeas/people/find",
    "input": {
      "query": {}
    }
  }'
```

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

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

## Icypeas professional profile search tools and prices

- [Icypeas · Find people](https://spiral.ai/tools/alexandria/icypeas/people/find) (Alexandria): Up to $0.139672 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| pagination |  | — | Page token and size. size is 1 to 200. Omit it to receive one person. The token from the previous page is valid for 15 minutes. |

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

Build a company research view that shows matching professional records, profile links, and business email assessments. A coding agent can map Icypeas results into the project's existing business records while keeping URL matches and email certainty distinct.

### Prepare a public business speaker shortlist

Count the relevant professional audience, retrieve business profiles, and locate public executives' profile links. Find missing work addresses, check existing ones, and use published work emails to resolve missing profile links before reviewing invitations.

### Research company partnership contacts

Compare the number of relevant professional records at potential partner companies, then review their business roles. Complete missing profile links and work emails, verify existing addresses, and match published business emails to professional profiles.

### Plan a founder interview series

Size a company-focused interview pool and review professional records for public founders. Locate their professional links, research work email options, check supplied addresses, and reconcile published business emails with profile URLs for an editorial review.

### Review public executive records in a business CRM

Compare database matches with company records and review returned job and employer details. Fill missing professional links or work emails, check existing business addresses, and reconcile published email-to-profile matches before proposing CRM corrections.

### Compare business audience coverage

Compare matching-record counts across target companies or markets, then inspect a sample of professional records to understand what each search actually covers.

## Overview

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

## Icypeas professional profile search in other agents

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

## More Gemini CLI guides

- [Icypeas professional profile URL finder](https://spiral.ai/integrations/gemini-cli/icypeas-professional-profile-url-finder)
- [Icypeas professional search count](https://spiral.ai/integrations/gemini-cli/icypeas-professional-search-count)
- [Icypeas email verification](https://spiral.ai/integrations/gemini-cli/icypeas-email-verification)
- [Icypeas search results](https://spiral.ai/integrations/gemini-cli/icypeas-search-results)
- [Icypeas company search](https://spiral.ai/integrations/gemini-cli/icypeas-company-search)
- [Icypeas work email profile lookup](https://spiral.ai/integrations/gemini-cli/icypeas-work-email-profile-lookup)

## Questions about Icypeas professional profile search in Gemini CLI

**Can Gemini CLI use Icypeas professional profile search?**

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

**How much does Icypeas professional profile search cost in Gemini CLI?**

Up to $0.139672 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 Icypeas professional profile search in Gemini CLI?**

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

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

**Does Gemini CLI wait while Icypeas professional profile search runs?**

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

**Where does Icypeas get its professional information?**

Icypeas identifies company websites, public professional profiles, LinkedIn, directories, publications, and third-party data providers, including Avanteer, as sources. It also generates or verifies business email information through domain patterns and technical checks.

**How fresh are Icypeas email checks?**

Icypeas says it checks emails live with the company's mail server. That statement concerns email checks; it does not establish a refresh schedule for professional database records.

**How accurate are Icypeas email results?**

Icypeas estimates a bounce rate below 1% for its two highest certainty levels and below 5% for probable results. These estimates describe email results, not the accuracy of every job title or employer record.

**Does a missing result mean an address or profile does not exist?**

Icypeas distinguishes a failed email search from an inconclusive verification: a verification result of not_found can mean the mail server accepts everything. Profile URL searches also return an empty result when Icypeas cannot find a match.

**How long does Icypeas retain API search records?**

Its personal information notice specifies six months after completion for API and individual web application searches. That is a search-record retention period, not a guarantee of six months of historical profile snapshots.

