Joinville Boas Ofertas
Preços e ofertas vigentes de supermercados de Joinville/SC, revisados antes de publicar. Só leitura.
Should I use this
Quality & Safety
B
Findings (4)
- LOWTool 'find_cheapest' description lacks action verbin find_cheapest
- LOWTool 'get_offer' description lacks action verbin get_offer
- LOWTool 'search' description lacks action verbin search
- LOWTool 'fetch' suggests web access but openWorldHint=falsein fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~14,558Tokens (tool definitions)
~14.5 KBTypical response size
Significant attention impact (11.37% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"ofertas": {
"url": "https://mcp.joinvilleboasofertas.com/mcp"
}
}
}Remote endpoints
https://mcp.joinvilleboasofertas.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_offers(query, category, market, max_price, ending_today, ...)
Busca ofertas por produto, categoria, mercado, preço máximo ou vencimento hoje, com paginação; passe o mercado em market, não no texto. Devolve só ofertas vigentes hoje, salvo include_expired=true. sort: relevance (padrão com texto), price (menor preço), savings (maior economia) ou recent (mais recentes). Exemplos: "ofertas de café", "arroz 5 kg até R$ 25 no Fort", "o que vence hoje" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Texto da busca (produto).",
"title": "Query"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Slug ou nome da categoria (veja list_categories).",
"title": "Category"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "slug, id ou nome do mercado",
"title": "Market"
},
"max_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Preço máximo em reais (maior que zero).",
"title": "Max Price"
},
"ending_today": {
"default": false,
"description": "Só ofertas que vencem hoje.",
"title": "Ending Today",
"type": "boolean"
},
"include_expired": {
"default": false,
"description": "Inclui ofertas vencidas (marcadas em validity.status).",
"title": "Include Expired",
"type": "boolean"
},
"sort": {
"anyOf": [
{
"enum": [
"relevance",
"price",
"savings",
"recent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Ordem: relevance (relevância), price (menor preço), savings (maior economia) ou recent (mais recentes).",
"title": "Sort"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor da página anterior, para continuar.",
"title": "Cursor"
},
"page_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "1–30, padrão 10",
"title": "Page Size"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"title": "search_offersArguments"
}Output Schema
{
"type": "object",
"properties": {
"interpretation": {
"$ref": "#/$defs/InterpretationOut"
},
"items": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Items",
"type": "array"
},
"total_count": {
"title": "Total Count",
"type": "integer"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next Cursor"
},
"no_result": {
"title": "No Result",
"type": "boolean"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"interpretation",
"items",
"total_count",
"next_cursor",
"no_result",
"meta"
],
"$defs": {
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"InterpretationOut": {
"additionalProperties": false,
"description": "Como a consulta do usuário foi interpretada.",
"properties": {
"kind": {
"title": "Kind",
"type": "string"
},
"query": {
"title": "Query",
"type": "string"
},
"category_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category Slug"
},
"search_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Mode"
},
"category_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Name"
},
"ending_today": {
"default": false,
"title": "Ending Today",
"type": "boolean"
},
"include_expired": {
"default": false,
"title": "Include Expired",
"type": "boolean"
},
"market_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Market Id"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Id"
}
},
"required": [
"kind",
"query",
"category_slug",
"search_mode"
],
"title": "InterpretationOut",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da busca de ofertas.",
"title": "SearchOffersOut"
}🟢find_cheapest(query, category, limit, alternatives, region)
Encontra o menor preço de um produto ou tipo de produto, agrupado por produto, com alternativas em outros mercados. Considera só ofertas vigentes hoje. Exemplos: "onde comprar carne mais barato hoje", "menor preço do leite" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Produto ou tipo de produto.",
"title": "Query",
"type": "string"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Slug ou nome da categoria (veja list_categories).",
"title": "Category"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Quantidade de itens: 1–30, padrão 10",
"title": "Limit"
},
"alternatives": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "0–5, padrão 3: alternativas de outros mercados por produto",
"title": "Alternatives"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"required": [
"query"
],
"title": "find_cheapestArguments"
}Output Schema
{
"type": "object",
"properties": {
"interpretation": {
"$ref": "#/$defs/InterpretationOut"
},
"groups": {
"items": {
"$ref": "#/$defs/CheapestGroup"
},
"title": "Groups",
"type": "array"
},
"no_result": {
"title": "No Result",
"type": "boolean"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"interpretation",
"groups",
"no_result",
"meta"
],
"$defs": {
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"CheapestGroup": {
"additionalProperties": false,
"description": "Grupo de um produto com a oferta mais barata e alternativas.",
"properties": {
"product": {
"$ref": "#/$defs/ProductRef"
},
"cheapest": {
"$ref": "#/$defs/OfferItem"
},
"alternatives": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Alternatives",
"type": "array"
},
"markets_count": {
"title": "Markets Count",
"type": "integer"
}
},
"required": [
"product",
"cheapest",
"alternatives",
"markets_count"
],
"title": "CheapestGroup",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"InterpretationOut": {
"additionalProperties": false,
"description": "Como a consulta do usuário foi interpretada.",
"properties": {
"kind": {
"title": "Kind",
"type": "string"
},
"query": {
"title": "Query",
"type": "string"
},
"category_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category Slug"
},
"search_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Mode"
},
"category_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Name"
},
"ending_today": {
"default": false,
"title": "Ending Today",
"type": "boolean"
},
"include_expired": {
"default": false,
"title": "Include Expired",
"type": "boolean"
},
"market_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Market Id"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Id"
}
},
"required": [
"kind",
"query",
"category_slug",
"search_mode"
],
"title": "InterpretationOut",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da busca do menor preço.",
"title": "FindCheapestOut"
}🟢compare_product(product, market, region)
Compara um produto específico (slug, id ou texto) entre os mercados, do mais barato ao mais caro, com a média e os últimos preços conhecidos. Ofertas vigentes hoje; last_known traz vencidas há até 30 dias de mercados sem oferta vigente. Exemplos: "compare o óleo Coamo 900 ml entre mercados", "preço do leite Tirol" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"product": {
"description": "Produto: slug, id ou texto (nome, marca, volume).",
"title": "Product",
"type": "string"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "slug, id ou nome do mercado",
"title": "Market"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"required": [
"product"
],
"title": "compare_productArguments"
}Output Schema
{
"type": "object",
"properties": {
"product": {
"$ref": "#/$defs/ProductRef"
},
"active_offers": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Active Offers",
"type": "array"
},
"cheapest": {
"anyOf": [
{
"$ref": "#/$defs/OfferItem"
},
{
"type": "null"
}
]
},
"average": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Average"
},
"last_known": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Last Known",
"type": "array"
},
"other_candidates": {
"items": {
"$ref": "#/$defs/Candidate"
},
"title": "Other Candidates",
"type": "array"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"product",
"active_offers",
"cheapest",
"average",
"last_known",
"other_candidates",
"meta"
],
"$defs": {
"Candidate": {
"additionalProperties": false,
"description": "Produto candidato alternativo.",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"slug",
"title"
],
"title": "Candidate",
"type": "object"
},
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da comparação de um produto entre mercados.",
"title": "CompareProductOut"
}🟢top_deals(category, market, ending_today, limit, region)
Lista as melhores ofertas pela economia em relação à média, no geral, por categoria ou por mercado. Considera só ofertas vigentes hoje. Exemplos: "melhores ofertas agora", "melhores ofertas de bebidas", "o que o Giassi tem de bom hoje" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Slug ou nome da categoria (veja list_categories).",
"title": "Category"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "slug, id ou nome do mercado",
"title": "Market"
},
"ending_today": {
"default": false,
"description": "Só ofertas que vencem hoje.",
"title": "Ending Today",
"type": "boolean"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Quantidade de itens: 1–30, padrão 10",
"title": "Limit"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"title": "top_dealsArguments"
}Output Schema
{
"type": "object",
"properties": {
"items": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Items",
"type": "array"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"items",
"meta"
],
"$defs": {
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída das melhores ofertas.",
"title": "TopDealsOut"
}🟢list_markets(query, with_active_only, region)
Lista os mercados cobertos com endereços e quantidade de ofertas; use query para confirmar o nome de um mercado. Sem query, por padrão só mercados com oferta vigente hoje (with_active_only=true); com query, devolve o mercado mesmo sem oferta vigente e avisa em meta.notices. Exemplos: "quais mercados vocês cobrem", "endereço do Fort" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Texto da busca (produto).",
"title": "Query"
},
"with_active_only": {
"default": true,
"description": "Só mercados com oferta vigente hoje; ignorado quando query é informada.",
"title": "With Active Only",
"type": "boolean"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"title": "list_marketsArguments"
}Output Schema
{
"type": "object",
"properties": {
"markets": {
"items": {
"$ref": "#/$defs/MarketInfo"
},
"title": "Markets",
"type": "array"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"markets",
"meta"
],
"$defs": {
"Branch": {
"additionalProperties": false,
"description": "Filial de um mercado.",
"properties": {
"address": {
"title": "Address",
"type": "string"
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lat"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lng"
},
"phones": {
"items": {
"$ref": "#/$defs/Phone"
},
"title": "Phones",
"type": "array"
},
"google_place_id": {
"title": "Google Place Id",
"type": "string"
}
},
"required": [
"address",
"lat",
"lng",
"phones",
"google_place_id"
],
"title": "Branch",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"MarketInfo": {
"additionalProperties": false,
"description": "Dados de um mercado com filiais e volume de ofertas.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"addresses": {
"items": {
"$ref": "#/$defs/Branch"
},
"title": "Addresses",
"type": "array"
},
"active_offers_count": {
"title": "Active Offers Count",
"type": "integer"
},
"last_encarte_at": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Encarte At"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url",
"addresses",
"active_offers_count",
"last_encarte_at"
],
"title": "MarketInfo",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"Phone": {
"additionalProperties": false,
"description": "Telefone de uma filial.",
"properties": {
"number": {
"title": "Number",
"type": "string"
},
"is_whatsapp": {
"title": "Is Whatsapp",
"type": "boolean"
}
},
"required": [
"number",
"is_whatsapp"
],
"title": "Phone",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da listagem de mercados.",
"title": "ListMarketsOut"
}🟢get_market(market, category, sort, cursor, page_size, ...)
Mostra um mercado (slug, id ou nome): endereços, destaques, categorias e ofertas paginadas. Considera só ofertas vigentes hoje. sort: relevance, price (menor preço), savings (maior economia) ou recent (padrão, mais recentes). Exemplos: "ofertas do Angeloni", "o que tem no Cooper" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"market": {
"description": "slug, id ou nome do mercado",
"title": "Market",
"type": "string"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Slug ou nome da categoria (veja list_categories).",
"title": "Category"
},
"sort": {
"anyOf": [
{
"enum": [
"relevance",
"price",
"savings",
"recent"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Ordem: relevance (relevância), price (menor preço), savings (maior economia) ou recent (mais recentes).",
"title": "Sort"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor da página anterior, para continuar.",
"title": "Cursor"
},
"page_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "1–30, padrão 10",
"title": "Page Size"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"required": [
"market"
],
"title": "get_marketArguments"
}Output Schema
{
"type": "object",
"properties": {
"market": {
"$ref": "#/$defs/MarketInfo"
},
"highlights": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Highlights",
"type": "array"
},
"categories": {
"items": {
"$ref": "#/$defs/CategoryCount"
},
"title": "Categories",
"type": "array"
},
"items": {
"items": {
"$ref": "#/$defs/OfferItem"
},
"title": "Items",
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next Cursor"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"market",
"highlights",
"categories",
"items",
"next_cursor",
"meta"
],
"$defs": {
"Branch": {
"additionalProperties": false,
"description": "Filial de um mercado.",
"properties": {
"address": {
"title": "Address",
"type": "string"
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lat"
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Lng"
},
"phones": {
"items": {
"$ref": "#/$defs/Phone"
},
"title": "Phones",
"type": "array"
},
"google_place_id": {
"title": "Google Place Id",
"type": "string"
}
},
"required": [
"address",
"lat",
"lng",
"phones",
"google_place_id"
],
"title": "Branch",
"type": "object"
},
"CategoryCount": {
"additionalProperties": false,
"description": "Categoria com contagem de ofertas e mercados.",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"active_offers_count": {
"title": "Active Offers Count",
"type": "integer"
},
"markets_count": {
"title": "Markets Count",
"type": "integer"
}
},
"required": [
"slug",
"name",
"active_offers_count",
"markets_count"
],
"title": "CategoryCount",
"type": "object"
},
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"MarketInfo": {
"additionalProperties": false,
"description": "Dados de um mercado com filiais e volume de ofertas.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"addresses": {
"items": {
"$ref": "#/$defs/Branch"
},
"title": "Addresses",
"type": "array"
},
"active_offers_count": {
"title": "Active Offers Count",
"type": "integer"
},
"last_encarte_at": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Encarte At"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url",
"addresses",
"active_offers_count",
"last_encarte_at"
],
"title": "MarketInfo",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Phone": {
"additionalProperties": false,
"description": "Telefone de uma filial.",
"properties": {
"number": {
"title": "Number",
"type": "string"
},
"is_whatsapp": {
"title": "Is Whatsapp",
"type": "boolean"
}
},
"required": [
"number",
"is_whatsapp"
],
"title": "Phone",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída dos detalhes de um mercado.",
"title": "GetMarketOut"
}🟢list_categories(region)
Lista as categorias de produto com a quantidade de ofertas e de mercados. Conta só ofertas vigentes hoje. Exemplos: "que tipos de produto existem", "quais categorias têm ofertas" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"title": "list_categoriesArguments"
}Output Schema
{
"type": "object",
"properties": {
"categories": {
"items": {
"$ref": "#/$defs/CategoryCount"
},
"title": "Categories",
"type": "array"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"categories",
"meta"
],
"$defs": {
"CategoryCount": {
"additionalProperties": false,
"description": "Categoria com contagem de ofertas e mercados.",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"active_offers_count": {
"title": "Active Offers Count",
"type": "integer"
},
"markets_count": {
"title": "Markets Count",
"type": "integer"
}
},
"required": [
"slug",
"name",
"active_offers_count",
"markets_count"
],
"title": "CategoryCount",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da listagem de categorias.",
"title": "ListCategoriesOut"
}🟢basic_basket(market, region)
Calcula o custo da cesta básica por mercado; com market, detalha os itens daquele mercado. Usa os preços vigentes do último cálculo (computed_at). Exemplos: "cesta básica mais barata", "quanto custa a cesta no Bistek" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "slug, id ou nome do mercado",
"title": "Market"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "só joinville por enquanto",
"title": "Region"
}
},
"title": "basic_basketArguments"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"title": "Status",
"type": "string"
},
"computed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Computed At"
},
"items": {
"items": {
"$ref": "#/$defs/BasketItemOut"
},
"title": "Items",
"type": "array"
},
"markets": {
"items": {
"$ref": "#/$defs/BasketMarketOut"
},
"title": "Markets",
"type": "array"
},
"lines": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/BasketLineOut"
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Lines"
},
"average": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Average"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"status",
"computed_at",
"items",
"markets",
"lines",
"average",
"meta"
],
"$defs": {
"BasketItemOut": {
"additionalProperties": false,
"description": "Item da cesta básica.",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"volume_value": {
"title": "Volume Value",
"type": "string"
},
"volume_unit": {
"title": "Volume Unit",
"type": "string"
}
},
"required": [
"id",
"name",
"volume_value",
"volume_unit"
],
"title": "BasketItemOut",
"type": "object"
},
"BasketLineOut": {
"additionalProperties": false,
"description": "Linha da cesta básica (item escolhido e seu custo).",
"properties": {
"item_name": {
"title": "Item Name",
"type": "string"
},
"source": {
"title": "Source",
"type": "string"
},
"neighbor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Neighbor Name"
},
"product_name": {
"title": "Product Name",
"type": "string"
},
"product_slug": {
"title": "Product Slug",
"type": "string"
},
"offer_id": {
"title": "Offer Id",
"type": "string"
},
"line_cost": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Line Cost"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
}
},
"required": [
"item_name",
"source",
"neighbor_name",
"product_name",
"product_slug",
"offer_id",
"line_cost",
"unit_price",
"unit_price_base"
],
"title": "BasketLineOut",
"type": "object"
},
"BasketMarketOut": {
"additionalProperties": false,
"description": "Total da cesta básica em um mercado.",
"properties": {
"establishment_id": {
"title": "Establishment Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
},
"status": {
"title": "Status",
"type": "string"
},
"total": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Total"
},
"own_count": {
"title": "Own Count",
"type": "integer"
},
"item_count": {
"title": "Item Count",
"type": "integer"
}
},
"required": [
"establishment_id",
"name",
"slug",
"url",
"status",
"total",
"own_count",
"item_count"
],
"title": "BasketMarketOut",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da cesta básica.",
"title": "BasicBasketOut"
}🟢get_offer(offer_id)
Mostra o detalhe completo de uma oferta já devolvida por outra ferramenta, com o encarte de origem. Exemplos: "mais detalhes dessa oferta", "qual o encarte dessa oferta" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"offer_id": {
"description": "offer_id (UUID) devolvido por outra ferramenta.",
"title": "Offer Id",
"type": "string"
}
},
"required": [
"offer_id"
],
"title": "get_offerArguments"
}Output Schema
{
"type": "object",
"properties": {
"offer": {
"$ref": "#/$defs/OfferItem"
},
"encarte": {
"$ref": "#/$defs/EncarteRef"
},
"meta": {
"$ref": "#/$defs/Meta"
}
},
"required": [
"offer",
"encarte",
"meta"
],
"$defs": {
"CategoryRef": {
"additionalProperties": false,
"description": "Referência a uma categoria.",
"properties": {
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Slug"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"required": [
"slug",
"name"
],
"title": "CategoryRef",
"type": "object"
},
"Coverage": {
"additionalProperties": false,
"description": "Cobertura atual do catálogo público.",
"properties": {
"markets_with_active_offers": {
"title": "Markets With Active Offers",
"type": "integer"
},
"active_offers": {
"title": "Active Offers",
"type": "integer"
}
},
"required": [
"markets_with_active_offers",
"active_offers"
],
"title": "Coverage",
"type": "object"
},
"EncarteRef": {
"additionalProperties": false,
"description": "Referência a um encarte.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
}
},
"required": [
"id",
"url",
"image_url"
],
"title": "EncarteRef",
"type": "object"
},
"MarketRef": {
"additionalProperties": false,
"description": "Referência a um mercado.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"loyalty_program_name": {
"title": "Loyalty Program Name",
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url"
}
},
"required": [
"id",
"slug",
"name",
"loyalty_program_name",
"url"
],
"title": "MarketRef",
"type": "object"
},
"Meta": {
"additionalProperties": false,
"description": "Identificação da fonte e da cobertura anexada a toda resposta.",
"properties": {
"source": {
"title": "Source",
"type": "string"
},
"source_url": {
"title": "Source Url",
"type": "string"
},
"region": {
"title": "Region",
"type": "string"
},
"as_of": {
"format": "date",
"title": "As Of",
"type": "string"
},
"generated_at": {
"format": "date-time",
"title": "Generated At",
"type": "string"
},
"coverage": {
"$ref": "#/$defs/Coverage"
},
"notices": {
"items": {
"type": "string"
},
"title": "Notices",
"type": "array"
}
},
"required": [
"source",
"source_url",
"region",
"as_of",
"generated_at",
"coverage",
"notices"
],
"title": "Meta",
"type": "object"
},
"OfferItem": {
"additionalProperties": false,
"description": "Oferta pública pronta para consumo por um assistente.",
"properties": {
"offer_id": {
"format": "uuid",
"title": "Offer Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"product": {
"$ref": "#/$defs/ProductRef"
},
"market": {
"$ref": "#/$defs/MarketRef"
},
"price_label": {
"title": "Price Label",
"type": "string"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Price"
},
"club_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Club Price"
},
"price_type": {
"enum": [
"regular",
"club"
],
"title": "Price Type",
"type": "string"
},
"pricing": {
"$ref": "#/$defs/Pricing"
},
"promotion": {
"title": "Promotion",
"type": "string"
},
"quantity_discount": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Quantity Discount"
},
"unit_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Unit Price"
},
"unit_price_base": {
"title": "Unit Price Base",
"type": "string"
},
"avg_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Avg Price"
},
"diff_percent": {
"title": "Diff Percent",
"type": "number"
},
"savings_label": {
"title": "Savings Label",
"type": "string"
},
"validity": {
"$ref": "#/$defs/Validity"
},
"addresses": {
"items": {
"type": "string"
},
"title": "Addresses",
"type": "array"
},
"only_at_addresses": {
"title": "Only At Addresses",
"type": "boolean"
},
"url": {
"title": "Url",
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Url"
},
"encarte_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Encarte Url"
},
"recorded_at": {
"format": "date-time",
"title": "Recorded At",
"type": "string"
}
},
"required": [
"offer_id",
"title",
"product",
"market",
"price_label",
"price",
"club_price",
"price_type",
"pricing",
"promotion",
"quantity_discount",
"unit_price",
"unit_price_base",
"avg_price",
"diff_percent",
"savings_label",
"validity",
"addresses",
"only_at_addresses",
"url",
"image_url",
"encarte_url",
"recorded_at"
],
"title": "OfferItem",
"type": "object"
},
"Pricing": {
"additionalProperties": false,
"description": "Base de cobrança do preço (unidade, lote, referência).",
"properties": {
"basis": {
"title": "Basis",
"type": "string"
},
"lot_quantity": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Lot Quantity"
},
"reference": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Reference"
}
},
"required": [
"basis",
"lot_quantity",
"reference"
],
"title": "Pricing",
"type": "object"
},
"ProductRef": {
"additionalProperties": false,
"description": "Referência a um produto.",
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"brand": {
"title": "Brand",
"type": "string"
},
"quantity_label": {
"title": "Quantity Label",
"type": "string"
},
"category": {
"anyOf": [
{
"$ref": "#/$defs/CategoryRef"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"brand",
"quantity_label",
"category"
],
"title": "ProductRef",
"type": "object"
},
"Validity": {
"additionalProperties": false,
"description": "Validade da oferta com status e rótulo legível.",
"properties": {
"starts_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Starts On"
},
"ends_on": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"title": "Ends On"
},
"status": {
"title": "Status",
"type": "string"
},
"label": {
"title": "Label",
"type": "string"
}
},
"required": [
"starts_on",
"ends_on",
"status",
"label"
],
"title": "Validity",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída dos detalhes de uma oferta.",
"title": "GetOfferOut"
}🟢search(query)
Busca ofertas vigentes e devolve até 20 resultados com id, título (preço, mercado e validade) e url; segue o contrato do conector do ChatGPT. Considera só ofertas vigentes hoje. Exemplos: "ofertas de café", "cerveja em promoção" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Texto da busca (produto).",
"title": "Query",
"type": "string"
}
},
"required": [
"query"
],
"title": "searchArguments"
}Output Schema
{
"type": "object",
"properties": {
"results": {
"items": {
"$ref": "#/$defs/ChatgptResult"
},
"title": "Results",
"type": "array"
}
},
"required": [
"results"
],
"$defs": {
"ChatgptResult": {
"additionalProperties": false,
"description": "Resultado de busca no formato do ChatGPT.",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"title": "ChatgptResult",
"type": "object"
}
},
"additionalProperties": false,
"description": "Saída da ferramenta search do ChatGPT.\n\n_items guarda as ofertas completas por trás dos resultados (mercado, produto,\npreço) para o registro das aparições; é privado, fica fora do outputSchema e\ndo JSON, e sobrevive ao pickle do cache de resultados.",
"title": "ChatgptSearchOut"
}🟢fetch(id)
Devolve o texto completo de uma oferta pelo id vindo de search; segue o contrato do conector do ChatGPT. Exemplos: "detalhe da oferta", "endereço do mercado dessa oferta" Cobertura: só Joinville/SC, Brasil; não serve para outras cidades. Só consulta: não vende, não reserva nem entrega produtos.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "id (offer_id) devolvido por search.",
"title": "Id",
"type": "string"
}
},
"required": [
"id"
],
"title": "fetchArguments"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"text": {
"title": "Text",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"additionalProperties": false,
"description": "Saída da ferramenta fetch do ChatGPT.",
"title": "ChatgptFetchOut"
}Community
Evidence
Recent observations
verifiedversion not recorded11 tools