[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [OrbiSearch company profile](https://spiral.ai/integrations/gemini-cli/orbisearch-company-profile)

# How to Use OrbiSearch company profile in Gemini CLI

Fetch a company's description, industry, size range, estimated headcount, headquarters, specialties, and similar companies. Use it to qualify a business, fill gaps in an account record, or find companies worth researching next.

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

## Prompts to try with OrbiSearch company profile in Gemini CLI

- Use OrbiSearch company profile for kearney.com and map the returned industry, headquarters, and founding year into this project's account model.
- Use OrbiSearch company profile for stripe.com and add its description and specialties to our company research fixture.
- Use OrbiSearch company profile for https://www.linkedin.com/company/microsoft and update our account detail view to show the returned size range separately from estimated headcount.
- Use OrbiSearch company profile for salesforce.com and create a reviewable import file containing its company name, website, industry, and company type.
- Use OrbiSearch company profile for kearney.com and populate our research shortlist with the similar company names returned.

## How to set up OrbiSearch company profile 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 OrbiSearch company profile**: 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": "orbisearch/companies/enrich",
    "input": {
      "domain": "<domain>"
    }
  }'
```

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

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

## OrbiSearch company profile tools and prices

- [OrbiSearch · Company enrichment](https://spiral.ai/tools/alexandria/orbisearch/companies/enrich) (Alexandria): $0.005238 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| domain |  | — | Company website domain, such as kearney.com. A full URL is reduced to its domain. |
| linkedin_url |  | — | LinkedIn company or showcase page. Preferred when you have it. Not a numeric company URL. |

## What can you do with OrbiSearch company profile in Gemini CLI?

Fill your project's company records with OrbiSearch descriptions, headquarters, specialties, and size information. A coding agent can map the returned data into your existing schema and keep estimated headcount separate from the self-reported size range.

### Fill gaps in company records

Add industry, headquarters, company type, and founding year to existing business records so account reviews have consistent context.

### Check target-account fit

Compare a company's description, specialties, and size range with your target market before adding it to a research shortlist.

### Find businesses to research next

Start with a known customer or partner and review the returned similar companies as candidates for further research.

### Prepare company briefing notes

Turn a company description, headquarters, founding year, and specialties into a concise briefing before a business meeting.

### Compare potential partners

Build a side-by-side comparison of named businesses using industry, specialties, company type, and estimated headcount.

### Review changes in company profiles

Compare repeated lookups for changes in company descriptions, headquarters, size ranges, and estimated headcount. Use the differences to choose which accounts need another review.

## Overview

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

## OrbiSearch company profile in other agents

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

## More Gemini CLI guides

- [Openmart local business search](https://spiral.ai/integrations/gemini-cli/openmart-local-business-search)
- [OrbiSearch email verification](https://spiral.ai/integrations/gemini-cli/orbisearch-email-verification)
- [Openmart business lookup](https://spiral.ai/integrations/gemini-cli/openmart-business-lookup)
- [OrbiSearch work email finder](https://spiral.ai/integrations/gemini-cli/orbisearch-work-email-finder)
- [Openmart brand search](https://spiral.ai/integrations/gemini-cli/openmart-brand-search)
- [Particle advertiser company profile](https://spiral.ai/integrations/gemini-cli/particle-advertiser-company-profile)

## Questions about OrbiSearch company profile in Gemini CLI

**Can Gemini CLI use OrbiSearch company profile?**

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

**How much does OrbiSearch company profile cost in Gemini CLI?**

$0.005238 per call. 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 OrbiSearch company profile in Gemini CLI?**

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

**How long does it take to set up OrbiSearch company profile in Gemini CLI?**

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

**Does Gemini CLI wait while OrbiSearch company profile runs?**

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

**Is the employee count an exact workforce total?**

No. OrbiSearch describes the employee count as an estimate and the size range as the company's self-reported headcount band. Those are two different measures.

**What business information does OrbiSearch return?**

The record includes a description, industry, company type, size range, headquarters, founding year, and specialties. It also includes website information and a follower count.

**Does company enrichment return an email address?**

It returns the domain used for the company's email. That is a company-level domain, not an individual mailbox.

**Can OrbiSearch return related businesses?**

Yes. Similar companies are included in the company enrichment record, so a known business can provide starting points for further account research.

**What happens when OrbiSearch cannot match a company?**

The result is not_found and the company data fields are null. The documented unmatched response uses empty lists for specialties and similar companies.

