[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Particle company search](https://spiral.ai/integrations/opencode/particle-company-search)

# How to Use Particle company search in opencode

Find company records using names or established company identifiers. Use the returned identity to select the right business before requesting its competitors, products, leadership, or external links.

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

## Prompts to try with Particle company search in opencode

- Use Particle company search to resolve NVDA and AAPL, then propose TypeScript types for the returned company identities that fit this project's existing data layer.
- Use Particle company search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Particle company search and tell me what changed since last week.
- Check Particle company search and summarize what you find in three bullet points.
- Pull the newest data from Particle company search and give me the result as a table.

## How to set up Particle company search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

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

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

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

## Particle company search tools and prices

- [Particle · Company directory](https://spiral.ai/tools/alexandria/particle/companies/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Company name, case-insensitive partial match. |
| cik |  | — | SEC CIKs, comma-separated. |
| ids |  | — | Bulk get: comma-separated slugs, domains or ids, up to 100. Other filters and paging are ignored when set. |
| qid |  | — | Wikidata QIDs, comma-separated. |
| limit | 1 to 100 | 25 | Maximum records to return. |
| cursor |  | — | Opaque cursor from a previous page. Omit for the first page; send the same filters with it. |

## What can you do with Particle company search in opencode?

Build a company research view that connects a business to its products, leaders, competitors, and external profiles. Use Particle's company identifiers to keep those views attached to the same business.

### Prepare a company meeting brief

Resolve the business, confirm its external profiles, summarize its product structure, identify its leadership, and review the stated competitive relationships. Use those findings to prepare specific questions for a business meeting.

### Research a potential co-marketing partner

Confirm the company's identity and business profiles, examine its offerings, review its leadership, and inspect its competitors. Use the findings to assess whether a proposed partnership complements or overlaps with your business.

### Build a competitor briefing

Start with the competitive relationships Particle returns. Resolve the businesses involved, examine their products and leadership, and attach their external company links so a reviewer can investigate each comparison.

### Prepare an editorial company backgrounder

Find the correct company, link its business profiles, outline what it sells, identify its leaders, and describe its reported competitors. Use the result as background research for an article or interview.

### Explain a product portfolio

Resolve a company and turn its segment, product line, and product hierarchy into a readable outline. Preserve the parent relationships so readers can see how individual offerings fit into the business.

### Match company records across datasets

Resolve a business and retrieve its external identifiers and links. Use the returned identifiers to compare it with records keyed by domains, SEC CIKs, tickers, or business profile URLs.

## Overview

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

## Particle company search in other agents

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

## More opencode guides

- [Particle company product catalog](https://spiral.ai/integrations/opencode/particle-company-product-catalog)
- [Particle entity details](https://spiral.ai/integrations/opencode/particle-entity-details)
- [Particle company podcast recommendations](https://spiral.ai/integrations/opencode/particle-company-podcast-recommendations)
- [Particle guest recommendations for a podcast](https://spiral.ai/integrations/opencode/particle-guest-recommendations-for-a-podcast)
- [Particle company podcast advertising summary](https://spiral.ai/integrations/opencode/particle-company-podcast-advertising-summary)
- [Particle new podcast episodes](https://spiral.ai/integrations/opencode/particle-new-podcast-episodes)

## Questions about Particle company search in opencode

**Can opencode use Particle company search?**

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

**How much does Particle company search cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use Particle company search in opencode?**

No. Spiral runs Particle 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 Particle company search in opencode?**

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

**Does opencode wait while Particle company search runs?**

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

**Does Particle cover every registered company?**

The unfiltered company directory includes only companies with news coverage. It should not be treated as a complete business registry.

**Can two Particle results have the same company name?**

Yes. Particle explicitly warns that several companies can share a name and recommends checking the domain or description before choosing one.

**Are social profiles available as soon as a company appears?**

Social profiles are discovered separately from the company record. A newly created company may therefore lack social links.

**Can I find a company without knowing its Particle identifier?**

Yes. Particle can resolve a company from its name, stock ticker, SEC CIK, Wikidata QID, or domain.

