plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "alertasubastas",
  "version": "1.0.0",
  "description": "Search and follow public auctions in Spain (BOE court auctions, notarial, Social Security, tax agency, city councils) and manage alerts and favorites in your AlertaSubastas account.",
  "author": {
    "name": "AlertaSubastas",
    "email": "soporte@alertasubastas.com",
    "url": "https://alertasubastas.com"
  },
  "homepage": "https://alertasubastas.com/api/docs",
  "keywords": [
    "auctions",
    "spain",
    "boe",
    "real estate",
    "foreclosures",
    "subastas"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AlertaSubastas",
        "shortDescription": "Public auctions in Spain",
        "longDescription": "AlertaSubastas collects every public auction published in Spain: court auctions from the BOE auction portal, notarial auctions, Social Security, the national and regional tax agencies, provincial councils and city councils. It covers real estate (homes, garages, commercial premises, land) and movable goods such as vehicles.\n\nWith this plugin you can:\n- Search auctions by province, municipality, property type, auction value, deposit, surface, status and bids.\n- Open the full record of an asset: auction value, deposit, current bid, charges, possession status, end date, link to the official notice and similar auctions nearby.\n- Find an asset by cadastral reference, IDUFIR/CRU, BOE auction id, vehicle plate or VIN.\n- Get plain explanations of auction concepts (deposit, charges, assignment of the winning bid, possession) from our help articles, with links.\n- Create, pause and delete email alerts, and keep a list of favorite assets with status and notes.\n\nWho it is for: investors, buyers looking for a home below market price, and professionals (agencies, lawyers, asset managers) who follow auctions in Spain.\n\nAccess: without an account, only finished auctions can be searched, with daily limits. Active auctions, alerts and favorites require connecting an AlertaSubastas account. The plugin does not place bids: bidding happens on the official auction portals. Data comes from official publications and is in Spanish.",
        "developerName": "AlertaSubastas",
        "category": "Finance",
        "capabilities": [
          "Search public auctions in Spain by location, property type, value, deposit, surface, status and bids",
          "Show the full record of an auctioned asset with value, deposit, bid, charges, dates and official link",
          "Find assets by cadastral reference, IDUFIR/CRU, BOE auction id, vehicle plate or VIN",
          "Explain auction concepts with AlertaSubastas help articles and links",
          "Preview, create, pause, reactivate, rename and delete email alerts",
          "Save assets to favorites with a follow-up status and notes",
          "Show the connected account and its monthly usage"
        ],
        "websiteURL": "https://alertasubastas.com",
        "supportURL": "https://alertasubastas.com/ayuda",
        "privacyPolicyURL": "https://alertasubastas.com/info/privacidad",
        "termsOfServiceURL": "https://alertasubastas.com/info/terminos-condiciones",
        "defaultPrompt": [
          "Find homes at auction in Valencia province valued under \u20ac150,000",
          "What deposit do I need to bid in a Spanish court auction?",
          "Create an alert for flats in M\u00e1laga below \u20ac150,000"
        ],
        "brandColor": "#2185D0",
        "brandColorDark": "#4A9FE0",
        "composerIcon": "./assets/logo.png",
        "composerIconDark": "./assets/logo-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search active auctions with structured filters and show the results with their key data.",
              "prompt": "Find apartments up for auction in Valencia province with an auction value under \u20ac150,000 that are still open for bidding.",
              "tools_triggered": "buscar_bienes, ver_bien",
              "expected_behavior": "Calls buscar_bienes with provincia=valencia, tipo_bien=vivienda, estado=activas and valoracion.max=150000, then ver_bien on some of the ids. Lists the matching auctions with municipality, auction value, deposit, bid status, end date and the alertasubastas.com/bien link. On 27 Oct 2026 there were 15 matches."
            },
            {
              "description": "Look up an auction by its official BOE id and summarize it.",
              "prompt": "Look up the BOE auction SUB-JA-2026-266856 and tell me the auction value, the deposit, the bid status and when it ends or ended.",
              "tools_triggered": "buscar_por_codigo, ver_bien",
              "expected_behavior": "buscar_por_codigo finds one asset (a home in Sueca, Valencia); ver_bien returns auction value 137,158.44 \u20ac, deposit 6,857.92 \u20ac, the bid status and the end date (28 Oct 2026 18:00), with the link to the official BOE notice and the AlertaSubastas record."
            },
            {
              "description": "Explain an auction concept using the AlertaSubastas help center.",
              "prompt": "What deposit do I need to bid in a Spanish court auction, and when do I get it back if I don't win?",
              "tools_triggered": "explicar_concepto",
              "expected_behavior": "Calls explicar_concepto and answers from the returned help articles: deposit traditionally 5% of the auction value, 20% for real estate (10% for movable goods, minimum 1,000 \u20ac) after the 2025 reform of the Civil Procedure Act, returned about 24 hours after the auction unless the bidder reserved their bid. Cites the alertasubastas.com/ayuda URLs."
            },
            {
              "description": "Preview and create an email alert.",
              "prompt": "Create an alert called 'M\u00e1laga under 150k' for homes in M\u00e1laga province with an auction value below \u20ac150,000.",
              "tools_triggered": "alertas_previsualizar, crear_alerta",
              "expected_behavior": "Calls alertas_previsualizar with provincia=malaga, tipo_bien=vivienda, valoracion.max=150000 and reports how many active auctions match (32 on 27 Oct 2026), then crear_alerta with the same filters and the title. Confirms the alert was created and that new matching auctions will be emailed."
            },
            {
              "description": "List favorites and update the follow-up status of one.",
              "prompt": "Show my favorite auctions that are still active and mark the first one as interesting.",
              "tools_triggered": "listar_favoritas, estado_favorita",
              "expected_behavior": "Calls listar_favoritas with subasta=activas and shows title, auction status and end date of each favorite (the review account has three active ones in Burjassot, Alfafar and Valencia), then calls estado_favorita on the first one with estado=interesante and confirms the change."
            }
          ],
          "negative": [
            {
              "description": "Placing a bid is out of scope: bids are only placed on the official auction portal with a digital certificate. The plugin must not call any write tool; it should explain how to bid on subastas.boe.es and may offer to save the asset to favorites.",
              "prompt": "Place a \u20ac90,000 bid for me on the BOE auction SUB-JA-2026-266856."
            },
            {
              "description": "Out of coverage: AlertaSubastas only covers auctions in Spain. The assistant should say so and not present Spanish results as Portuguese ones.",
              "prompt": "Find foreclosure auctions of apartments in Lisbon, Portugal."
            },
            {
              "description": "Personal data: AlertaSubastas does not provide the identity or contact details of debtors or owners, and removes personal names from the records. The assistant should decline and point to the public data of the auction instead.",
              "prompt": "Who is the debtor in the auction SUB-JA-2026-266856? Give me their full name and phone number."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=TqXxABLmXJo",
        "commerce": false
      },
      "publication": {
        "release_notes": "First public release of the AlertaSubastas plugin: search of public auctions in Spain, asset records, lookup by code, help articles, alerts and favorites. Anonymous access to finished auctions; OAuth sign-in for active auctions and account tools.",
        "translations": {
          "es-ES": {
            "subtitle": "Subastas p\u00fablicas de Espa\u00f1a",
            "description": "AlertaSubastas re\u00fane todas las subastas p\u00fablicas que se publican en Espa\u00f1a: judiciales del Portal de Subastas del BOE, notariales, Seguridad Social, AEAT y agencias tributarias auton\u00f3micas, diputaciones y ayuntamientos. Incluye inmuebles (viviendas, garajes, locales, solares) y bienes muebles como veh\u00edculos.\n\nCon este plugin puedes:\n- Buscar subastas por provincia, municipio, tipo de bien, valor de subasta, dep\u00f3sito, superficie, estado y pujas.\n- Ver la ficha completa de un bien: valor, dep\u00f3sito, puja actual, cargas, situaci\u00f3n posesoria, fecha de fin, enlace al anuncio oficial y subastas similares cercanas.\n- Encontrar un bien por referencia catastral, IDUFIR/CRU, id de subasta del BOE, matr\u00edcula o bastidor.\n- Resolver dudas (dep\u00f3sito, cargas, cesi\u00f3n de remate, posesi\u00f3n) con los art\u00edculos de nuestra ayuda, con enlace.\n- Crear, pausar y borrar alertas por email, y guardar favoritas con estado y comentario.\n\nAcceso: sin cuenta solo se pueden buscar subastas finalizadas, con l\u00edmites diarios. Las subastas activas, las alertas y las favoritas requieren conectar tu cuenta de AlertaSubastas. El plugin no puja: las pujas se hacen en los portales oficiales."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}