How do I install the API Cost Tracker skill?

Run npx skillmds@latest add knownasnaffy/api-cost-tracker-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is API Cost Tracker safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with API Cost Tracker?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is API Cost Tracker free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published API Cost Tracker?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

API Cost Tracker by knownasnaffy — Agent Skill

Name: API Cost Tracker
Rating: 4.2 (5 reviews)
Author: knownasnaffy

API Cost Tracker

Track, analyze, and optimize AI API costs across OpenAI, Anthropic, OpenRouter, Google, and other LLM providers. Parses billing data, usage logs, or API responses to produce cost breakdowns by model, feature, and time period. Identifies optimization opportunities (model downgrades, caching, prompt compression). Use when asked to analyze API costs, track AI spending, optimize LLM usage, create cost reports, find expensive API calls, compare model pricing, set budget alerts, or audit API usage. Triggers on "API costs", "how much am I spending", "optimize API usage", "cost breakdown", "LLM spending", "token usage", "billing analysis", "reduce API costs", "budget tracking".

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

API Cost Tracker

Analyze and optimize AI API costs across multiple providers with detailed breakdowns, trend detection, and actionable savings recommendations.

Quick Start

# Analyze OpenRouter usage (from activity page export)
python3 scripts/api_cost_tracker.py openrouter --file activity.json

# Analyze OpenAI usage (from billing export)
python3 scripts/api_cost_tracker.py openai --file usage.json

# Analyze from environment (auto-detect provider from API keys)
python3 scripts/api_cost_tracker.py auto --days 30

# Cost breakdown by model
python3 scripts/api_cost_tracker.py openrouter --file activity.json --by model

# Cost breakdown by day with trend analysis
python3 scripts/api_cost_tracker.py openrouter --file activity.json --by day --trends

# Find most expensive requests
python3 scripts/api_cost_tracker.py openrouter --file activity.json --top 20

# Compare current vs optimized (model substitution analysis)
python3 scripts/api_cost_tracker.py openrouter --file activity.json --optimize

# Set budget alert threshold
python3 scripts/api_cost_tracker.py openrouter --file activity.json --budget 50.00

# Output as markdown report
python3 scripts/api_cost_tracker.py openrouter --file activity.json --output markdown

# Output as JSON
python3 scripts/api_cost_tracker.py openrouter --file activity.json --output json

Supported Providers

Provider	Input Format	Auto-detect
OpenAI	Billing CSV/JSON export, API responses	OPENAI_API_KEY
Anthropic	Usage API, console export	ANTHROPIC_API_KEY
OpenRouter	Activity JSON, API responses	OPENROUTER_API_KEY
Google AI	Billing export	GOOGLE_AI_API_KEY
Generic	CSV with columns: timestamp, model, tokens_in, tokens_out, cost	N/A

Analysis Features

Cost Breakdown — by model, day, week, feature/tag, request type
Trend Detection — spending velocity, anomaly detection, projected monthly cost
Optimization Report — model substitution suggestions, caching opportunities, prompt compression candidates
Budget Alerts — daily/weekly/monthly thresholds with projected overrun warnings
Top Spenders — most expensive individual requests or sessions
Model Comparison — cost-per-quality analysis using common benchmarks

Output Formats

Terminal (default) — colored tables and charts
Markdown — report suitable for documentation
JSON — structured data for programmatic use
CSV — spreadsheet-compatible export

How It Works

The script:

Reads usage data from the specified source (file, API, or environment)
Normalizes all entries to a common format (timestamp, model, input_tokens, output_tokens, cost)
Applies current provider pricing to calculate/verify costs
Groups and aggregates by the requested dimension
Runs optimization analysis comparing current models to cheaper alternatives
Generates the report in the requested format

Pricing Database

Built-in pricing for 50+ models (updated March 2026). Override with --pricing custom_prices.json.

Requirements

Python 3.8+
No external dependencies (stdlib only)

---name: api-cost-tracker-2description: Track, analyze, and optimize AI API costs across OpenAI, Anthropic, OpenRouter, Google, and other LLM providers. Parses billing data, usage logs, or API responses to produce cost breakdowns by model, feature, and time period. Identifies optimization opportunities (model downgrades, caching, prompt compression). Use when asked to analyze API costs, track AI spending, optimize LLM usage, create cost reports, find expensive API calls, compare model pricing, set budget alerts, or audit API usage. Triggers on "API costs", "how much am I spending", "optimize API usage", "cost breakdown", "LLM spending", "token usage", "billing analysis", "reduce API costs", "budget tracking".---# API Cost TrackerAnalyze and optimize AI API costs across multiple providers with detailed breakdowns, trend detection, and actionable savings recommendations.## Quick Start```bash# Analyze OpenRouter usage (from activity page export)python3 scripts/api_cost_tracker.py openrouter --file activity.json# Analyze OpenAI usage (from billing export)python3 scripts/api_cost_tracker.py openai --file usage.json# Analyze from environment (auto-detect provider from API keys)python3 scripts/api_cost_tracker.py auto --days 30# Cost breakdown by modelpython3 scripts/api_cost_tracker.py openrouter --file activity.json --by model# Cost breakdown by day with trend analysispython3 scripts/api_cost_tracker.py openrouter --file activity.json --by day --trends# Find most expensive requestspython3 scripts/api_cost_tracker.py openrouter --file activity.json --top 20# Compare current vs optimized (model substitution analysis)python3 scripts/api_cost_tracker.py openrouter --file activity.json --optimize# Set budget alert thresholdpython3 scripts/api_cost_tracker.py openrouter --file activity.json --budget 50.00# Output as markdown reportpython3 scripts/api_cost_tracker.py openrouter --file activity.json --output markdown# Output as JSONpython3 scripts/api_cost_tracker.py openrouter --file activity.json --output json```## Supported Providers| Provider | Input Format | Auto-detect ||----------|-------------|-------------|| OpenAI | Billing CSV/JSON export, API responses | OPENAI_API_KEY || Anthropic | Usage API, console export | ANTHROPIC_API_KEY || OpenRouter | Activity JSON, API responses | OPENROUTER_API_KEY || Google AI | Billing export | GOOGLE_AI_API_KEY || Generic | CSV with columns: timestamp, model, tokens_in, tokens_out, cost | N/A |## Analysis Features1. **Cost Breakdown** — by model, day, week, feature/tag, request type2. **Trend Detection** — spending velocity, anomaly detection, projected monthly cost3. **Optimization Report** — model substitution suggestions, caching opportunities, prompt compression candidates4. **Budget Alerts** — daily/weekly/monthly thresholds with projected overrun warnings5. **Top Spenders** — most expensive individual requests or sessions6. **Model Comparison** — cost-per-quality analysis using common benchmarks## Output Formats- **Terminal** (default) — colored tables and charts- **Markdown** — report suitable for documentation- **JSON** — structured data for programmatic use- **CSV** — spreadsheet-compatible export## How It WorksThe script:1. Reads usage data from the specified source (file, API, or environment)2. Normalizes all entries to a common format (timestamp, model, input_tokens, output_tokens, cost)3. Applies current provider pricing to calculate/verify costs4. Groups and aggregates by the requested dimension5. Runs optimization analysis comparing current models to cheaper alternatives6. Generates the report in the requested format## Pricing DatabaseBuilt-in pricing for 50+ models (updated March 2026). Override with `--pricing custom_prices.json`.## Requirements- Python 3.8+- No external dependencies (stdlib only)

Frequently asked questions

API Cost Tracker

File contents

API Cost Tracker

Quick Start

Supported Providers

Analysis Features

Output Formats

How It Works

Pricing Database

Requirements

Related skills

Frequently asked questions

How do I install the API Cost Tracker skill?

What does the API Cost Tracker skill do?

Is API Cost Tracker safe to use?

Which AI agents work with API Cost Tracker?

Is API Cost Tracker free to use?

Who published API Cost Tracker?