# Inbound lead researcher

Researches each new lead, scores it against your ideal customer profile and posts the brief to your CRM or Slack.

Requires web search, through Exa. Requires web fetch. Starts from a signed webhook your service sends. Can use HubSpot, through Composio (optional). Can use Slack, through Composio (optional).

## Install

No one has run this against real HubSpot and Slack accounts through Composio yet. Its eval cases use stand-ins.

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun/packages/serve/templates/inbound-lead@860cae180df56af4d9a206ef2c997178da29fcf9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun%2Fpackages%2Fserve%2Ftemplates%2Finbound-lead%40860cae180df56af4d9a206ef2c997178da29fcf9`. Pinned to commit 860cae180df56af4d9a206ef2c997178da29fcf9.

## What it does

Researches each inbound lead from your form or CRM (the person, the company), scores it 0-100 against your ideal customer profile with the evidence for each criterion, suggests the next step, and posts the brief to the CRM record or a Slack channel. Learns from your corrections.

- Skill `lead`: Research an inbound lead (a form or CRM submission), score its fit 0-100 against the owner's ideal customer profile with evidence for each criterion, flag disposable or personal emails, competitors and students, suggest book a call, nurture or disqualify, write it back to the HubSpot record or post it to Slack, and return the brief as JSON. Use for each inbound lead webhook, "research this lead", "score this signup".
- Rules: `FLAGS.md`, `RUBRIC.md`

## What starts it

- A signed webhook (event lead.submitted), sent by your form, CRM or any service that signs Standard Webhooks. At most 3 at once.
- By hand, any time: from the console, the API or the CLI.

## Inputs

Each run takes a plain message (`content`).

### Setup, filled in once at install

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `icp` | string | yes | Your ideal customer in your own words: industry, company size, region, buying signals, and what disqualifies a lead (e.g. 'B2B fintech, 50-2000 people, US or EU, has a compliance team; never gambling operators') |
| `post_to` | string, one of crm, slack, none | no | Where each brief goes: crm (a note on the lead's HubSpot contact, the fit score in its text), slack (a message in one channel) or none (the run's answer only) Default: `none`. |
| `slack_channel` | string | no | A Slack channel ID like C0123ABCD (the channel's details in Slack show it), never its name: where the brief is posted when post\_to is slack. |
| `competitors` | string | no | Your competitors' names or domains, comma-separated; a lead from one is flagged, never scored as a customer. |

## What it needs

- Harness: pi
- Model: fast tier, low effort
- Tools: read, web_search, web_fetch
- Composio HubSpot tools (optional): HUBSPOT_CREATE_NOTE. Adds a note to the lead's contact in your HubSpot; reads nothing from it. The note can't be limited to one contact yet.
- Composio Slack tools (optional): SLACK_SEND_MESSAGE. Posts each lead's brief to the one Slack channel you set, and nowhere else.
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: on

## Sample output

No sample output ships with this template yet.

## Tested

7 eval cases: clear-disqualifier, injection-in-form, learned-correction, strong-fit, thin-data, write-back, write-back-wrong-record.

## Source

- Package: https://github.com/Parcha-ai/agentrun/tree/860cae180df56af4d9a206ef2c997178da29fcf9/packages/serve/templates/inbound-lead
- Publisher: Parcha-ai (1210 stars, 95 forks)
- Author: Parcha Labs
- Version: 0.2.0
- License: Apache-2.0
- Category: Sales
- Page: https://marketplace.agentrun.ai/templates/inbound-lead/
