Skip to main content
Glama

Lianex — Australian price comparison

One cached product by permalink id

lianex_product_by_safe_id
Read-onlyIdempotent

Return one cached product and any stored cross-marketplace offers. safe_id is the provider-qualified permalink ID, or a provider-less eBay ID. Unknown IDs return 404; removed public products return 410. Unavailable fields may be null. Each offer entry is one marketplace: its matched hits and last_checked, when we last checked that marketplace (ISO 8601). A hit includes in_stock: true only when its stock was confirmed. eBay listings also carry shipping (last-seen shipping cost and delivery window) and return_terms (returns accepted, window in days, who pays return postage); gtin appears when the listing's barcode passes its check digit. Products of Woolworths, Kogan, BIG W, Kmart, The Good Guys, Centre Com, Bunnings, IKEA, Harvey Norman, Mwave, PC Case Gear, Umart have an API record and a /p/ address that is not indexed (page_published: false). Cache-only.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "safe_id": "<safe_id>"
    },
    "name": "lianex_product_by_safe_id"
  }
}

Input Schema

NameRequiredDescriptionDefault
safe_idYesA product permalink id, e.g. amazon~~B0G2BFZRGL or the provider-less eBay form v1~158082631449~0 — the id of an entry from /api/public/products or of a product from /api/public/search (MCP tools lianex_products, lianex_search).

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / $defs / ProductResponse / properties / page_published
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / ProductResponse / properties / seller_lanes_pending
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
  2. Changed75 schema fields changed
    • removedOutput schema / $defs / ProductResponse / description
      Removed value: -"A cached product detail record. Unavailable values may be explicit nulls."
    • removedOutput schema / $defs / ProductResponse / properties / availability / description
      Removed value: -"`InStock` or `OutOfStock`, rolled up across every stored lane."
    • removedOutput schema / $defs / ProductResponse / properties / availability / title
      Removed value: -"Availability"
    • removedOutput schema / $defs / ProductResponse / properties / brand / description
      Removed value: -"The brand: the stored brand, else the listing's own Brand / Brand Name item specific — never a placeholder such as Unbranded."
    • removedOutput schema / $defs / ProductResponse / properties / brand / title
      Removed value: -"Brand"
    • removedOutput schema / $defs / ProductResponse / properties / browse_name / description
      Removed value: -"That category's display name, or `null`."
    • removedOutput schema / $defs / ProductResponse / properties / browse_name / title
      Removed value: -"Browse Name"
    • removedOutput schema / $defs / ProductResponse / properties / browse_slug / description
      Removed value: -"The published `/b/` category this product belongs to, or `null`."
    • removedOutput schema / $defs / ProductResponse / properties / browse_slug / title
      Removed value: -"Browse Slug"
    • removedOutput schema / $defs / ProductResponse / properties / canonical_specs / description
      Removed value: -"The merged canonical spec sheet, when one could be derived."
    • removedOutput schema / $defs / ProductResponse / properties / canonical_specs / title
      Removed value: -"Canonical Specs"
    • removedOutput schema / $defs / ProductResponse / properties / category_id / description
      Removed value: -"The marketplace category id we cached it under."
    • removedOutput schema / $defs / ProductResponse / properties / category_id / title
      Removed value: -"Category Id"
    • removedOutput schema / $defs / ProductResponse / properties / category_name / description
      Removed value: -"That category's display name."
    • removedOutput schema / $defs / ProductResponse / properties / category_name / title
      Removed value: -"Category Name"
    • removedOutput schema / $defs / ProductResponse / properties / condition / description
      Removed value: -"The stored condition label, when we recorded one."
    • removedOutput schema / $defs / ProductResponse / properties / condition / title
      Removed value: -"Condition"
    • removedOutput schema / $defs / ProductResponse / properties / currency / description
      Removed value: -"ISO currency code of `price`."
    • removedOutput schema / $defs / ProductResponse / properties / currency / title
      Removed value: -"Currency"
    • removedOutput schema / $defs / ProductResponse / properties / gtin / description
      Removed value: -"A GS1 barcode number (8, 12, 13 or 14 digits) from the listing's item specifics, included only when its check digit is valid."
    • removedOutput schema / $defs / ProductResponse / properties / gtin / title
      Removed value: -"Gtin"
    • removedOutput schema / $defs / ProductResponse / properties / id / description
      Removed value: -"The permalink id you asked for, echoed back."
    • removedOutput schema / $defs / ProductResponse / properties / id / title
      Removed value: -"Id"
    • removedOutput schema / $defs / ProductResponse / properties / image / description
      Removed value: -"The primary image URL."
    • removedOutput schema / $defs / ProductResponse / properties / image / title
      Removed value: -"Image"
    • removedOutput schema / $defs / ProductResponse / properties / images / description
      Removed value: -"Additional gallery image URLs. May be empty."
    • removedOutput schema / $defs / ProductResponse / properties / images / title
      Removed value: -"Images"
    • removedOutput schema / $defs / ProductResponse / properties / item_id / description
      Removed value: -"The marketplace's own id for this listing."
    • removedOutput schema / $defs / ProductResponse / properties / item_id / title
      Removed value: -"Item Id"
    • removedOutput schema / $defs / ProductResponse / properties / marketplace / description
      Removed value: -"The STORED locale label (`EBAY_AU`), which is not the same string as `provider`."
    • removedOutput schema / $defs / ProductResponse / properties / marketplace / title
      Removed value: -"Marketplace"
    • removedOutput schema / $defs / ProductResponse / properties / offers / description
      Removed value: -"Public-safe stored cross-marketplace offers, one entry per marketplace: marketplace, hits, and last_checked (ISO 8601, when that marketplace was last checked; absent when unknown). A hit includes in_stock: true only when its stock was confirmed. Never seller PII."
    • removedOutput schema / $defs / ProductResponse / properties / offers / title
      Removed value: -"Offers"
    • removedOutput schema / $defs / ProductResponse / properties / price / description
      Removed value: -"The price as a decimal STRING (`\"1649.00\"`), never a float — so it cannot lose cents to binary rounding on the way to you."
    • removedOutput schema / $defs / ProductResponse / properties / price / title
      Removed value: -"Price"
    • removedOutput schema / $defs / ProductResponse / properties / provider / description
      Removed value: -"The marketplace routing token: `ebay`, `amazon`, `aliexpress`, `jbhifi`, `shein`."
    • removedOutput schema / $defs / ProductResponse / properties / provider / title
      Removed value: -"Provider"
    • removedOutput schema / $defs / ProductResponse / properties / provider_disabled / description
      Removed value: -"Present and `true` only when this product's marketplace is switched off, in which case `url` is `null`. Absent otherwise."
    • removedOutput schema / $defs / ProductResponse / properties / provider_disabled / title
      Removed value: -"Provider Disabled"
    • removedOutput schema / $defs / ProductResponse / properties / return_terms / description
      Removed value: -"eBay listings only: whether returns are accepted, the return window in days, and who pays return postage. Null for other marketplaces or when unknown."
    • removedOutput schema / $defs / ProductResponse / properties / seller_task_status / description
      Removed value: -"Read-only status of any in-flight who-sells lane for this product. Reading it never schedules work."
    • removedOutput schema / $defs / ProductResponse / properties / seller_task_status / title
      Removed value: -"Seller Task Status"
    • removedOutput schema / $defs / ProductResponse / properties / shipping / description
      Removed value: -"eBay listings only: the listing's cheapest shipping option as last seen — cost, currency, cost type and the delivery-estimate window. Null for other marketplaces or when unknown."
    • removedOutput schema / $defs / ProductResponse / properties / specifics / description
      Removed value: -"The listing's own item specifics, minus empty/placeholder values."
    • removedOutput schema / $defs / ProductResponse / properties / specifics / title
      Removed value: -"Specifics"
    • removedOutput schema / $defs / ProductResponse / properties / title / description
      Removed value: -"The listing title as the marketplace states it."
    • removedOutput schema / $defs / ProductResponse / properties / title / title
      Removed value: -"Title"
    • removedOutput schema / $defs / ProductResponse / properties / updated_at / description
      Removed value: -"ISO-8601 instant this listing was last re-checked."
    • removedOutput schema / $defs / ProductResponse / properties / updated_at / title
      Removed value: -"Updated At"
    • removedOutput schema / $defs / ProductResponse / properties / url / description
      Removed value: -"The affiliate-wrapped outbound link. `null` when the marketplace is switched off."
    • removedOutput schema / $defs / ProductResponse / properties / url / title
      Removed value: -"Url"
    • removedOutput schema / $defs / ProductResponse / title
      Removed value: -"ProductResponse"
    • removedOutput schema / $defs / ReturnTerms / description
      Removed value: -"An eBay listing's return terms as last seen."
    • removedOutput schema / $defs / ReturnTerms / properties / accepted / description
      Removed value: -"Whether the seller accepts returns."
    • removedOutput schema / $defs / ReturnTerms / properties / accepted / title
      Removed value: -"Accepted"
    • removedOutput schema / $defs / ReturnTerms / properties / period_days / description
      Removed value: -"The return window in calendar days, when stated."
    • removedOutput schema / $defs / ReturnTerms / properties / period_days / title
      Removed value: -"Period Days"
    • removedOutput schema / $defs / ReturnTerms / properties / return_postage_payer / description
      Removed value: -"Who pays return postage, when stated: BUYER or SELLER."
    • removedOutput schema / $defs / ReturnTerms / properties / return_postage_payer / title
      Removed value: -"Return Postage Payer"
    • removedOutput schema / $defs / ReturnTerms / title
      Removed value: -"ReturnTerms"
    • removedOutput schema / $defs / ShippingTerms / description
      Removed value: -"An eBay listing's cheapest shipping option as last seen. Any field may be null when eBay did not state it."
    • removedOutput schema / $defs / ShippingTerms / properties / captured_at / description
      Removed value: -"ISO-8601 instant we read this delivery estimate; the estimate window is relative to it."
    • removedOutput schema / $defs / ShippingTerms / properties / captured_at / title
      Removed value: -"Captured At"
    • removedOutput schema / $defs / ShippingTerms / properties / cost / description
      Removed value: -"Shipping cost as a decimal STRING; \"0.00\" means free."
    • removedOutput schema / $defs / ShippingTerms / properties / cost / title
      Removed value: -"Cost"
    • removedOutput schema / $defs / ShippingTerms / properties / cost_type / description
      Removed value: -"eBay's shipping cost type, e.g. FIXED or CALCULATED."
    • removedOutput schema / $defs / ShippingTerms / properties / cost_type / title
      Removed value: -"Cost Type"
    • removedOutput schema / $defs / ShippingTerms / properties / currency / description
      Removed value: -"ISO currency code of `cost`."
    • removedOutput schema / $defs / ShippingTerms / properties / currency / title
      Removed value: -"Currency"
    • removedOutput schema / $defs / ShippingTerms / properties / max_delivery / description
      Removed value: -"ISO-8601 instant: the latest estimated delivery date eBay quoted when we last saw the listing. An estimate, not a promise; it can be in the past."
    • removedOutput schema / $defs / ShippingTerms / properties / max_delivery / title
      Removed value: -"Max Delivery"
    • removedOutput schema / $defs / ShippingTerms / properties / min_delivery / description
      Removed value: -"ISO-8601 instant: the earliest estimated delivery date eBay quoted when we last saw the listing. An estimate, not a promise; it can be in the past."
    • removedOutput schema / $defs / ShippingTerms / properties / min_delivery / title
      Removed value: -"Min Delivery"
    • removedOutput schema / $defs / ShippingTerms / title
      Removed value: -"ShippingTerms"
    • removedOutput schema / title
      Removed value: -"Response Public Product Api Public Product  Safe Id  Get"
  3. Changed1 schema field changed
    • addedInput schema / properties / safe_id / description
      Added value: +"A product permalink id, e.g. amazon~~B0G2BFZRGL or the provider-less eBay form v1~158082631449~0 — the id of an entry from /api/public/products or of a product from /api/public/search (MCP tools lianex_products, lianex_search)."
  4. First observed

TDQS

A4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With annotations already covering read-only/idempotent/closed-world, the description still adds substantial behavioral context: 404 for unknown IDs, 410 for removed public products, null for unavailable fields, and cache-only serving. It also explains non-obvious semantics like in_stock being true only on confirmed stock and last_checked being an ISO 8601 marketplace-check timestamp.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose is front-loaded in the first sentence, but the body becomes a dense run-on that documents return-field details (shipping, return_terms, gtin) already available in the output schema. The enumeration of twelve retailers with `page_published: false` is informative but disproportionately heavy for a description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter cached lookup, the definition covers everything an agent needs: input ID provenance, error status codes, nullability, cache-only serving, and the semantics of the offer/hit fields. With an output schema present, the extra return-field notes are surplus rather than necessary, so nothing material is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning beyond the schema by clarifying that safe_id may be provider-qualified (amazon~~B0G2BFZRGL) or a provider-less eBay form, i.e., two accepted shapes of the same parameter. It stops short of stating validation rules for malformed IDs beyond the 404/410 outcomes.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Return one cached product and any stored cross-marketplace offers" gives a specific verb, resource, and cardinality, which separates it from list/search siblings like lianex_products and lianex_search. It further scopes itself with "Cache-only." The only gap is that it does not explicitly contrast itself with lianex_browse_by_slug or lianex_resolve_compare, which also resolve products.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: the safe_id parameter description tells the agent the ID comes from lianex_products or lianex_search, which effectively positions this as a follow-up lookup. However, there is no explicit when-to-use/when-not guidance and no named alternative for resolving a product by URL or slug, leaving that routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources