intelwatch

Competitive intelligence from the terminal. Track competitors, keywords, and brand mentions — no expensive SaaS required.

Install

npm install -g intelwatch
# or from source:
npm link

Requirements: Node.js >=18

Quick Start

# Add trackers
intelwatch track competitor https://competitor.com --name "Acme Corp"
intelwatch track keyword "audit SEO"
intelwatch track brand "Recognity"

# Run checks
intelwatch check

# See what changed
intelwatch digest

# Full report
intelwatch report --format html

Commands

Tracker Management

intelwatch track competitor <url> [--name <alias>]

Tracks a competitor website. Captures:

• Pages found (via link extraction)
• Pricing page content and price changes
• Technology stack (35+ technologies detected)
• Open job positions (/careers, /jobs)
• Social links
• Meta title/description changes on key pages

intelwatch track competitor https://acme.com --name "Acme"
intelwatch track competitor https://rival.io

intelwatch track keyword <keyword> [--engine google]

Tracks Google SERP rankings for a keyword. Records top 20 results, detects position changes, new entrants/exits, and featured snippet holders.

intelwatch track keyword "project management software"
intelwatch track keyword "audit SEO" --engine google

intelwatch track brand <name>

Tracks brand mentions across Google News and recent web results. Detects sentiment (positive/negative) and categorizes mentions (press, blog, forum, social, review).

intelwatch track brand "Recognity"
intelwatch track brand "My Company Name"

Listing & Removing

intelwatch list                    # List all trackers
intelwatch remove <tracker-id>     # Remove a tracker

Checking & Diffs

intelwatch check                   # Check all trackers
intelwatch check --tracker acme-com  # Check one tracker

intelwatch diff acme-com           # Compare last 2 snapshots
intelwatch diff acme-com --days 7  # Compare with 7 days ago

Reports

intelwatch digest                        # Quick summary table
intelwatch report                        # Markdown report (stdout)
intelwatch report --format html          # HTML report (saved to ~/.intelwatch/reports/)
intelwatch report --format json          # JSON report (stdout)
intelwatch report --format md --output ./weekly.md  # Custom output file

History & Comparison

intelwatch history acme-com              # Show snapshot history
intelwatch history acme-com --limit 10  # Last 10 snapshots

intelwatch compare acme-com rival-com    # Side-by-side comparison

Notifications

intelwatch notify --setup    # Interactive setup (Slack, Discord webhook)

Notifications config is stored at ~/.intelwatch/config.yml:

notifications:
  webhook: https://hooks.slack.com/services/xxx/yyy/zzz
  events:
    - competitor.new_page
    - competitor.price_change
    - keyword.position_change
    - brand.new_mention
    - brand.negative_mention

Data Storage

All data is stored locally in ~/.intelwatch/:

~/.intelwatch/
├── config.yml           # Notification settings
├── trackers.json        # Active trackers
├── snapshots/           # Historical snapshots (JSON)
└── reports/             # Generated HTML reports

Technology Detection

Detects 35+ technologies via headers, meta tags, scripts, HTML patterns:

| Category | Technologies | |----------|-------------| | CMS | WordPress, Drupal, Joomla | | E-commerce | Shopify, Magento | | Website Builder | Wix, Squarespace, Webflow | | JS Framework | React, Vue.js, Angular, Next.js, Nuxt.js, Gatsby, Svelte | | JS Library | jQuery | | CSS Framework | Bootstrap, Tailwind CSS | | Analytics | Google Analytics, Google Tag Manager, Facebook Pixel, Hotjar | | CRM/Marketing | HubSpot, Mailchimp, Intercom | | CDN/Security | Cloudflare | | Web Server | nginx, Apache | | Hosting | Vercel, Netlify | | Backend | PHP, Django, Ruby on Rails, Node.js/Express | | Payment | Stripe |

Sentiment Analysis

English and French word lists for positive/negative detection in brand mentions. Categorizes mentions as: press, blog, forum, social, or review.

Design Principles

• No external APIs — everything via respectful web scraping
• Respectful scraping — 1-2s delays, user-agent rotation, retry backoff
• Graceful degradation — saves what it can if a check partially fails
• Local-first — all data stays on your machine

Tests

npm test

40 tests covering storage logic, technology detection, and sentiment analysis.

License

MIT