openai-tools.json

{
  "_comment": "Function-calling tool schemas for kleinanzeigen-reader. Works with OpenAI, Azure OpenAI, Google Gemini, Mistral, Groq, Ollama and any provider that accepts the JSON-Schema function format. Back each tool with the CLI (`kl-read URL --json`) or the Python API (see README). Read-only public data only.",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "read_listing",
        "description": "Analyze a single kleinanzeigen.de listing and return structured data: title, price, location, category, attributes, seller type (private vs dealer), red flags, a 1-5 rating, status (active/reserved/sold), native price reduction, and image URLs. Use whenever a user shares a kleinanzeigen.de/s-anzeige/... link.",
        "parameters": {
          "type": "object",
          "properties": {
            "url": { "type": "string", "description": "The kleinanzeigen.de listing URL." }
          },
          "required": ["url"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "compare_listings",
        "description": "Compare two or more kleinanzeigen.de listings side by side and detect whether they are likely the same item posted twice.",
        "parameters": {
          "type": "object",
          "properties": {
            "urls": {
              "type": "array",
              "items": { "type": "string" },
              "description": "Two or more listing URLs to compare."
            }
          },
          "required": ["urls"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "listing_views",
        "description": "Get the public view counter (numVisits) of a listing. Many views plus an old posting date usually means the item is overpriced or stale.",
        "parameters": {
          "type": "object",
          "properties": {
            "url": { "type": "string", "description": "The listing URL." }
          },
          "required": ["url"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "seller_other_listings",
        "description": "List the seller's other active listings (works for private sellers too) to spot undeclared dealers and gather local price comparisons.",
        "parameters": {
          "type": "object",
          "properties": {
            "url": { "type": "string", "description": "A listing URL from the seller." }
          },
          "required": ["url"]
        }
      }
    },
    {
      "type": "function",
      "function": {
        "name": "track_price",
        "description": "Record the current price of a listing into a local history store and return the full price series over time. Call repeatedly to build a real price curve Kleinanzeigen itself does not expose.",
        "parameters": {
          "type": "object",
          "properties": {
            "url": { "type": "string", "description": "The listing URL to track." }
          },
          "required": ["url"]
        }
      }
    }
  ]
}