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"}]
}' --poll

Setup

Install the CLI and authenticate:

npm install -g @alavida/cli
alavida auth

Verify you're connected:

alavida auth status
alavida credits

Running Analysis

Single Company

alavida run buying-signals --input '{
  "companies": [{
    "company_id": "stripe-1",
    "company_name": "Stripe",
    "domain": "stripe.com"
  }]
}' --poll

Multiple 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"}
  ]
}' --poll

With 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"
      }
    ]
  }]
}' --poll

From a JSON File

alavida run buying-signals --input companies.json --poll

Submit 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 jobs

Input Schema

View the full input/output schema anytime:

alavida schema buying-signals

Company 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