ClawRadar 🦞

Real-time trend monitoring for AI builders. Never miss a viral moment on X or Reddit.

ClawRadar watches X (Twitter) and Reddit for viral content in your niche — AI tools, indie hacking, SaaS launches, and more. When something's going viral, you get an alert within minutes with an engagement score and an actionable opportunity note.

Because the best time to engage with a trending post is before everyone else does.

---

How It Works

1. Scans X — searches configurable queries (AI agent, indie hacker, SaaS launch, etc.)
2. Scans Reddit — monitors configurable subreddits (r/artificial, r/SideProject, etc.)
3. Scores every post using a 3-factor composite score:
   • Engagement velocity (40%) — likes + RTs + comments per hour
   • Freshness (30%) — age-decayed; content older than 2h scores 0
   • Keyword relevance (30%) — hits against your niche keyword list
4. Filters by niche — only content matching your keywords gets through
5. Deduplicates — seen IDs are tracked so you never get the same alert twice
6. Alerts via Telegram (or OpenClaw CLI) — formatted message with URL, engagement stats, and an opportunity suggestion

---

Scoring Algorithm

composite_score = (engagement_velocity × 0.40) + (freshness × 0.30) + (keyword_relevance × 0.30)

Engagement velocity:

• Counts: likes + (retweets × 2) + comments per hour
• Retweets are weighted 2× (signal of spread, not just sentiment)
• Scale: 100 velocity/hr ≈ 30 pts · 500/hr ≈ 65 pts · 2000/hr ≈ 100 pts (capped)

Freshness:

• Brand new = 100 pts
• 1 hour old = ~50 pts
• At max_age_hours = 0 pts (default: 2 hours)
• Linear decay

Keyword relevance:

• Each keyword hit = 10 pts (capped at 100)
• Configurable keyword list

Default threshold: 55/100

---

Installation

Requirements: Python 3.9+, bird CLI for X scanning (Reddit uses the public JSON API — no auth needed)

git clone https://github.com/tenlifejosh/clawradar.git
cd clawradar

# No pip dependencies for Reddit scanning
# For X scanning, install bird CLI (part of AgentReach)
# pip install agentreach  (coming soon)

# Copy and edit config
cp config.example.json config.json
# Edit config.json with your settings

# Run a dry-run scan (no alerts sent)
python3 radar.py --dry-run --debug

---

Configuration

Copy config.example.json to config.json and customize:

{
  "telegram_bot_token": "YOUR_BOT_TOKEN",
  "telegram_chat_id": "YOUR_CHAT_ID",
  "bird_profile": "Default",
  "score_threshold": 55,
  "max_age_hours": 2,
  "x_searches": [
    ["AI agent", 20],
    ["indie hacker", 20],
    ["SaaS launch", 15]
  ],
  "subreddits": [
    ["artificial", "hot", 25],
    ["SideProject", "new", 30],
    ["entrepreneur", "hot", 20]
  ],
  "keywords": [
    "AI", "agent", "automation", "indie", "saas", "launch", "GPT", "LLM"
  ],
  "niche_keywords": [
    "AI", "agent", "indie", "saas", "startup", "launch"
  ]
}

Setting	Default	Description
score_threshold	55	Minimum score to trigger alert (0–100+)
max_age_hours	2	Ignore content older than this
x_searches	see above	X queries with result count
subreddits	see above	Subreddits with sort + limit
keywords	see above	Keyword list for relevance scoring
niche_keywords	see above	At least one must match to pass niche filter

---

Usage

# Normal scan (sends alerts)
python3 radar.py

# Dry run — scan without sending anything
python3 radar.py --dry-run

# Verbose debug output
python3 radar.py --debug

# Lower threshold (more alerts)
python3 radar.py --threshold 40

# Scan only X or only Reddit
python3 radar.py --x-only
python3 radar.py --reddit-only

---

Alert Format

🚨 TREND RADAR — 10:42 AM MDT
━━━━━━━━━━━━━━━━━━━━━
📈 VIRAL: "I built an AI agent that monitors my competitor pricing 24/7"

Platform: Reddit r/SideProject | By: u/indiebuilder42
Engagement: 847 upvotes, 63 comments in 1.2hr
Relevance: AI tools, indie hacking, SaaS
Score: 🔥🔥🔥🔥 (78/100)
URL: https://reddit.com/r/SideProject/comments/...

💡 Opportunity: This is trending on r/SideProject. Jump in the comments
   with your perspective — good exposure for your product.
━━━━━━━━━━━━━━━━━━━━━

---

OpenClaw Integration

ClawRadar is built to run as an OpenClaw scheduled task (cron):

# In OpenClaw, add a cron job:
# Run every 30 minutes during business hours
openclaw cron add --schedule "*/30 8-22 * * *" \
  --command "python3 /path/to/clawradar/radar.py" \
  --label "ClawRadar scan"

Or trigger it manually from your agent: "Run ClawRadar scan"

---

Files

clawradar/
├── radar.py          # Main scanner + scoring engine
├── config.example.json  # Configuration template
├── .gitignore        # Excludes seen.json and logs
├── logs/             # Scan logs (gitignored)
└── seen.json         # Dedup tracker (gitignored, auto-created)

---

The Claw Ecosystem 🦞

• ClawList — AI-powered task management for OpenClaw
• ClawRadar — Real-time trend monitoring ← you are here
• ClawLaws — Operating constitution for your AI agent

---

Contributing

PRs welcome. If you add a new platform driver (LinkedIn, HN, Product Hunt, etc.) — open a PR.

---

License

MIT © Ten Life Creatives 2026

Built for OpenClaw · Powered by AgentReach