Skip to content
EximAgent Docs

Find buyers

Ground in your profile, settle the HS code, preview the search, then stream results into a collection you can shortlist.

Buyer discovery finds companies that are not already in the corpus. That is what makes it the one genuinely expensive step in the toolkit, and why it is worth doing in the right order.

1. Ground in the profile

eximagent profile get

The profile supplies product, target markets, and defaults. If it is empty, the search has nothing to anchor on and you should fill in the details explicitly.

2. Settle the HS code

eximagent hscode search --query "roasted arabica coffee beans"

Choose the code deliberately. A search run against the wrong code returns a clean, plausible list of the wrong companies.

3. Preview

eximagent --dry-run search run \
  --product "roasted coffee" \
  --location DE \
  --hsCode 090111 \
  --direction buyers

Read the plan and the cost. This is the last free checkpoint.

4. Run and stream

eximagent search run --product "roasted coffee" --location DE --hsCode 090111 --confirmed

Capture the runId from the kickoff response, then block on the stream until the terminal complete event:

eximagent stream --run-id <runId>

5. Shortlist before spending more

eximagent collection get --name <name>

This is the step people skip, and skipping it is what makes a run expensive. Enrichment and contact discovery should only ever touch companies you have already decided are worth contacting.

When the list is large or the criteria are fuzzy, rank it with reasoning instead of eyeballing it:

eximagent collection analyze --collectionId <id> \
  --question "which of these actually import at scale and would buy from a mid-size Vietnamese roaster?"

The response ranks the collection with auditable evidence per rank, so you can check the reasoning rather than trusting the order.

6. Refine rather than re-run

If the shape of the results is wrong, refine the existing run before paying for a new one:

eximagent search refine --run-id <runId> --product "specialty green coffee"

Next