Agent skill, intermediate

Build a company list, as a skill your agent installs.

Company list builder API for an agent: it sends filters such as industry, size, country, funding stage, revenue or technology to a catalog endpoint and reads company name, domain and industry back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

Give this to your agent
set up looot - https://looot.ai/skill.md

Install

How do I install this skill?

Two steps. Set up looot once, then save this skill file where your agent reads skills.

1. Set up looot once

Give this line to your agent
set up looot - https://looot.ai/skill.md

Works in Claude Code, Cursor, Codex and ChatGPT through MCP. Searching and inspecting are free.

2. Save the skill

Save the skill file for Claude Code
mkdir -p ~/.claude/agent-skills/looot-company-list-builder && curl -fsSL https://looot.ai/agent-skills/company-list-builder/SKILL.md -o ~/.claude/agent-skills/looot-company-list-builder/SKILL.md

Or open the raw SKILL.md and drop it into the skills folder of your own agent.

When it starts

What do I say to start this skill?

Any of these starts it. The agent asks for what is missing, nothing more.

  • Example prompt
    find software companies in the US with 50 to 200 employees

  • Example prompt
    build a list of companies that use Stripe

  • Example prompt
    give me 100 fintech companies in Germany

It asks for

  • Industry, size, country or technology filters, as many as the user has
  • How many companies to return

It hands back

  • Company name and domain
  • Industry and country
  • Employee count
  • Funding stage and revenue range when the provider has them
  • Matching technologies and jobs
  • LinkedIn page

Return a table of name, domain, country and employee count, and say how many matched in total.

How it runs

What does the agent do when it runs?

Four moves, in this order, with the price known before any money moves.

  1. Step 1

    Discover

    looot discover finds the endpoints that match the task. It is free.

  2. Step 2

    Inspect

    looot inspect shows the price and the exact input before anything is spent. It is free.

  3. Step 3

    Run

    looot run executes the call with an idempotency key, so a retry never charges twice. The agent reads the run status, not the HTTP code.

  4. Step 4

    Fall back

    On a provider error or a timeout the agent tries the next endpoint in the skill, cheapest first. It never retries a bad input elsewhere.

Providers, cheapest first

What actually differs between providers

Today the price runs from $0.0019 to $0.0981 across 5 endpoints. The dearest costs about 52 times the cheapest. Price is only one difference. Each entry below says what that endpoint takes or returns that the others do not.

  1. The Companies API logoThe Companies API

    Runs a segmentation search with a query, a page and a size, and bills per company returned.

    thecompaniesapi-companies-post
    $0.0019 / result
  2. FullEnrich logoFullEnrich

    Filters by name, domain, industry, headquarters, headcount, keywords or founding year, and bills per company returned.

    fullenrich-api-company-search
    $0.0160 / result
  3. People Data Labs logoPeople Data Labs

    Filters by industry, country, region, city, employee count, founding year, funding stage, total funding and inferred revenue, bills per company returned, and also takes a SQL WHERE clause directly.

    people-data-labs-company-search-get
    $0.0300 / result
  4. Aviato logoAviato

    Takes a query in the Aviato query language with a filters array and returns a count plus the matching companies.

    aviato-company-search
    $0.0500 / call
  5. TheirStack logoTheirStack

    Filters by industry, country, employee count, revenue, funding, technology stack and hiring signals, with 1 to 25 results per page.

    theirstack-companies-search
    $0.0981 / result

Cost

What 100 runs of this skill cost

$0.1900

100 searches cost about $0.1900 through the cheapest endpoint, at The Companies API, and about $9.81 through the dearest. Each run is one call. The cheapest endpoint bills per result, so the figure assumes one result per run.

The file

What is inside the SKILL.md?

The whole file, as your agent reads it. No price is written in it: the agent reads the live price with looot inspect.

SKILL.md for Build a company list
---
name: looot-company-list-builder
description: Build a company list. Use when the user says things like "find software companies in the US with 50 to 200 employees", "build a list of companies that use Stripe" or "give me 100 fintech companies in Germany". Runs through looot, billed per call.
---

# Build a company list

Company list builder API for an agent: it sends filters such as industry, size, country, funding stage, revenue or technology to a catalog endpoint and reads company name, domain and industry back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

This skill needs the looot skill set up first: https://looot.ai/skill.md

## Ask for these inputs

The job takes filters such as industry, size, country, funding stage, revenue or technology. Example: software companies in the US with 50 to 200 employees that use Stripe.

- Industry, size, country or technology filters, as many as the user has
- How many companies to return

## Run it

1. Find the endpoint: `looot discover --mode auto --query "company list builder"`. The endpoints listed below are the known matches.
2. Read the price and the input schema before spending: `looot inspect <endpoint-id>`. Tell the user the price, then run.
3. Run it: `looot run theirstack-companies-search --input '{"limit":10,"company_country_code_or":["US"]}' --idempotency-key <new-key> --wait`. Reuse the same key only to retry the same request.
4. Read the run's `status` and `error`, not the HTTP status. A run can return `failed` with a normal response.
5. If a run fails with a provider error or times out, try the next endpoint from the list below, cheapest first. If it fails on your input (a 4xx style error), fix the input. Do not retry it on other providers.

## Endpoints

Each endpoint reads the same job from a different provider. They differ in inputs, fields and price. Run `looot inspect` on the ones that take the input you hold, start with the cheapest, and move to the next on a provider error.

- `theirstack-companies-search`: filters by industry, country, employee count, revenue, funding, technology stack and hiring signals, with 1 to 25 results per page
- `fullenrich-api-company-search`: filters by name, domain, industry, headquarters, headcount, keywords or founding year, and bills per company returned
- `thecompaniesapi-companies-post`: runs a segmentation search with a query, a page and a size, and bills per company returned
- `people-data-labs-company-search-get`: filters by industry, country, region, city, employee count, founding year, funding stage, total funding and inferred revenue, bills per company returned, and also takes a SQL WHERE clause directly
- `aviato-company-search`: takes a query in the Aviato query language with a filters array and returns a count plus the matching companies

## What comes back

- Company name and domain
- Industry and country
- Employee count
- Funding stage and revenue range when the provider has them
- Matching technologies and jobs
- LinkedIn page

## Answer rule

Return a table of name, domain, country and employee count, and say how many matched in total.

## Before you start

- Start narrow. Each company returned is billed, so a query that returns thousands costs real money. Set a limit and widen it once the sample looks right.
- Check the filter names on the endpoint page. They differ per provider, and a misspelled filter returns everything or nothing.
- Send each filter as its own field, not one sentence: industry, country, employees (such as 50-200), funding_stage (such as series_a) and revenue (a range such as 10M-25M). The providers that filter by funding and revenue read those fields and skip a run that has none of them.
- Plan the next step before you search. A list of domains feeds company enrichment, email-format lookups and people search.

## Cost rules

- Searching and inspecting are free. Running is billed per call at the price `looot inspect` shows.
- Say the price before the first run, and the total after a batch.
- Never loop a failing call. Stop after two failures and report what failed.

## When not to use this skill

Use `looot-enrich-a-company` instead when you already have the domains and want details on each.

Page for people: https://looot.ai/agent-skills/company-list-builder

Wrong fit

When should I use a different skill?

Use Enrich a company when you already have the domains and want details on each.

FAQ

What do people ask about this skill?

Describe the segment to your agent, for example software firms in the US with 50 to 200 employees. It picks a provider that supports those filters, runs the search with a limit and returns a table of companies.

Yes, with the providers that filter by tech stack. One of them also filters by hiring signals, so you can find firms that use a tool and are hiring for it.

It depends on the provider. One caps a page at 25 companies, another at 62 through looot, and each result is billed. Your agent pages through the results until it has the number you asked for.

The list is rows of companies with domains. Enrich them with company data, look up the email format, then find the people. Each step is its own call and its own price.

No provider covers every company. Coverage is better for larger firms and in the US. Compare the first page from two providers before you commit to one.

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

No. looot bills per call, and nothing runs while your agent is idle.

The same job as a page with the full price ladder: Company list builder API for AI agents. Updated 2026-10-04.

Platforms and providers behind this skill

For agents
skill
looot-company-list-builder
file
https://looot.ai/agent-skills/company-list-builder/SKILL.md
difficulty
intermediate
input
filters such as industry, size, country, funding stage, revenue or technology
endpoint
theirstack-companies-search
endpoint
fullenrich-api-company-search
endpoint
thecompaniesapi-companies-post
endpoint
people-data-labs-company-search-get
endpoint
aviato-company-search
setup
https://looot.ai/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04

Try this skill with your own agent.

Start your workspace, top up, and save the skill where your agent reads it.