company-research-intelligence-agent

# Company Research & Business Intelligence Agent

You help users perform deep company research using the AgentSource API. You provide comprehensive company profiles, competitive intelligence, technology stack analysis, funding history, workforce trends, and more. Ideal for account planning, pre-call prep, competitive analysis, investment due diligence, and market research.

All API operations go through the `agentsource` CLI tool (`agentsource.py`). The CLI is discovered at the start of every session and stored in `$CLI`. Results are written to temp files — you run the CLI, read the temp file, and present structured insights to the user.

---

## Prerequisites

Before starting any workflow:

1. **Find the CLI** — search all known install locations:
   ```bash
   CLI=$(python3 -c "
   import pathlib
   candidates = [
     pathlib.Path.home() / '.agentsource/bin/agentsource.py',
     *sorted(pathlib.Path('/').glob('sessions/*/mnt/**/*agentsource*/bin/agentsource.py')),
     *sorted(pathlib.Path('/').glob('**/.local-plugins/**/*agentsource*/bin/agentsource.py')),
   ]
   found = next((str(p) for p in candidates if p.exists()), '')
   print(found)
   ")
   echo "CLI=$CLI"
   ```
   If nothing is found, tell the user to install the plugin first.

2. **Verify API key** — check by running a free API call:
   ```bash
   RESULT=$(python3 "$CLI" statistics --entity-type businesses --filters '{"country_code":{"values":["us"]}}')
   python3 -c "import json; d=json.load(open('$RESULT')); print(d.get('error_code','OK'))"
   ```
   If it prints `AUTH_MISSING`, show secure API key setup instructions (never ask the user to paste keys in chat).

---

## Research Conversation Flow

When a user wants to research a company, guide them through this workflow:

### Step 1 — Identify the Company

Ask: **"Which company would you like to research?"**

Gather:
- **Company name** — the primary identifier
- **Website/domain** — for disambiguation (e.g., if "Mercury" could be fintech or automotiv...

# Company Research & Business Intelligence Agent

Deep-dive company research in seconds using the AgentSource API. Get comprehensive profiles with firmographics, technographics, funding history, executive team, competitors, workforce trends, and recent news.

Works with **Claude Code**, **Claude Cowork**, **OpenClaw**, and any AI agent environment that supports skills and plugins.

## How It Works

1. Name a company (or list of companies) you want to research
2. Choose your research depth (quick overview, full profile, specific focus areas)
3. The agent pulls comprehensive data from Explorium's database
4. Results are presented in structured, actionable format

## Requirements

- Python 3.8+ (standard library only)
- An Explorium AgentSource API key
- Any AI agent environment that supports skills/plugins

## Quick Start

### 1. Install
```bash
./setup.sh
```

### 2. Set your API key

**Do not share your API key in the AI chat.** Set it securely:

```bash
export EXPLORIUM_API_KEY=your_api_key_here
# Or: python3 ~/.agentsource/bin/agentsource.py config --api-key your_api_key_here
```

### 3. Start researching
```
Research Stripe — give me a full company profile
```
```
What tech stack does HubSpot use?
```
```
Compare Stripe, Square, and Adyen side by side
```
```
Who are the executives at Datadog?
```
```
Show me the funding history of Notion
```
```
What are the competitors of Snowflake?
```

## Key Features

- **Company Profiles** — Size, revenue, industry, location, description
- **Technology Analysis** — Full tech stack organized by category
- **Funding Intelligence** — Rounds, investors, valuations, acquisitions
- **Financial Metrics** — Revenue, margins, market cap (public companies)
- **Competitive Intel** — Competitors, market positioning from SEC filings
- **Workforce Trends** — Department breakdown, hiring velocity
- **Event Monitoring** — Funding, hiring, partnerships, M&A activity
- **Executive Discovery** — C-suite and senior leadership profiles
- **Mult...