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

Claude Code · Lead Gen

How to Use Icypeas company profile in Claude Code

Returns company details from a LinkedIn company-page URL, including description, industry, headcount, headquarters, website, and specialties. Use it to research a known company.

Prompts to try with Icypeas company profile in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use Icypeas company profile for https://www.linkedin.com/company/microsoft/ and map the returned company details into our existing company model.

Icypeas company profileClaude Code
Try asking
  • Use Icypeas company profile to look this up and give me the result as a table. Save the result in ./assets.

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

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

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

How to set up Icypeas company profile in Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude 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.

    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 profile

    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/enrich",
        "input": {
          "url": "<url>"
        }
      }'

Then paste one of the prompts above: Claude Code finds Icypeas company profile on Spiral, shows the price and runs it.

Icypeas company profile providers and prices

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

AlexandriaLead Gen
Icypeas · Company enrichment
icypeas/companies/enrich

What can you do with Icypeas company profile in Claude Code?

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.

Complete company records

Resolve company names or domains to company-page URLs, then add the returned industry, headquarters, website, and headcount to business records.

Prepare company research briefs

Find a company's page from its website and retrieve its profile. Use the description, specialties, and headquarters to prepare a brief before a business meeting.

Questions about Icypeas company profile in Claude Code

Can Claude Code use Icypeas company profile?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Icypeas company profile like any built-in tool.

How much does Icypeas company profile cost in Claude Code?

Up to $0.0069836 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need an Alexandria account to use Icypeas company profile in Claude Code?

No. Spiral runs Icypeas 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 Icypeas company profile in Claude Code?

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

Does Claude Code wait while Icypeas company profile runs?

Icypeas company profile runs in the background. Claude Code 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 profile in Claude Code

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

Paste this into Claude Code:

Set up Claude Code

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