firecrawl-cost-tuning — скилл для Claude Code
Скилл firecrawl-cost-tuning считает, куда уходят кредиты Firecrawl, и подбирает лимиты, форматы и кеш так, чтобы счёт стал меньше без потери качества данных.
MIT 1 установок ★ 2 935 обновлён 2026-10-29
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a claude-codeЧто делает firecrawl-cost-tuning
Скилл разбирает, на что ушёл бюджет Firecrawl, и предлагает, что урезать. Считает он по операциям и классам нагрузки: какие страницы обошли, какие форматы запросили, сработал ли кеш. Одно и то же число запросов может стоить очень по-разному, потому что модификаторы складываются.
Порядок работы — несколько шагов: снять текущую политику биллинга и план, привязать расход к владельцу и окружению, задать явные границы для crawl и batch, просить только нужные форматы, включать maxAge там, где SLA свежести это допускает, добавить предполётную проверку бюджета и пороги оповещений. Код и конфиги агент читает через Read, Glob и Grep, а Write и Edit пускает только в согласованные правки.
Авторизованные операции в Cloud требуют FIRECRAWL_API_KEY из хранилища секретов: заголовок Authorization: Bearer, ключ не печатать, не коммитить и не класть в URL. Поднять pay-as-you-go, сменить план, увеличить лимит на ключ или обменять хранение данных на экономию кеша без подтверждения человека скилл не даст. На исчерпанном бюджете работа останавливается: повторять запросы, пряча ответ 402, смысла нет.
Какие задачи решает
- понять, почему за месяц скакнул счёт за Firecrawl
- поставить потолок расхода на ключ и оповещение о перерасходе
- убрать из запросов форматы и опции, которые никто не читает
- сравнить стоимость crawl до и после правок с учётом качества
- проверить, не конфликтует ли экономия на кеше с требованиями к хранению данных
Примеры запросов агенту
- Разбери расход кредитов Firecrawl по репозиторию
services/scraperза окно30dи скажи, что урезать. - Почему скакнул бюджет Firecrawl? Разложи по эндпоинтам и форматам, сравни с базовым расходом.
- Сделай этот crawl дешевле, но покажи, как изменится полнота обхода страниц.
Как установить firecrawl-cost-tuning
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a claude-code2Вручную: положить файлы
~/.claude/skills/firecrawl-cost-tuning/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firecrawl-cost-tuning/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a codex2Вручную: положить файлы
.agents/skills/firecrawl-cost-tuning/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a cursor2Вручную: положить файлы
.cursor/skills/firecrawl-cost-tuning/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/firecrawl-cost-tuning2Вручную: положить файлы
.github/skills/firecrawl-cost-tuning/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/firecrawl-cost-tuningВручную: положить файлы
.devin/skills/firecrawl-cost-tuning/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о firecrawl-cost-tuning
Как установить firecrawl-cost-tuning в Claude Code?
Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill firecrawl-cost-tuning -a claude-code. Файл скилла появится по пути ~/.claude/skills/firecrawl-cost-tuning/SKILL.md.
Что делает firecrawl-cost-tuning?
Считает расход кредитов Firecrawl по операциям и нагрузкам, подбирает границы для crawl и batch, проверяет, окупаются ли дорогие форматы, и готовит оповещения о бюджете.
Какие доступы нужны скиллу?
Для работы с Firecrawl Cloud нужен FIRECRAWL_API_KEY из хранилища секретов и сетевой доступ. Сам скилл по вызову не скрапит страницы и не меняет настройки аккаунта.
Исходный текст
SKILL.md · MIT
--- name: firecrawl-cost-tuning description: >- Measure and reduce Firecrawl credit consumption using explicit limits, endpoint selection, cache policy, format discipline, and spend controls. Use when forecasting or correcting Firecrawl spend. Trigger with "Firecrawl costs", "reduce Firecrawl credits", or "Firecrawl budget". allowed-tools: Read,Glob,Grep,Write,Edit argument-hint: "<repository-path> <budget-window>" version: 1.12.0 license: MIT author: Jeremy Longshore <[email protected]> tags: [saas, firecrawl, cost, governance] model: inherit effort: high compatibility: "Designed for Claude Code; Firecrawl Cloud work requires network access" --- # Firecrawl Credit and Spend Control ## Overview Optimize against measured business value rather than assumed one-credit requests. Endpoint and option costs differ, modifiers can stack, and crawl or batch charges arrive as pages complete. ## Prerequisites - The target repository or integration path and the requested operator outcome. - The source authorization, data classification, and environment policy. - Current Firecrawl documentation, credentials only when needed, and an owner for approvals. ## Current Contract Use the current billing page and Credit Usage APIs as the pricing authority. Base scrape/crawl page costs, search/result charges, JSON or other format modifiers, ZDR, parse behavior, Interact minutes, and lockdown outcomes can differ. Polling status does not itself consume credits, while asynchronous page processing can make usage appear later. ## Authentication For authenticated Cloud operations, inject FIRECRAWL_API_KEY from an approved secret manager. REST requests use Authorization: Bearer with the key. Never print, commit, transmit, or place a key in a URL. Keyless access is suitable only where the current documentation explicitly allows it and the workload accepts its limits; production workflows should make identity and team ownership explicit. ## Instructions 1. Capture the current billing policy, plan, pay-as-you-go state, per-key spend limits, monthly cap, and a baseline by operation and workload class. 2. Attribute usage to an owner, environment, source policy, endpoint, requested formats, page counts, cache behavior, and success category. Never estimate solely from request count. 3. Set explicit crawl and batch bounds. Use map plus selective retrieval when discovery is cheaper than collecting every page. 4. Request only required formats and expensive options. Validate whether JSON extraction, prompt-injection checks, PDF parsing, ZDR, audio/video, or browser interaction earns its added cost. 5. Use maxAge and cache policy only when the freshness SLA permits it; use storeInCache false or ZDR when retention requirements outweigh savings. 6. Add preflight budget checks, alert thresholds, per-key controls where available, and a fail-closed response when the approved ceiling is reached. 7. Run a bounded canary, compare quality-adjusted cost with the baseline, and roll back if savings reduce completeness or violate policy. ## Tool Discipline Use Read, Glob, and Grep to inspect code, configuration, tests, and evidence. Use Write/Edit only for approved implementation or documentation changes. Do not call Firecrawl, rotate keys, change account settings, scrape a target, or deploy merely because this skill was invoked. ## Approval Boundaries Require approval before enabling or raising pay-as-you-go, changing plan, increasing a per-key spend limit, trading retention for cache savings, or reducing required quality. ## Output Return the billing-policy snapshot, workload attribution, baseline and candidate cost, quality delta, chosen controls, alerts, canary evidence, projected range, and rollback threshold. ## Error Handling - Usage lags async work: wait for job completion and billing settlement before declaring savings. - Current prices or limits cannot be verified: report a range and block irreversible plan decisions. - Budget is exhausted: stop new work; do not hide 402 responses with uncontrolled retries. ## Examples - "Why did credits spike?" attributes usage by option and completed page rather than request count. - "Make this crawl cheaper" tests scope, cache, format, and map-first changes against quality. ## Resources Read [official Firecrawl evidence](references/official-docs.md) before relying on an endpoint, SDK method, plan limit, price, retention option, or self-hosted release.
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace