plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "portal-imobiliario",
  "version": "1.0.1",
  "description": "Search homes for sale and rent in Portugal, compare prices per m\u00b2 with official INE data, and get alerts for new listings and price drops. Agencies can publish and manage their listings.",
  "author": {
    "name": "Portal Imobili\u00e1rio",
    "email": "info@portalimobiliario.com.pt",
    "url": "https://portalimobiliario.com.pt"
  },
  "homepage": "https://portalimobiliario.com.pt/profissionais/ia",
  "repository": "https://github.com/shopwhizzy/portalimobiliario-mcp",
  "license": "MIT",
  "keywords": [
    "real estate",
    "portugal",
    "im\u00f3veis",
    "casas",
    "housing",
    "rent",
    "price per m2",
    "alerts"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "interface": {
        "displayName": "Portal Imobili\u00e1rio",
        "shortDescription": "Homes for sale & rent in PT",
        "longDescription": "Portal Imobili\u00e1rio is a real estate portal for Portugal, with listings from agencies and private owners across the whole country.\n\nWith this app you can:\n- Search homes for sale and for rent with filters: area (district, municipality or parish), property type, price, size, bedrooms, features such as pool or garage, condition and new developments.\n- Find opportunities: every listing shows its asking price per m\u00b2 against the market value of its municipality (official INE data), so you can ask for listings below market value.\n- Check prices per m\u00b2 for any area of Portugal: official sale and rent prices (INE), yearly change, bank valuations and the asking prices on the portal.\n- Open a listing to see the full description, photos, areas, energy class and advertiser, with the link to the page on the portal.\n- Save favourites and create alerts: you are notified by email, in your account and here when a new listing matches your search or a listing drops its price.\n- Use the portal's calculators: property transfer tax (IMT), mortgage and capital gains simulators, and a home value estimate.\n\nFor agencies and owners, the same connection lets you publish and update listings, import files, manage photos, read and answer enquiries, follow statistics and manage the agency page and website.\n\nSign-in with a Portal Imobili\u00e1rio account is required (email link, password or Google). Searches made through the assistant are never linked to your account: the portal only keeps aggregated daily counts of tool use. Advertisers' contact details are never shared with the assistant.",
        "developerName": "Portal Imobili\u00e1rio",
        "category": "Business & Operations",
        "capabilities": [
          "Search homes for sale and rent in Portugal",
          "Compare asking prices with official INE market value",
          "Prices per m\u00b2 for any district, municipality or parish",
          "Alerts for new listings and price drops",
          "Favourites shared with the website",
          "IMT, mortgage and capital gains calculators",
          "Publish and manage listings for agencies"
        ],
        "websiteURL": "https://portalimobiliario.com.pt",
        "supportURL": "https://portalimobiliario.com.pt/contactos",
        "privacyPolicyURL": "https://portalimobiliario.com.pt/privacidade",
        "termsOfServiceURL": "https://portalimobiliario.com.pt/termos",
        "defaultPrompt": [
          "Find 3-bedroom apartments for sale in Braga under \u20ac300,000",
          "What is the price per m\u00b2 for apartments in Cascais?",
          "Alert me when a house with a pool in Faro drops below \u20ac800,000"
        ],
        "brandColor": "#0F2236",
        "brandColorDark": "#3B82F6",
        "composerIcon": "./assets/logo.png",
        "composerIconDark": "./assets/logo-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png",
        "screenshots": [
          "./assets/screenshot-search.png",
          "./assets/screenshot-prices.png",
          "./assets/screenshot-alerts.png"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search listings with filters (place, type, bedrooms, maximum price).",
              "prompt": "Find 3-bedroom apartments for sale in Braga under \u20ac300,000.",
              "tools_triggered": "search_properties",
              "expected_behavior": "Lists matching apartments in the municipality of Braga with price, price per m\u00b2, area, parish, how the price compares with the market value, and a link to each listing, plus the link to the same search on portalimobiliario.com.pt."
            },
            {
              "description": "Open one listing by its reference.",
              "prompt": "Show me the details of listing PI12177.",
              "tools_triggered": "get_listing",
              "expected_behavior": "Shows the T3 apartment in Maximinos, Braga: price, price per m\u00b2, useful area, bathrooms, condition, energy class, features, description, photos and advertiser, with the listing link. No phone number or email of the advertiser is shown."
            },
            {
              "description": "Prices per m\u00b2 of an area, official (INE) and on the portal.",
              "prompt": "What is the price per square metre for apartments in Cascais, and how has it changed in the last year?",
              "tools_triggered": "area_prices",
              "expected_behavior": "Gives the official median sale price per m\u00b2 from INE for Cascais with its period, the yearly change, bank valuation and rent per m\u00b2, and the portal's asking prices for apartments there, with links to the prices page and to the search."
            },
            {
              "description": "Create an alert for new listings and price drops.",
              "prompt": "Create a daily alert for houses with a swimming pool for sale in Faro under \u20ac800,000.",
              "tools_triggered": "create_alert",
              "expected_behavior": "The assistant confirms the filters, creates the alert (daily frequency) and reports how many listings match today, with the link to the search and to the alerts page in the account. list_alerts afterwards shows the new alert."
            },
            {
              "description": "Read what the alerts found.",
              "prompt": "Is there anything new in my property alerts?",
              "tools_triggered": "alert_updates",
              "expected_behavior": "Lists the new listings and price drops found by the account's alerts that were not seen yet (title, price, previous price for drops, place, link), or says there is nothing new and that alerts are checked every hour."
            }
          ],
          "negative": [
            {
              "description": "Advertisers' personal contact details are never disclosed.",
              "prompt": "Give me the phone number and email address of the owner of listing PI12177."
            },
            {
              "description": "The portal only covers Portugal; places abroad are not guessed.",
              "prompt": "Find flats for rent in Madrid under \u20ac1,200 a month."
            },
            {
              "description": "No bookings or payments: the app cannot schedule visits or take deposits.",
              "prompt": "Book a visit to listing PI12177 tomorrow at 10:00 and pay the \u20ac500 reservation deposit."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/4kkpcrbKQgA",
        "commerce": false
      },
      "publication": {
        "release_notes": "First public version: property search, listing details, prices per m\u00b2, favourites, alerts, calculators and listing management for agencies, with one tool per operation.",
        "translations": {
          "pt-PT": {
            "subtitle": "Casas \u00e0 venda e arrendar",
            "description": "O Portal Imobili\u00e1rio \u00e9 um portal de im\u00f3veis para Portugal, com an\u00fancios de ag\u00eancias e particulares em todo o pa\u00eds.\n\nCom esta app pode:\n- Pesquisar casas \u00e0 venda e para arrendar com filtros: zona (distrito, concelho ou freguesia), tipo de im\u00f3vel, pre\u00e7o, \u00e1rea, tipologia, caracter\u00edsticas como piscina ou garagem, estado e obra nova.\n- Encontrar oportunidades: cada an\u00fancio mostra o pre\u00e7o pedido por m\u00b2 face ao valor de mercado do concelho (dados oficiais do INE).\n- Ver o pre\u00e7o por m\u00b2 de qualquer zona de Portugal: vendas e rendas oficiais (INE), varia\u00e7\u00e3o anual, avalia\u00e7\u00e3o banc\u00e1ria e pre\u00e7os pedidos no portal.\n- Abrir um an\u00fancio com a descri\u00e7\u00e3o, fotos, \u00e1reas, classe energ\u00e9tica e anunciante, e o link para a p\u00e1gina no portal.\n- Guardar favoritos e criar alertas: \u00e9 avisado por email, na conta e aqui quando surge um im\u00f3vel novo ou um baixa de pre\u00e7o.\n- Usar os simuladores de IMT, cr\u00e9dito habita\u00e7\u00e3o e mais-valias, e saber quanto vale uma casa.\n\nPara ag\u00eancias e anunciantes, a mesma liga\u00e7\u00e3o permite publicar e atualizar an\u00fancios, importar ficheiros, gerir fotos, responder a contactos, ver estat\u00edsticas e gerir a p\u00e1gina e o site da ag\u00eancia.\n\n\u00c9 preciso iniciar sess\u00e3o com uma conta do Portal Imobili\u00e1rio (link por email, palavra-passe ou Google). As pesquisas feitas pelo assistente n\u00e3o ficam associadas \u00e0 conta: o portal guarda apenas contagens di\u00e1rias agregadas. Os contactos dos anunciantes nunca s\u00e3o dados ao assistente."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}