bestprice.gr

{
  "name": "search_bestprice",
  "kind": "act",
  "impl": "imperative",
  "description": "Finds products by name, brand, model or category in BestPrice’s catalog; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 2,
        "maxLength": 120,
        "description": "A product name, brand, model or category, in Greek or English."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 8,
        "description": "Maximum results to return, from 1 to 8. Defaults to 6."
      },
      "min_price_eur": {
        "type": "number",
        "minimum": 0,
        "maximum": 10000000,
        "description": "Only products from this price in euros (item price before shipping)."
      },
      "max_price_eur": {
        "type": "number",
        "minimum": 0.01,
        "maximum": 10000000,
        "description": "Only products up to this price in euros (item price before shipping)."
      },
      "sort": {
        "type": "string",
        "enum": [
          "relevance",
          "price_asc",
          "price_desc",
          "biggest_price_drop",
          "most_stores",
          "newest"
        ],
        "description": "Result order. relevance is the default; newest, biggest_price_drop and most_stores only where offered."
      },
      "in_stock_only": {
        "type": "boolean",
        "description": "Only products a store has in stock now. Defaults to false."
      },
      "deals_only": {
        "type": "boolean",
        "description": "Only products priced below their earlier price. Defaults to false."
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_search_results",
  "kind": "act",
  "impl": "imperative",
  "description": "Opens a search’s results_url in this tab, so the shopper sees those results.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "results_url": {
        "type": "string",
        "minLength": 1,
        "maxLength": 2048,
        "description": "A results_url exactly as a search returned it."
      }
    },
    "required": [
      "results_url"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "open_product",
  "kind": "act",
  "impl": "imperative",
  "description": "Opens a product’s BestPrice page in this tab by product_id.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "required": [
      "product_id"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_shopping_list",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists the products in the shopper’s shopping list; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "description": "Products to return, from 1 to 20. Defaults to 10."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result to read on. Defaults to 0."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_shopping_decision",
  "kind": "answer",
  "impl": "imperative",
  "description": "Recommends what to buy for a described need or budget, with alternatives and reasons; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "message": {
        "type": "string",
        "minLength": 1,
        "maxLength": 2000,
        "description": "The shopper’s need in their own words, e.g. a phone for photos; budget and must-haves go in their own fields."
      },
      "max_price_eur": {
        "type": "number",
        "minimum": 0.01,
        "maximum": 10000000,
        "description": "Highest item price in euros the shopper will pay."
      },
      "must_have": {
        "type": "array",
        "minItems": 1,
        "maxItems": 6,
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40
        },
        "description": "Features the pick must have, one per item, e.g. NFC."
      },
      "postal_code": {
        "type": "string",
        "pattern": "^(?:[1-7][0-9]{4}|8[0-5][0-9]{3})$",
        "description": "Optional five-digit Greek delivery postcode the shopper gave; adds shipping and delivered totals."
      }
    },
    "required": [
      "message"
    ],
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "get_visible_products",
  "kind": "act",
  "impl": "imperative",
  "description": "Lists the product cards shown on this page; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 8,
        "description": "Maximum products to return, up to 8 per call; next_offset continues."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result on this page. Defaults to 0."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "name": "load_more_products",
  "kind": "act",
  "impl": "imperative",
  "description": "Loads the next page of results into this listing, as scrolling does.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/cat/806/mobile-phones.html"
}

{
  "name": "get_listing_filters",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists this listing’s filters, their values and its sort options; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "group": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "description": "A filter key or name from a previous call; returns that filter with all of its values."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result with the same group, or none. Defaults to 0."
      }
    },
    "additionalProperties": false
  },
  "page": "/cat/806/mobile-phones.html"
}

{
  "name": "apply_listing_filter",
  "kind": "act",
  "impl": "imperative",
  "description": "Applies one filter value to this listing and reloads it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "filter": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "description": "A filter name or key as get_listing_filters returned it."
      },
      "value": {
        "type": "string",
        "minLength": 1,
        "maxLength": 72,
        "description": "A value as get_listing_filters returned it; a unique part of it also works."
      }
    },
    "required": [
      "filter",
      "value"
    ],
    "additionalProperties": false
  },
  "page": "/cat/806/mobile-phones.html"
}

{
  "name": "clear_listing_filters",
  "kind": "act",
  "impl": "imperative",
  "description": "Removes one filter value, one filter or every filter from this listing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "filter": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "description": "Remove only this filter (name or key from get_listing_filters). Without it, every filter goes."
      },
      "value": {
        "type": "string",
        "minLength": 1,
        "maxLength": 72,
        "description": "With filter: remove only this selected value of it."
      }
    },
    "additionalProperties": false
  },
  "page": "/cat/806/mobile-phones.html"
}

{
  "name": "apply_listing_sort",
  "kind": "act",
  "impl": "imperative",
  "description": "Sorts this listing by a sort key or option label.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sort": {
        "type": "string",
        "minLength": 1,
        "maxLength": 72,
        "description": "A sort key or option label from get_listing_filters; a unique part of a label also works."
      }
    },
    "required": [
      "sort"
    ],
    "additionalProperties": false
  },
  "page": "/cat/806/mobile-phones.html"
}

{
  "name": "get_page_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Reads the product on this page: id, title, lowest price, store count and rating; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "compare_page_offers",
  "kind": "act",
  "impl": "imperative",
  "description": "Ranks this product’s store offers by delivered price, item plus shipping; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 12,
        "description": "Offers to return, from 1 to 12. Defaults to 4."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result to read the next offers. Defaults to 0."
      },
      "include_all_stores": {
        "type": "boolean",
        "description": "First load every store this page holds back, as its all-prices button does. Defaults to false."
      },
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "get_product_specifications",
  "kind": "answer",
  "impl": "imperative",
  "description": "Reads this product’s specifications, all or by section or fact; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "section": {
        "type": "string",
        "minLength": 1,
        "maxLength": 48,
        "description": "all, or a section name in English or Greek as a previous call returned it, e.g. Display or Οθόνη."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 16,
        "description": "Maximum number of specification facts to return, from 1 to 16."
      },
      "fact": {
        "type": "string",
        "minLength": 1,
        "maxLength": 72,
        "description": "A fact name a previous call returned, or a common English one such as screen size or weight."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result with the same section. Defaults to 0; not with fact."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "summarize_price_history",
  "kind": "answer",
  "impl": "imperative",
  "description": "Summarizes this product’s price history and trend; show_chart also shows the chart.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "show_chart": {
        "type": "boolean",
        "description": "Also open or scroll to the price-history chart on this page for the shopper. Defaults to false."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "show_offer",
  "kind": "act",
  "impl": "imperative",
  "description": "Scrolls to one store offer on this page and highlights it; opens no store site.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "offer_ref": {
        "type": "string",
        "minLength": 8,
        "maxLength": 40,
        "description": "Pass offer_ref (from compare_page_offers) or, failing that, merchant_name. Refused once that offer changes."
      },
      "merchant_name": {
        "type": "string",
        "minLength": 2,
        "maxLength": 68,
        "description": "Only without offer_ref: the store name exactly as compare_page_offers returned it, for one offer."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "add_to_shopping_list",
  "kind": "act",
  "impl": "imperative",
  "description": "Adds this page’s product to the shopper’s shopping list; never removes one.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "remove_from_shopping_list",
  "kind": "act",
  "impl": "imperative",
  "description": "Removes this page’s product from the shopper’s shopping list; never adds one.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "get_comparison",
  "kind": "answer",
  "impl": "imperative",
  "description": "Lists the products in the shopper’s comparisons, per category; changes nothing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Use next_offset from the previous result to read more categories. Defaults to 0."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "add_to_comparison",
  "kind": "act",
  "impl": "imperative",
  "description": "Adds this page’s product to the shopper’s side-by-side comparison for its category; never removes one.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "remove_from_comparison",
  "kind": "act",
  "impl": "imperative",
  "description": "Removes this page’s product from the shopper’s side-by-side comparison for its category; never adds one.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}

{
  "name": "open_price_alert",
  "kind": "answer",
  "impl": "imperative",
  "description": "Opens this product’s price-drop alert dialog; the shopper sets and saves the alert there.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "product_id": {
        "type": "string",
        "pattern": "^\\d{1,20}$",
        "description": "Numeric BestPrice product id, as any tool returns it."
      }
    },
    "additionalProperties": false
  },
  "page": "/item/2159919913/apple-iphone-16-128gb.html"
}