ServiceBuddy Auto Repair Savings & Quote Auditor

Find the best current auto-service deal near a US ZIP or metro and see what you'd actually pay. Returns the local typical price for the service (oil change, brakes, battery, diagnostic, coolant flush, tire rotation, tires), the best current coupon, discount, or rebate, and the net out-of-pocket "effective price" after discounts and rebates, with caveats. Optionally compares against a shop quote the user already has. Use when someone asks what a repair should cost, whether a quote is fair, or where to find a coupon. US only; 16 major metros are priced locally, other ZIPs use national averages.

{
  "type": "object",
  "properties": {
    "zip": {
      "description": "5-digit US ZIP, e.g. \"11205\". Give zip or city for local pricing; omit both for national averages.",
      "type": "string",
      "pattern": "^\\d{5}$"
    },
    "city": {
      "description": "Metro slug, e.g. \"new-york-city\", \"los-angeles\", \"houston\". Overrides zip.",
      "type": "string"
    },
    "service_category": {
      "default": "oil_change",
      "description": "Service to price.",
      "type": "string",
      "enum": [
        "oil_change",
        "brake_pads",
        "brake_fluid_flush",
        "battery_replacement",
        "coolant_flush",
        "diagnostic",
        "tire_rotation",
        "tires_set"
      ]
    },
    "service_variant": {
      "description": "Oil type (oil_change only). Omit to evaluate each offer on its own stated oil type.",
      "type": "string",
      "enum": [
        "full_synthetic",
        "blend",
        "conventional",
        "high_mileage"
      ]
    },
    "quoted_price": {
      "description": "A quote the user already has, in USD, e.g. 119. Enables \"is this quote fair?\" comparison.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "shop_name": {
      "description": "Shop or chain the user mentioned, e.g. \"Jiffy Lube\", to prioritise that brand's deals.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Plain-English summary of the local price and best deal."
    },
    "cached": {
      "type": "boolean",
      "description": "True if served from the 12-hour deal cache."
    },
    "benchmark": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string"
        },
        "variant": {
          "type": "string"
        },
        "local_midpoint": {
          "type": "number",
          "description": "Typical local price in USD, RPP-adjusted."
        },
        "local_low": {
          "type": "number"
        },
        "local_high": {
          "type": "number"
        },
        "rpp_multiplier": {
          "type": "number",
          "description": "Regional Price Parity multiplier applied to national baseline."
        }
      },
      "required": [
        "category",
        "variant",
        "local_midpoint",
        "local_low",
        "local_high",
        "rpp_multiplier"
      ],
      "additionalProperties": false
    },
    "offers_count": {
      "type": "number"
    },
    "best_match": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "merchant": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "title": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "effective_price": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Net out-of-pocket after discounts and rebates, USD."
            },
            "estimated_savings": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Estimated savings vs. the local benchmark, USD."
            }
          },
          "required": [
            "merchant",
            "title",
            "url",
            "effective_price",
            "estimated_savings"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Highest-savings offer, or null if none found."
    }
  },
  "required": [
    "summary",
    "cached",
    "benchmark",
    "offers_count",
    "best_match"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Audit a mechanic quote, repair estimate, or bill from an image URL or pasted text against US fair market labor rates and parts benchmarks. Identifies potential overcharges, checks state statutory inspection fee caps, flags OBD-II diagnostic inconsistencies, and matches active shop coupons or manufacturer rebates to reduce out-of-pocket costs without adversarial confrontation. US only.

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "URL or base64 data URI of the mechanic quote, invoice, or estimate image/PDF.",
      "type": "string"
    },
    "text": {
      "description": "Pasted plain text of the repair estimate, invoice, or list of line items with prices.",
      "type": "string"
    },
    "zip": {
      "description": "5-digit US ZIP code where the repair is quoted. Used for localized labor rates and regional price parity.",
      "type": "string",
      "pattern": "^\\d{5}$"
    },
    "vehicle": {
      "description": "Vehicle details if known. Overrides or supplements details extracted from the document.",
      "type": "object",
      "properties": {
        "year": {
          "description": "Vehicle year, e.g. \"2019\"",
          "type": "string"
        },
        "make": {
          "description": "Vehicle make, e.g. \"Toyota\"",
          "type": "string"
        },
        "model": {
          "description": "Vehicle model, e.g. \"RAV4\"",
          "type": "string"
        },
        "mileage": {
          "description": "Vehicle mileage, e.g. \"65000\"",
          "type": "string"
        },
        "vin": {
          "description": "17-character VIN if known",
          "type": "string"
        }
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Human-readable breakdown of the audit, line item verdicts, and actionable deal savings."
    },
    "document_type": {
      "type": "string",
      "enum": [
        "estimate",
        "receipt",
        "unknown"
      ],
      "description": "Type of document analyzed."
    },
    "is_international": {
      "type": "boolean",
      "description": "True if the quote was detected as non-US or non-USD."
    },
    "total_quoted": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Total price quoted on the document in USD."
    },
    "market_position": {
      "description": "How the total quote compares to fair market benchmarks.",
      "type": "string"
    },
    "potential_savings": {
      "type": "number",
      "description": "Actionable savings in USD available through verified coupons or rebates."
    },
    "coupon_savings": {
      "type": "number",
      "description": "Dollar savings specifically from active coupons or promotions."
    },
    "best_coupon": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "merchant": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "title": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "amount": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "same_shop": {
              "type": "boolean"
            }
          },
          "required": [
            "merchant",
            "title",
            "amount",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Highest-value coupon or discount found for this repair job."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "task": {
            "type": "string"
          },
          "quoted_price": {
            "type": "number"
          },
          "fair_range": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number"
              },
              "high": {
                "type": "number"
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": false
          },
          "verdict": {
            "type": "string",
            "enum": [
              "fair",
              "high",
              "questionable"
            ]
          },
          "advice": {
            "type": "string"
          },
          "is_diy_friendly": {
            "type": "boolean"
          }
        },
        "required": [
          "task",
          "quoted_price",
          "fair_range",
          "verdict",
          "advice",
          "is_diy_friendly"
        ],
        "additionalProperties": false
      },
      "description": "Line-by-line audit of each repair task on the bill."
    },
    "vehicle": {
      "type": "object",
      "properties": {
        "year": {
          "type": "string"
        },
        "make": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "mileage": {
          "type": "string"
        },
        "vin": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "shop": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "clunker_alert": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Warning if the repair quote exceeds 50% of the vehicle value."
    }
  },
  "required": [
    "summary",
    "document_type",
    "is_international",
    "total_quoted",
    "potential_savings",
    "coupon_savings",
    "best_coupon",
    "items",
    "clunker_alert"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}