Buying Signals
Detect B2B buying signals for prospect companies via the Alavida CLI.
Quick Start
npm install -g @alavida/cli && alavida auth
# Analyze a company
alavida run buying-signals --input '{
"companies": [{"company_id": "acme-1", "company_name": "Acme Corp", "domain": "acme.com"}]
}' --pollSetup
Install the CLI and authenticate:
npm install -g @alavida/cli
alavida authVerify you're connected:
alavida auth status
alavida creditsRunning Analysis
Single Company
alavida run buying-signals --input '{
"companies": [{
"company_id": "stripe-1",
"company_name": "Stripe",
"domain": "stripe.com"
}]
}' --pollMultiple Companies
alavida run buying-signals --input '{
"companies": [
{"company_id": "stripe-1", "company_name": "Stripe", "domain": "stripe.com"},
{"company_id": "vercel-1", "company_name": "Vercel", "domain": "vercel.com"},
{"company_id": "linear-1", "company_name": "Linear", "domain": "linear.app"}
]
}' --pollWith People (Better Signal Detection)
Adding key people improves social signal detection (founder pain posts, conference speaking):
alavida run buying-signals --input '{
"companies": [{
"company_id": "acme-1",
"company_name": "Acme Corp",
"domain": "acme.com",
"website_url": "https://acme.com",
"people": [
{
"full_name": "Jane Doe",
"job_title": "CEO & Founder",
"role_type": "decision_maker",
"twitter_handle": "@janedoe",
"linkedin_url": "https://linkedin.com/in/janedoe"
}
]
}]
}' --pollFrom a JSON File
alavida run buying-signals --input companies.json --pollSubmit and Check Later
Jobs run asynchronously. Submit without --poll and check back:
# Submit
alavida run buying-signals --input '{"companies": [...]}'
# => Job submitted: 550e8400-...
# Do other work, then check
alavida jobs status 550e8400-e29b-41d4-a716-446655440000
# Or list all jobs
alavida jobsInput Schema
View the full input/output schema anytime:
alavida schema buying-signalsCompany Fields
| Field | Required | Description |
|---|---|---|
company_id | Yes | Unique identifier |
company_name | Yes | Company name |
domain | No | Domain (e.g., "acme.com") |
website_url | No | Full website URL |
people | No | Key people for social signal detection |
Person Fields
| Field | Required | Description |
|---|---|---|
full_name | Yes | Person's full name |
job_title | Yes | Job title |
role_type | No | decision_maker or champion |
twitter_handle | No | Twitter handle with @ |
linkedin_url | No | LinkedIn profile URL |
Signal Types
| Signal Type | Weight | Description |
|---|---|---|
founder_pain_post | 100 | Founder expressing need for creative/marketing help |
job_post_creative | 90 | Hiring designer, video editor, creative director |
funding_announcement | 80 | Recent funding round (seed through Series C+) |
yc_batch | 80 | Y Combinator company preparing for Demo Day |
stealth_launch | 75 | Company coming out of stealth or launching |
job_post_marketing | 60 | Hiring marketing roles (CMO, growth, demand gen) |
partnership_announced | 50 | New partnership or integration |
conference_speaking | 40 | Founder/exec speaking at conference |
Tier System
| Tier | Score | Action |
|---|---|---|
| HOT | 150+ | Prioritize immediately |
| WARM | 80-149 | Good outreach candidates |
| COOL | 40-79 | Monitor for more signals |
| COLD | <40 | Lowest priority |
CLI Reference
| Command | Description |
|---|---|
alavida auth | Authenticate with API key |
alavida auth status | Show auth status and credit balance |
alavida credits | View credit balance and usage |
alavida run buying-signals --input '<json>' --poll | Run analysis and wait for results |
alavida run buying-signals --input file.json | Submit from file |
alavida jobs | List all jobs |
alavida jobs status <job_id> | Check job status and results |
alavida schema buying-signals | View input/output schema |
alavida registry | Browse all available components |
Pricing
- Base cost: 500 credits per run
- Typical range: 400-800 credits depending on signal density
- Credits are deducted after job completion
Check your balance: alavida credits
Error Handling
| Error | Fix |
|---|---|
| Not authenticated | Run alavida auth |
| Invalid API key (401) | Get a new key from the dashboard |
| Insufficient credits (402) | Top up at the dashboard |
| Service unavailable (503) | Try again in a few minutes |
| Job failed | Run alavida jobs status <job_id> for details |
Other Components
Browse the full registry:
alavida registry| Component | Type | Description |
|---|---|---|
buying-signals | workflow | B2B buying signal detection |
echo | tool | Test component for sync calls |
echo-workflow | workflow | Test component for async flows |
Install and run any component the same way:
alavida schema <slug>
alavida run <slug> --input '{...}' --poll