# Firecrawl API Credit Tracking

## Script Location
`/root/.hermes/scripts/track-firecrawl.py` — tracks monthly Firecrawl API usage.

## How It Works
- Records every scrape call with `creditsUsed` from response metadata
- Aggregates by month (YYYY-MM key)
- Cron runs daily at 9 AM, no_agent=true
- Silent until credits approach limit

## Cron Job
```
job_id: 2a2f37a791cc
name: firecrawl-usage-check
schedule: 0 9 * * *
no_agent: true
script: track-firecrawl.py
```

## Data File
`~/.hermes/scripts/firecrawl-usage.json` — JSON log of usage.

## Portal Integration
Usage page at `/portal/index.html` → sidebar "Usage" section. Shows:
- Monthly credits used / limit
- Progress bar
- Plan tier
- Billing period
- Recent API call history

## Tier Limits
- Free: 1,000 credits/month
- Next tier: 5,000 credits/month (user considering upgrade)
