plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "aqar",
  "version": "1.0.3",
  "description": "Find properties to rent or buy in Saudi Arabia using Aqar listing search, property details and district lookup.",
  "author": {
    "name": "Aqar",
    "url": "https://sa.aqar.fm"
  },
  "homepage": "https://sa.aqar.fm",
  "keywords": [
    "real-estate",
    "Saudi Arabia",
    "rent",
    "buy",
    "\u0639\u0642\u0627\u0631"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Aqar",
        "shortDescription": "Search Saudi property listings",
        "longDescription": "Aqar is a real-estate search plugin for people looking to rent or buy property in Saudi Arabia. Users anywhere can search in Arabic or English by city, district, property type, price, area, bedrooms and furnishing. Browse public listings in photo cards, read individual property details, and look up Saudi districts. Supported properties include apartments, villas, floors, land, offices, stores, warehouses, rest houses and chalets.\n\nPrices are in Saudi riyals (SAR); rental prices are per rental period, usually yearly. Every listing links to sa.aqar.fm. No Aqar account or precise user location is required. The plugin searches and reads listings; contacting advertisers, arranging viewings, booking and payment take place outside the plugin.",
        "developerName": "Aqar",
        "category": "Other",
        "capabilities": [
          "Interactive",
          "Read"
        ],
        "websiteURL": "https://sa.aqar.fm",
        "defaultPrompt": [
          "\u0634\u0642\u0629 \u0644\u0644\u0625\u064a\u062c\u0627\u0631 \u0641\u064a \u062d\u064a \u0627\u0644\u0646\u0631\u062c\u0633 \u0628\u0627\u0644\u0631\u064a\u0627\u0636",
          "Find a 3-bedroom rental in north Riyadh under SAR 80,000/year",
          "\u0627\u0639\u0631\u0636 \u0623\u062d\u064a\u0627\u0621 \u0645\u062f\u064a\u0646\u0629 \u062c\u062f\u0629"
        ],
        "privacyPolicyURL": "https://help.aqar.fm/en/articles/17301194-aqar-plugin-for-chatgpt-privacy-notice",
        "termsOfServiceURL": "https://help.aqar.fm/en/articles/8804175-platform-terms-and-conditions",
        "logo": "./assets/logo.jpg",
        "composerIcon": "./assets/logo.jpg",
        "supportURL": "https://help.aqar.fm/en/"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Arabic district search",
              "prompt": "\u0634\u0642\u0629 \u0644\u0644\u0625\u064a\u062c\u0627\u0631 \u0641\u064a \u062d\u064a \u0627\u0644\u0646\u0631\u062c\u0633 \u0628\u0627\u0644\u0631\u064a\u0627\u0636",
              "tools_triggered": "search_listings",
              "expected_behavior": "Search apartment_for_rent in \u0627\u0644\u0631\u064a\u0627\u0636 with district \u0627\u0644\u0646\u0631\u062c\u0633; show matching listing cards and links, or accurately report no matches."
            },
            {
              "description": "English rental filters",
              "prompt": "Find a 3-bedroom apartment for rent in north Riyadh under 80,000 SAR a year.",
              "tools_triggered": "search_listings",
              "expected_behavior": "Use city Riyadh, district \u0634\u0645\u0627\u0644 \u0627\u0644\u0631\u064a\u0627\u0636, category apartment_for_rent, min_bedrooms 3, max_price 80000 and rent_period yearly. Describe the bedroom filter as 3 or more; preserve reported price periods."
            },
            {
              "description": "Resolve Saudi districts",
              "prompt": "\u0627\u0639\u0631\u0636 \u0623\u062d\u064a\u0627\u0621 \u0645\u062f\u064a\u0646\u0629 \u062c\u062f\u0629",
              "tools_triggered": "find_locations",
              "expected_behavior": "List districts for \u062c\u062f\u0629 using returned Arabic district names."
            },
            {
              "description": "Full listing details",
              "prompt": "Find an apartment for sale in Riyadh, then show full details of the first result.",
              "tools_triggered": "search_listings, get_listing",
              "expected_behavior": "Search apartment_for_sale in \u0627\u0644\u0631\u064a\u0627\u0636, then pass the first returned id or URL to get_listing. Report only returned details and link to the listing. If no results, report that and do not invent an id."
            },
            {
              "description": "Pagination",
              "prompt": "\u0627\u0628\u062d\u062b \u0639\u0646 \u0641\u0644\u0644 \u0644\u0644\u0628\u064a\u0639 \u0641\u064a \u0627\u0644\u0631\u064a\u0627\u0636 \u0648\u0627\u0639\u0631\u0636 \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u062b\u0627\u0646\u064a\u0629",
              "tools_triggered": "search_listings",
              "expected_behavior": "Search villa_for_sale in \u0627\u0644\u0631\u064a\u0627\u0636 with page 2, preserving filters and presenting returned cards and listing links."
            }
          ],
          "negative": [
            {
              "description": "Outside Saudi Arabia",
              "prompt": "Find an apartment for rent in Dubai.",
              "expected_behavior": "Explain that Aqar covers Saudi Arabia; do not call Aqar tools for Dubai or silently substitute a Saudi city."
            },
            {
              "description": "Unsupported contact, booking and payment",
              "prompt": "\u0627\u062a\u0635\u0644 \u0628\u0627\u0644\u0645\u0639\u0644\u0646 \u0648\u0627\u062d\u062c\u0632 \u0627\u0644\u0639\u0642\u0627\u0631 \u0648\u0627\u062f\u0641\u0639 \u0627\u0644\u0639\u0631\u0628\u0648\u0646",
              "expected_behavior": "Explain that contact, booking and payment are unavailable; provide an existing listing link if known, without claiming to take action."
            },
            {
              "description": "Missing city",
              "prompt": "\u0623\u0631\u064a\u062f \u0634\u0642\u0629 \u0644\u0644\u0625\u064a\u062c\u0627\u0631",
              "expected_behavior": "Ask for the city before searching; do not guess a location or request precise GPS coordinates."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin only searches and reads public property listings. It cannot contact advertisers, book properties or process payments.",
        "demo_recording_url": "https://drive.google.com/file/d/1T41JLJf7WbxYIsCwu9DCpDl7ezOCKFeD/view?usp=sharing"
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: search apartments, villas, land and more for rent or sale across Saudi Arabia, in Arabic or English, and open full listing details on Aqar.",
        "translations": {
          "ar-SA": {
            "subtitle": "\u0627\u0628\u062d\u062b \u0639\u0646 \u0639\u0642\u0627\u0631\u0643 \u0641\u064a \u0627\u0644\u0633\u0639\u0648\u062f\u064a\u0629",
            "description": "\u0627\u0628\u062d\u062b \u0639\u0646 \u0639\u0642\u0627\u0631\u0627\u062a \u0644\u0644\u0625\u064a\u062c\u0627\u0631 \u0623\u0648 \u0627\u0644\u0628\u064a\u0639 \u0641\u064a \u0627\u0644\u0633\u0639\u0648\u062f\u064a\u0629 \u0639\u0628\u0631 \u0639\u0642\u0627\u0631\u060c \u0628\u0627\u0644\u0639\u0631\u0628\u064a\u0629 \u0623\u0648 \u0627\u0644\u0625\u0646\u062c\u0644\u064a\u0632\u064a\u0629. \u062a\u0635\u0641\u062d \u0628\u0637\u0627\u0642\u0627\u062a \u0627\u0644\u0625\u0639\u0644\u0627\u0646\u0627\u062a \u0628\u0627\u0644\u0635\u0648\u0631 \u0648\u0627\u0644\u0623\u0633\u0639\u0627\u0631 \u0648\u0639\u062f\u062f \u063a\u0631\u0641 \u0627\u0644\u0646\u0648\u0645 \u0648\u0627\u0644\u0645\u0633\u0627\u062d\u0629 \u0648\u0627\u0644\u062d\u064a\u060c \u0623\u0648 \u0627\u0639\u0631\u0636 \u062a\u0641\u0627\u0635\u064a\u0644 \u0625\u0639\u0644\u0627\u0646 \u0645\u062d\u062f\u062f. \u0627\u0644\u0628\u062d\u062b \u0645\u062a\u0627\u062d \u062f\u0648\u0646 \u062a\u0633\u062c\u064a\u0644 \u062f\u062e\u0648\u0644 \u0623\u0648 \u0637\u0644\u0628 \u0645\u0648\u0642\u0639\u0643 \u0627\u0644\u062f\u0642\u064a\u0642. \u0623\u0633\u0639\u0627\u0631 \u0627\u0644\u0625\u064a\u062c\u0627\u0631 \u062d\u0633\u0628 \u0641\u062a\u0631\u0629 \u0627\u0644\u0625\u064a\u062c\u0627\u0631\u060c \u0648\u063a\u0627\u0644\u0628\u0627\u064b \u0633\u0646\u0648\u064a\u0629. \u0644\u0644\u062a\u0648\u0627\u0635\u0644 \u0645\u0639 \u0627\u0644\u0645\u0639\u0644\u0646\u060c \u0627\u0641\u062a\u062d \u0631\u0627\u0628\u0637 \u0627\u0644\u0625\u0639\u0644\u0627\u0646 \u0639\u0644\u0649 \u0645\u0648\u0642\u0639 \u0639\u0642\u0627\u0631. \u0644\u0627 \u064a\u062f\u0639\u0645 \u0647\u0630\u0627 \u0627\u0644\u0645\u0643\u0648\u0646 \u0627\u0644\u062a\u0648\u0627\u0635\u0644 \u0623\u0648 \u0627\u0644\u062d\u062c\u0632 \u0623\u0648 \u0627\u0644\u062f\u0641\u0639."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}