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

Gemini CLI · Lead Gen

How to Use Icypeas company search in Gemini CLI

Returns matching company records from the Icypeas database, including names, websites, industries, locations, and employee counts. Use it to build a company shortlist from search criteria.

Prompts to try with Icypeas company search in Gemini CLI

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

Use Icypeas company search to retrieve 20 software companies headquartered in Paris, France, and create a company table in this project.

Icypeas company searchGemini CLI
Try asking
  • Use Icypeas company search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Icypeas company search and tell me what changed since last week.

  • Check Icypeas company search and summarize what you find in three bullet points.

  • Pull the newest data from Icypeas company search and give me the result as a table.

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

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

Icypeas company search providers and prices

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

AlexandriaLead Gen
Icypeas · Find companies
icypeas/companies/find

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

Build a company research feature that turns Icypeas results into searchable business records. A coding agent can connect counts, company pages, profile details, and shared inboxes to the project's existing company model.

Build a reseller recruitment shortlist

Count a target company segment, retrieve candidates, resolve missing company-page URLs, and review their profiles. Find shared business inboxes for companies selected for a reseller discussion.

Research potential suppliers

Size the supplier segment and retrieve matching businesses. Resolve company pages, compare profile details, and find shared inboxes for requesting product information.

Plan a business event invitation list

Count companies in the intended audience and retrieve a shortlist. Review their company pages and specialties, then identify shared business addresses for an event inquiry.

Find co-marketing partners

Compare the size of potential partner segments, retrieve candidates, resolve their company pages, and review their descriptions. Find shared inboxes for proposing a joint webinar or business collaboration.

Compare market segments

Compare database match counts across company segments, then retrieve company records to inspect the businesses behind each count.

Questions about Icypeas company search in Gemini CLI

Can Gemini CLI use Icypeas company search?

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

How much does Icypeas company search cost in Gemini CLI?

Up to $0.17459 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 company search in Gemini CLI?

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

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

Does Gemini CLI wait while Icypeas company search runs?

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

Does an Icypeas company count represent every business in a market?

It counts companies matching a query in the Icypeas database. Use it as a database segment count, rather than a census of registered businesses.

Where does the company profile information come from?

Icypeas accepts a LinkedIn company-page URL and returns structured company details, including industry, headcount, headquarters, website, and specialties.

What kind of email addresses does Icypeas domain search find?

It targets shared role addresses such as contact@, sales@, and admin@. That makes it useful for reaching a business inbox without selecting an individual employee.

How long can I pause between company search pages?

Each lead database pagination token is valid for 15 minutes. Every returned page supplies a new token, so use the latest token for the next page.

Should I search with a company name or its website?

Icypeas recommends the website domain when you have it. Its documentation specifically says icypeas.com is more precise than Icypeas, although both work.

Get started

Start using Icypeas 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