global_search
ActiveTool of io.github.giuseppesocci-bot/kalicart-global
Search the KaliCart Global federated index: real product offers across independent WooCommerce merchants that opted in via the ARC (Agent-Readable Catalog) protocol. Returns merchant-authoritative prices, UCP availability_status, storefront URLs and canonical category leaves. Provide q (free text) and/or leaf (canonical category). Spec: https://bridge.kalicart.com/spec/
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Free-text product query matched against native merchant catalog text; no server-side translation. Translate when needed, or use leaf and canonical filters for language-neutral retrieval."
},
"leaf": {
"type": "string",
"description": "Canonical category leaf (e.g. beverages.alcohol.sparkling_prosecco)"
},
"brand": {
"type": "string",
"description": "Brand facet filter (normalized, e.g. \"nike\")"
},
"color": {
"type": "string",
"description": "Color family (e.g. \"blue\")"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max offers to return (1-25, default 10). No pagination; raise to get more in one call"
},
"gender": {
"enum": [
"male",
"female",
"unisex",
"kids"
],
"type": "string",
"description": "Gender facet (normalized): male, female, unisex, kids"
},
"in_stock": {
"type": "boolean",
"description": "Only offers with availability_status=in_stock"
},
"max_price": {
"type": "number",
"description": "Maximum price filter (numeric; per-offer merchant currency, no FX conversion)"
},
"min_price": {
"type": "number",
"description": "Minimum price filter (numeric; per-offer merchant currency, no FX conversion)"
}
},
"additionalProperties": false
}Parent server
io.github.giuseppesocci-bot/kalicart-global
1/7 registries