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

buying-signals

Safety Notice

Copy this and send it to your AI assistant to learn