hermes-skills/skills/devops/infrastructure-automation/references/firecrawl-credit-tracking.md

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)