plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "somantic",
  "version": "1.0.2",
  "description": "Search German property listings to buy or rent with Somantic's valuation, and estimate what any German address is worth.",
  "author": {
    "name": "Kretronik GmbH",
    "email": "support@somantic.net",
    "url": "https://www.somantic.net"
  },
  "homepage": "https://www.somantic.net/developers",
  "license": "LicenseRef-Proprietary",
  "keywords": [
    "real-estate",
    "germany",
    "immobilien",
    "property-search",
    "valuation",
    "apartments",
    "houses",
    "rent",
    "buy"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Somantic",
        "shortDescription": "German real estate search",
        "longDescription": "Somantic is a search engine for German real estate. Ask ChatGPT for apartments or houses to buy or rent anywhere in Germany and get current listings with the facts that matter \u2013 price, size, rooms, year built, energy class, features \u2013 plus Somantic's own valuation: what the property should cost based on comparable offers nearby, and how far the asking price is above or below it.\n\nWhat you can do:\n\u2022 Search listings by city or postcode, with filters for price, price per m\u00b2, size, rooms, year built, rental yield, amenities, vacancy, renovation need and price changes\n\u2022 Look up a single listing with its valuation\n\u2022 Estimate the purchase and rental value of any German address, listed or not, with a confidence rating\n\nEvery result names the portal it comes from and links to the original listing, where the full description, photos and contact details are. Somantic shows no exact addresses (postcode and district only), no advertiser texts and no photos.\n\nGetting started: you need a Somantic account; ChatGPT asks you to sign in the first time it searches.\n\nLimitations: listings cover residential offers in Germany only and are updated continuously; offers no longer online are removed within about three days. Valuations are statistical estimates from comparable listings, not certified appraisals.",
        "developerName": "Kretronik GmbH",
        "category": "Finance",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://www.somantic.net/developers",
        "supportURL": "https://www.somantic.net/impressum",
        "privacyPolicyURL": "https://www.somantic.net/datenschutz",
        "termsOfServiceURL": "https://www.somantic.net/agb",
        "defaultPrompt": [
          "Find apartments to buy in Leipzig under 200,000 \u20ac that are priced below their market value",
          "What is a 75 m\u00b2 apartment at Eppendorfer Weg 100, 20259 Hamburg, built 1990, worth?",
          "Show 3-room rental apartments in Hamburg with a balcony"
        ],
        "brandColor": "#047857",
        "composerIcon": "./assets/logo.svg",
        "logo": "./assets/logo.png",
        "screenshots": []
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search rental apartments with rooms, rent and amenity filters",
              "prompt": "Show me 3-room apartments for rent in Hamburg with a balcony for at most 1,500 \u20ac per month.",
              "tools_triggered": "search_listings",
              "expected_behavior": "Lists current Hamburg rental apartments with 3 rooms, a balcony and a cold rent of at most 1,500 \u20ac/month. Each result shows rent, living space, rooms, Somantic's valuation and how far the rent is above or below it, the source portal and a link to the original listing."
            },
            {
              "description": "Find apartments for sale priced below Somantic's valuation",
              "prompt": "Find apartments to buy in Leipzig under 200,000 \u20ac that are priced below their market value.",
              "tools_triggered": "search_listings",
              "expected_behavior": "Lists Leipzig apartments for sale at or below 200,000 \u20ac whose asking price is below Somantic's valuation, with the valuation, the percentage below it, the gross rental yield where available, the source portal and a link to the original listing."
            },
            {
              "description": "Combine the renovation and price-change filters",
              "prompt": "Which apartments for sale in Berlin need renovation and have had their price reduced?",
              "tools_triggered": "search_listings",
              "expected_behavior": "Lists Berlin apartments for sale that are marked as needing renovation and whose price was reduced while listed, with price, living space, Somantic's valuation, the source portal and a link to the original listing."
            },
            {
              "description": "Open one listing in detail",
              "prompt": "Find a house for sale in Dresden and show me the details of the first result.",
              "tools_triggered": "search_listings, get_listing",
              "expected_behavior": "Searches houses for sale in Dresden, then fetches the first result by its id and shows its facts (price, living space, rooms, features, gross rental yield), Somantic's valuation, the source portal and the link to the original listing. Photos and the advertiser's description are not returned; they are on the linked original."
            },
            {
              "description": "Estimate the purchase and rental value of an address",
              "prompt": "What is a 75 m\u00b2 3-room apartment at Eppendorfer Weg 100, 20259 Hamburg, built 1990, worth to buy and to rent?",
              "tools_triggered": "estimate_value",
              "expected_behavior": "Returns an estimated purchase price and monthly cold rent with low/high ranges and price per m\u00b2, plus a confidence rating and the number of comparable listings, and states that it is a statistical estimate, not a certified appraisal."
            }
          ],
          "negative": [
            {
              "description": "Outside coverage: Somantic only covers Germany. Expected: no listings are presented; ChatGPT explains that Somantic covers German listings only. If a search is made, it returns zero results.",
              "prompt": "Find a 2-room apartment to rent in Vienna, Austria."
            },
            {
              "description": "No actions on the user's behalf: all tools are read-only and cannot contact advertisers or book viewings. Expected: ChatGPT explains that it cannot contact the advertiser or arrange a viewing and points to the original listing link, where the contact options are.",
              "prompt": "Book a viewing for Saturday at 10 am with the seller of a 2-room apartment in Leipzig and send them my phone number."
            },
            {
              "description": "Personal data: Somantic returns no advertiser contact details and no exact street addresses (postcode and district only). Expected: no such data is returned; ChatGPT declines and points to the original listing on the source portal.",
              "prompt": "Find the home address and private phone number of the person selling a house in Dresden."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial release: search German property listings to buy or rent with Somantic's valuation, open a single listing, and estimate the purchase and rental value of any German address."
      },
      "apps": "./.app.json"
    }
  }
}