@heulaulab/intai
v0.1.11
Published
AI-assisted prospect research CLI for small agencies and freelancers
Downloads
1,180
Maintainers
Readme
intai
AI-powered prospect research CLI for operators — analyze businesses, detect inefficiencies, and craft personalized outreach.
Quick Start
# Install
npm install -g @heulaulab/intai
# Configure
intai config set api-key <your-api-key>
# Analyze
intai analyze https://example-gym.com
# Outreach
intai outreach https://example-gym.comFeatures
Analyze — Scan websites for operational signals and identify automation opportunities
- Manual scheduling detection
- Communication gaps (phone/email-only contact)
- Spreadsheet dependency
- Admin bottlenecks
- Customer friction points
Outreach — Generate personalized cold outreach based on real findings
- Tailored subject lines
- Pain-point focused messaging
- Personalization notes for authenticity
Installation
Prerequisites
- Node.js >= 18.0.0
npm
npm install -g @heulaulab/intaipnpm
pnpm add -g @heulaulab/intaiyarn
yarn global add @heulaulab/intaibun
bun add -g @heulaulab/intaiRun without installing
npx @heulaulab/intai analyze <url>
bunx @heulaulab/intai analyze <url>
pnpm exec @heulaulab/intai analyze <url>Setup
Configure API Key
# Set via CLI (stored in ~/.intai/config.json)
intai config set api-key sk-...
# Or use environment variable
export OPENAI_API_KEY=sk-...Supports OpenAI and compatible APIs:
intai config set base-url https://api.openai.com/v1
intai config set model gpt-4oUsage
Analyze
intai analyze <url>
intai analyze <url> --json
intai analyze <url> -jOutreach
intai outreach <url>
intai outreach <url> --json
intai outreach <url> -jConfiguration
intai config set api-key <key>
intai config set base-url <url>
intai config set model <model>
intai config get
intai config get api-key
intai config unset api-keyCommands
| Command | Description |
|---------|-------------|
| intai analyze <url> | Analyze a business website |
| intai outreach <url> | Generate outreach message |
| intai config set <key> <value> | Set configuration |
| intai config get [key] | Get configuration |
| intai config unset <key> | Remove configuration |
| intai --help | Show help |
| intai --version | Show version |
Detection Capabilities
Operational Signals
- WhatsApp/phone/email-only contact (no booking system)
- Manual scheduling (class schedules, appointments as images)
- Spreadsheet dependency (managing data in spreadsheets)
- Inventory complexity (large catalogs without management)
- Repetitive admin tasks (RSVP via email, waitlists)
- No self-service portals
Output Categories
- Problems Detected — With severity levels (critical/moderate/minor)
- Suggested Tools — With priority and rationale
- Tech Stack — Detected technologies
- Summary — Overall assessment
Development
# Clone
git clone https://github.com/heulaulab-dev/intai.git
cd intai
# Install
npm install
# Build
npm run build
# Link for local testing
npm link
intai <command>
# Watch mode
npm run devArchitecture
intai/
├── src/
│ ├── index.ts # Entry point, CLI setup
│ ├── commands/ # CLI commands
│ │ ├── analyze.ts
│ │ ├── outreach.ts
│ │ └── config.ts
│ ├── analyzers/ # Business logic
│ │ ├── analysis.ts
│ │ └── outreach.ts
│ ├── services/ # External integrations
│ │ ├── ai.ts
│ │ └── scraper.ts
│ ├── prompts/ # AI prompts
│ │ ├── analysis.ts
│ │ └── outreach.ts
│ ├── types/ # TypeScript types
│ │ └── index.ts
│ └── utils/ # Utilities
│ ├── env.ts
│ ├── url.ts
│ └── spinner.ts
├── dist/ # Compiled output
├── package.json
├── tsconfig.json
└── README.mdTech Stack
- Runtime: Node.js 18+
- Language: TypeScript 5.6
- CLI: Commander.js
- Scraping: Cheerio (lightweight, no browser needed)
- AI: OpenAI SDK
- Output: Chalk, Boxen, Ora
Scraping
By default, intai uses a lightweight scraper based on Cheerio that works without installing a browser. This is fast and has no system dependencies.
Optional: Enhanced scraping with Playwright
If you need better JavaScript-rendered content, install Playwright:
npm run install:browser
# or
npx playwright install chromiumLicense
MIT
Repository: https://github.com/heulaulab-dev/intai
