Pechincha.ai
Brazilian deals: search active promos, coupons and price history from Brazilian online stores.
Should I use this
Quality & Safety
Findings (4)
- HIGH
- MEDIUMin get_list
- LOWin list_store_coupons
- LOWin check_product_url
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"deals": {
"url": "https://pechincha.ai/mcp"
}
}
}Remote endpoints
https://pechincha.ai/mcpstreamable-httpWhat it can do
Tool inventory
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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {}
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input Schema
{
"type": "object",
"properties": {}
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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.
Input 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#"
}Output 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
Evidence