Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Lead Gen

How to Use Particle company search in Gemini CLI

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.

Prompts to try with Particle company search in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

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.

Particle company searchGemini CLI
Try asking
  • 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 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    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.

    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: Gemini CLI finds Particle company search on Spiral, shows the price and runs it.

Particle company search providers and prices

Spiral runs Particle company search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
Particle · Company directory
particle/companies/search

Settings you can ask for

Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Limit1 to 10025

Maximum records to return.

Every API field of Particle · Company directory is on its tool page: open its card above.

What can you do with Particle company search in Gemini CLI?

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.

Questions about Particle company search in Gemini CLI

Can Gemini CLI use Particle company search?

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

How much does Particle company search cost in Gemini CLI?

$0.00873 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 Particle company search in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while Particle company search runs?

Particle company search runs in the background. Gemini CLI 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.

Get started

Start using Particle company search in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options