# OpenAgents Marketing Tracker Setup (2026-02-10)

## Project Location
`/home/nicholai/myopenagent/marketing-tools/`

## Services (systemd user units)
- `openagents-tracker.service` - 24/7 scraper daemon (5min intervals)
- `openagents-dashboard.service` - web dashboard on port 3847

## Credentials (.env)
```
TWITTER_API_KEY, TWITTER_API_KEY_SECRET, TWITTER_BEARER_TOKEN
QDRANT_URL=https://vectors.biohazardvfx.com
QDRANT_API_KEY=<redacted>
OLLAMA_HOST=http://localhost:11434
```

## Key Files
- `src/feeds/openagents-daemon.ts` - main tracker daemon
- `dashboard.ts` - stats dashboard with Chart.js
- `viz.html` - interactive embedding explorer (scatter/bubble plot)
- `backfill-embeddings.ts` - one-time script to embed existing DB entries
- `tracker.db` - SQLite database of mentions

## URLs
- http://localhost:3847 - main dashboard with charts
- http://localhost:3847/viz - embedding explorer for marketing intel
- http://localhost:3847/api/stats - JSON stats
- http://localhost:3847/api/embeddings - JSON embeddings with 2D projection

## Embedding Setup
- Model: nomic-embed-text (via Ollama)
- Vector DB: Qdrant collection `openagents_mentions`
- Dimension: 768
- Currently: 373 points embedded

## Twitter API Notes
- Free tier is heavily rate limited (~1 req/15min for search)
- Daemon rotates through 1 keyword per scan to avoid 429s
- Keywords: ERC-8128, slicekit, openclaw, clawdbot, claude code, etc.

## Dashboard Features
- Platform distribution (doughnut chart)
- Embedding space (2D scatter plot, color by platform/engagement/keywords)
- Timeline (mentions by hour)
- Interactive viz at /viz with zoom/pan, click-to-select, keyword filtering
