[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [LeadOcean company search](https://spiral.ai/integrations/muse-code/leadocean-company-search)

# How to Use LeadOcean company search in Muse Code

Returns company records matching a business search, including firmographics and available website technology data. Use it to discover companies when you have a name or business description rather than a confirmed domain.

|  |  |
| --- | --- |
| Model | LeadOcean company 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 company search in Muse Code

- Use LeadOcean company search for businesses matching cybersecurity. Add a review table showing the returned company names, domains and descriptions.
- Use LeadOcean company search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from LeadOcean company search and tell me what changed since last week.
- Check LeadOcean company search and summarize what you find in three bullet points.
- Pull the newest data from LeadOcean company search and give me the result as a table.

## How to set up LeadOcean company search in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code 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 company 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/companies/search",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds LeadOcean company search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## LeadOcean company search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free text over the company name and description. |
| sic |  | — | SIC codes. |
| name |  | — | Company name phrase. Wrap a value in [brackets] for an exact name. |
| slim |  | — | Drop the technology list, tags, specialties, financials, and empty fields. Default false. |
| count |  | — | Also return meta.total. Company search already counts the total on the first page. With limit 1 and count true, the call is a free sizing request. |
| 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 company search in Muse Code?

Build a company research table with LeadOcean firmographics, market breakdowns or aggregate staff-role summaries. A coding agent can turn the returned data into project fixtures, comparison views and internal account reports.

### Research potential business partners

Count software companies in a target state, search for relevant businesses, and inspect company details. Summarize the business roles represented in LeadOcean's staff records to prepare a partnership research brief.

### Assess a regional business market

Compare company counts across headquarters states, inspect matching businesses, and review their firmographics. Add an aggregate summary of represented staff roles at selected companies to describe the organizations in the sample.

### Prepare an event sponsor shortlist

Size a relevant industry segment, discover candidate businesses, and review company details for sponsor fit. Summarize represented business functions at shortlisted companies for the event planning brief.

### Build a competitor landscape

Count companies matching a business description, inspect search results, and compare individual company records. Use aggregate role summaries from company staff records as additional organizational context.

### Complete business account records

Resolve company names to candidate domains, then retrieve company details to add industry, headquarters and headcount information to an internal account table.

### Check a market definition against real companies

Count a proposed business segment and inspect matching company records. Use the count breakdowns and company descriptions to judge whether the query captures the intended market.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## LeadOcean company search in other agents

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

## More Muse Code guides

- [LeadOcean company people](https://spiral.ai/integrations/muse-code/leadocean-company-people)
- [LeadOcean professional profile](https://spiral.ai/integrations/muse-code/leadocean-professional-profile)
- [LeadOcean company details](https://spiral.ai/integrations/muse-code/leadocean-company-details)
- [LeadOcean professional search](https://spiral.ai/integrations/muse-code/leadocean-professional-search)
- [LeadOcean company count](https://spiral.ai/integrations/muse-code/leadocean-company-count)
- [LeadOcean reverse contact lookup](https://spiral.ai/integrations/muse-code/leadocean-reverse-contact-lookup)

## Questions about LeadOcean company search in Muse Code

**Can Muse Code use LeadOcean company search?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run LeadOcean company search like any built-in tool.

**How much does LeadOcean company search cost in Muse Code?**

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 Muse Code plan is separate.

**Do I need an Alexandria account to use LeadOcean company search in Muse Code?**

No. Spiral runs LeadOcean company 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 company search in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while LeadOcean company search runs?**

LeadOcean company search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**How many companies does LeadOcean cover?**

LeadOcean reports 73,728,117 companies in its search index as of November 13, 2026. That is the indexed company population, not a claim that every business is included.

**Where does LeadOcean's data come from?**

LeadOcean names three sources: publicly accessible professional information on the web, its own collection and verification, and licensed data partners. Its privacy policy describes the database as business-context information.

**What does a company record contain?**

Company details include industry, headcount, headquarters, revenue, funding and detected website technologies where available. Company search returns matching company records, while company count returns totals and breakdowns without company rows.

**Does LeadOcean provide a complete employee directory?**

The company people endpoint lists the people LeadOcean holds at a domain. It returns thin professional records without contact points, so the result should be described as LeadOcean's represented staff data.

**How detailed are the company count breakdowns?**

Company count provides five breakdowns: industry, headcount band, headquarters country, headquarters state and primary NAICS code. Each breakdown contains its top 20 entries.

