Pechincha.ai
Brazilian deals: search active promos, coupons and price history from Brazilian online stores.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (4)
- HIGH
- MEDIUMin get_list
- LOWin list_store_coupons
- LOWin check_product_url
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"deals": {
"url": "https://pechincha.ai/mcp"
}
}
}Remote-Endpunkte
https://pechincha.ai/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (14)
🟢search_deals(query, store, category, theme, min_price, ...)
Search active (not expired) deals on Pechincha.ai, 10 per page by default (`limit` up to 25); with `query` the most relevant come first, without it the newest, unless `sort` says otherwise. Each result has price and old price in BRL, discount %, store, coupon code if any, publication date, the deal page URL and the product photo URL. Content is Brazilian Portuguese, so search in Portuguese: `query` matches whole words (and their start: "celular" finds "celulares") plus meaning ("blusa de frio" finds hoodies), so describe the item in a few words, e.g. "moletom de capuz azul"; with 3+ words one may be missing. Accessories that mention the term also match ("notebook" returns backpacks and cables too), so check titles. For a budget ("até R$ 3.000"), pass `max_price`; for a floor or a range ("entre R$ 100 e R$ 200"), pass `min_price` too. For seasonal events, gift ideas and niches (Black Friday, Dia das Crianças...), pass `theme` from list_themes.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Words describing the item, e.g. \"air fryer\" or \"moletom de capuz azul\""
},
"store": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "Store slug from list_stores, e.g. \"amazon\""
},
"category": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "Category slug from list_categories"
},
"theme": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "Theme slug from list_themes, e.g. \"black-friday\""
},
"min_price": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Minimum price in BRL, e.g. 100"
},
"max_price": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Maximum price in BRL, e.g. 3000"
},
"sort": {
"type": "string",
"enum": [
"newest",
"featured",
"cheapest",
"popular"
],
"default": "newest",
"description": "featured: best deals right now (discount, engagement and freshness); cheapest: lowest price first; popular: most viewed"
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 999,
"default": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Deals per page, up to 25"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Active deals matching the search"
},
"page": {
"type": "integer"
},
"pages": {
"type": "integer"
},
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url"
],
"additionalProperties": false
}
}
},
"required": [
"total",
"page",
"pages",
"deals"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_deal(id)
Full details of a deal: product photo, price and discount in BRL, store, coupon, purchase link, 30-day price history, product pros/cons, specs and FAQ. Markdown in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Deal id, the UUID in https://pechincha.ai/p/<id>/<slug>"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"deal": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
},
"status": {
"type": "string",
"enum": [
"active",
"expired",
"pending"
]
},
"purchase_url": {
"type": [
"string",
"null"
],
"description": "Link to buy at the store"
},
"product_id": {
"type": [
"string",
"null"
],
"description": "For get_product and get_price_history"
},
"product_url": {
"type": [
"string",
"null"
],
"description": "Product page with price history and other stores"
},
"price_30d": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"avg": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"max": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"records": {
"type": "integer"
}
},
"required": [
"min",
"avg",
"max",
"records"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"summary": {
"type": [
"string",
"null"
],
"description": "Price facts: discount, price verdict and history"
},
"review_summary": {
"type": [
"string",
"null"
],
"description": "Summary of reviews and expert opinion"
},
"pros": {
"type": "array",
"items": {
"type": "string"
}
},
"cons": {
"type": "array",
"items": {
"type": "string"
}
},
"specs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"key",
"value"
],
"additionalProperties": false
}
},
"faq": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url",
"status",
"purchase_url",
"product_id",
"product_url",
"price_30d",
"summary",
"review_summary",
"pros",
"cons",
"specs",
"faq"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when the deal does not exist"
}
},
"required": [
"deal"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_product(id)
A product across stores: product photo, current offers with prices in BRL, lowest price, 30-day price stats, review summary, pros/cons, specs and FAQ. Markdown in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Product id, the UUID in https://pechincha.ai/produto/<id>/<slug>"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"product": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
},
"lowest_price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"lowest_price_store": {
"type": [
"string",
"null"
]
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Deal id, for get_deal"
},
"store": {
"type": [
"string",
"null"
]
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"expired": {
"type": "boolean"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"store",
"price",
"coupon_code",
"expired",
"url"
],
"additionalProperties": false
}
},
"price_stats": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"avg": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"max": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"records": {
"type": "integer"
}
},
"required": [
"min",
"avg",
"max",
"records"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"summary": {
"type": [
"string",
"null"
],
"description": "Price facts: discount, price verdict and history"
},
"review_summary": {
"type": [
"string",
"null"
],
"description": "Summary of reviews and expert opinion"
},
"pros": {
"type": "array",
"items": {
"type": "string"
}
},
"cons": {
"type": "array",
"items": {
"type": "string"
}
},
"specs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"key",
"value"
],
"additionalProperties": false
}
},
"faq": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"url",
"image_url",
"lowest_price",
"lowest_price_store",
"offers",
"price_stats",
"summary",
"review_summary",
"pros",
"cons",
"specs",
"faq"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when the product does not exist"
}
},
"required": [
"product"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_price_history(product_id, period)
Price history of a product, to judge whether a discount is real: min/avg/max in BRL, number of records and up to 30 dated prices. Says so when prices span fewer than 3 different days (not enough history to judge). Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"format": "uuid",
"description": "Product id, the UUID in https://pechincha.ai/produto/<id>/<slug>"
},
"period": {
"type": "string",
"enum": [
"30d",
"90d",
"1y"
],
"default": "30d"
}
},
"required": [
"product_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"history": {
"anyOf": [
{
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"period": {
"type": "string"
},
"stats": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"avg": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"max": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"records": {
"type": "integer"
}
},
"required": [
"min",
"avg",
"max",
"records"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"enough_history": {
"type": "boolean",
"description": "false when prices span fewer than 3 different days"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO 8601"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
}
},
"required": [
"date",
"price"
],
"additionalProperties": false
}
},
"url": {
"type": "string"
}
},
"required": [
"product_id",
"product_name",
"period",
"stats",
"enough_history",
"prices",
"url"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when the product does not exist"
}
},
"required": [
"history"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_product_url(url)
Check whether Pechincha.ai has an active deal for a product page URL from an online store. Returns the deal (price in BRL, discount, store, coupon, purchase link) and the lowest price across stores, or says there is none. Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "Product page URL at the store"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"deal": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
},
"purchase_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url",
"purchase_url"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when Pechincha.ai has no active deal for the URL"
},
"lowest_price": {
"type": [
"number",
"null"
],
"description": "BRL, lowest price across stores"
},
"lowest_price_store": {
"type": [
"string",
"null"
]
},
"product_id": {
"type": [
"string",
"null"
]
},
"product_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"deal",
"lowest_price",
"lowest_price_store",
"product_id",
"product_url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_store_coupons(store)
Active coupon codes of a store on Pechincha.ai. Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"store": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "Store slug from list_stores, e.g. \"amazon\""
}
},
"required": [
"store"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"store": {
"type": [
"string",
"null"
],
"description": "Store name, null when the slug does not exist"
},
"total": {
"type": "integer"
},
"coupons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
},
"valid_until": {
"type": [
"string",
"null"
],
"description": "ISO 8601, end date reported by the store"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url",
"valid_until"
],
"additionalProperties": false
},
"description": "Deals with a coupon code"
}
},
"required": [
"store",
"total",
"coupons"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_categories
Pechincha.ai categories as name (Brazilian Portuguese) and slug, for the category filter of search_deals.
Eingabe-Schema
{
"type": "object",
"properties": {}
}Ausgabe-Schema
{
"type": "object",
"properties": {
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"required": [
"categories"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_stores(query)
Stores on Pechincha.ai as name and slug, for search_deals and list_store_coupons. Without `query`, only the stores with deals in the last 7 days; there are 1000+ stores, so pass `query` to find any other by name.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 50,
"description": "Part of the store name, e.g. \"amazon\""
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"stores": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"required": [
"stores"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_similar_deals(id, limit)
Active deals similar to a deal (same kind of product, other brands, models and stores), to compare alternatives or find a cheaper one. Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Deal id, the UUID in https://pechincha.ai/p/<id>/<slug>"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Deals per page, up to 25"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url"
],
"additionalProperties": false
}
}
},
"required": [
"deals"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_deal_coupons(id)
Active coupon codes of the store selling a deal, to check whether one applies to it. Each coupon title states its rule (discount, eligible products or brands, minimum purchase) and valid_until is the end date the store reports: compare them with the deal's title and price before suggesting a code. Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Deal id, the UUID in https://pechincha.ai/p/<id>/<slug>"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"deal": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when the deal does not exist"
},
"store": {
"type": [
"string",
"null"
]
},
"total": {
"type": "integer"
},
"coupons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
},
"valid_until": {
"type": [
"string",
"null"
],
"description": "ISO 8601, end date reported by the store"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url",
"valid_until"
],
"additionalProperties": false
}
}
},
"required": [
"deal",
"store",
"total",
"coupons"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_coupon_stores
Stores with active coupon codes on Pechincha.ai, as name and slug. Get the codes with list_store_coupons.
Eingabe-Schema
{
"type": "object",
"properties": {}
}Ausgabe-Schema
{
"type": "object",
"properties": {
"stores": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"required": [
"stores"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_themes(query)
Pechincha.ai themes as name and slug, for the theme filter of search_deals: seasonal events (Black Friday, Dia das Crianças...), gift ideas and product niches. Pass `query` to filter.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 50,
"description": "Part of the theme name, e.g. \"black friday\""
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"themes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
}
},
"required": [
"themes"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_list(slug, page, limit)
A public Pechincha.ai list (https://pechincha.ai/lista/<slug>), such as a gift list someone shared: name, description, price range and its active deals, 10 per page by default (`limit` up to 25). Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9.-]*$",
"description": "The slug in https://pechincha.ai/lista/<slug>"
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 999,
"default": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10,
"description": "Deals per page, up to 25"
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"list": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"price_min": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"price_max": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"total": {
"type": "integer"
},
"page": {
"type": "integer"
},
"pages": {
"type": "integer"
},
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "BRL"
},
"old_price": {
"type": [
"number",
"null"
],
"description": "BRL, price before the discount"
},
"discount_percent": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"store": {
"type": [
"string",
"null"
]
},
"coupon_code": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string",
"description": "Deal page on Pechincha.ai"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product photo"
}
},
"required": [
"id",
"title",
"price",
"old_price",
"discount_percent",
"store",
"coupon_code",
"published_at",
"url",
"image_url"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"description",
"url",
"price_min",
"price_max",
"total",
"page",
"pages",
"deals"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "null when the list does not exist or is private"
}
},
"required": [
"list"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_guides(query)
Buying guides and articles from the Pechincha.ai blog: title, summary, date and URL. Search in Portuguese with short terms, e.g. "air fryer"; without `query`, the newest posts. Content in Brazilian Portuguese.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Text to search, e.g. \"air fryer\""
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"guides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"published_at": {
"type": [
"string",
"null"
],
"description": "ISO 8601"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"summary",
"published_at",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"guides"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis