Skip to content

hashgraph-online/awesome-codex-plugins / plugins/carsxe/carsxe-codex-plugin/skills/recalls-batch

recalls-batch

Unverified

Submit and retrieve bulk safety-recall checks for many VINs using the CarsXE Recalls Batch API. Use this when the user wants to check recalls for a fleet, inventory list, CSV of VINs, or more than a handful of vehicles at once.

When the user wants bulk recall checks (many VINs, a fleet, a CSV, or a spreadsheet):

  1. Submit — POST at least one of vins, csv, or csvUrl (max 10,000 unique VINs):
    POST https://api.carsxe.com/v1/recalls-batch/submit?key={CARSXE_API_KEY}&source=codex_plugin
    Content-Type: application/json
    {"vins":["..."],"csv":"...","csvUrl":"...","webhookUrl":"..."}
    
    Include only provided fields. csvUrl must be HTTPS and hosted on an allowed provider (Google Sheets, GCS, S3, Dropbox, Azure Blob, DigitalOcean Spaces, Box). Max file size: 5 MB. Return batchId, status, totalVins, processedVins, hitCount, and timestamps.
  2. Status — poll until completed, partial, or failed (every 30–60 seconds; full processing often takes 30–60 minutes unless all VINs are cached):
    GET https://api.carsxe.com/v1/recalls-batch/status?key={CARSXE_API_KEY}&batchId={BATCH_ID}&source=codex_plugin
    
    Present status (uploading | processing | completed | partial | failed), progress (processedVins / totalVins), hitCount, hitRate, and errorMessage if failed.
  3. Results (JSON) once complete:
    GET https://api.carsxe.com/v1/recalls-batch/results?key={CARSXE_API_KEY}&batchId={BATCH_ID}&source=codex_plugin
    
    Present job summary, then each VIN: hasRecalls, recallCount, and recall titles / NHTSA numbers / remedy status. HTTP 409 means the batch is still processing.
  4. Download (CSV) if the user wants a file:
    GET https://api.carsxe.com/v1/recalls-batch/download?key={CARSXE_API_KEY}&batchId={BATCH_ID}&source=codex_plugin
    
    This returns text/csv, not JSON.
  5. For a single VIN use vehicle-recalls (/v1/recalls). For year/make/model with no VIN use recalls-ymm (/v1/recalls-ymm).
  6. If the API key is missing, tell the user to set the CARSXE_API_KEY environment variable (see AGENTS.md).
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 117kUpdated Claude CodeCodexUnverifiedInstall
Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 117kUpdated Claude CodeCodexUnverifiedInstall