explorium-agentsource-companies-contacts_skill

Overview

This skill helps you find B2B companies and contacts using the AgentSource (Explorium) database, then preview, enrich, and export results to CSV. It manages the end-to-end workflow: parse your natural-language query into API filters, run safe sample fetches, request confirmation, and perform full fetches, enrichments, event lookups, and CSV exports. The skill requires a configured EXPLORIUM_API_KEY available to the agentsource CLI.

How this skill works

At session start the skill discovers the local agentsource CLI and validates the API key (environment or saved config). It parses the user query into entity type (businesses vs prospects) and API filters, runs required autocomplete calls for specific fields, performs a free statistics call for market sizing, then a small sample fetch. After showing totals and a sample, it waits for explicit user confirmation before doing full fetches, optional enrichments or event retrievals, and finally converts results to CSV.

When to use it

• You want to find companies or decision-makers from a specific industry, region, company size, or tech stack
• You need lists of prospects or contacts for outbound sales or recruiting
• You want to enrich an existing CSV or inline list with firmographics, technographics, or contact data
• You need event signals (funding, hiring) tied to a company list
• You want a CSV export of matched, enriched, or evented results for downstream workflows

Best practices

• Do not paste API keys into chat; set EXPLORIUM_API_KEY as an env var or run the CLI config command
• Always run the sample fetch and confirm before a full fetch or export — the skill will never proceed without explicit confirmation
• Run autocomplete (with --semantic) for fields that require it and use the exact returned values in filters
• Get a market-size (statistics) read first to estimate credits and narrow very large result sets
• When enriching CSVs, supply an explicit column map for better match rates

Example use cases

• Find 500 product managers at US healthcare companies and export a verified contact list to CSV
• Enrich an existing accounts CSV with firmographics and technographics before a campaign
• Get companies that recently raised funding or show hiring signals in engineering for lead prioritization
• Match and fetch decision-makers (CTO/CMO/VP) at a shortlist of target accounts provided inline
• Identify companies using a specific technology stack and export the list for market research