chavesnamao.com.br WebMCP Tools, Schemas & Agent Capabilities

← WebMCP Directory

chavesnamao.com.br

live Unverified (seed import) Commerce 2 tools imperative implementation

Open website How verification works

Brazilian marketplace for real estate and vehicle listings.

First seen 2026-09-21 · Last seen 2026-09-28 · Source: webmcp.com

Answer 2 · Act 0 · Transact 0 · Score: Not yet scored

Tool inspector

search_realty_listings

answer imperative

Busca anúncios de imóveis (venda ou aluguel) no Chaves na Mão. Retorna lista paginada com título, preço, localização, quartos, vagas, área e URL. Para buscas 'perto de X', use `proximity.target` para X e não transforme o ponto de referência em bairro. IMPORTANTE: use o campo `url` de cada resultado como link do anúncio — não reconstrua URLs.

Input schema

Property	Type	Required	Description
`query`	string	no	Texto livre em português do usuário (ex.: 'apartamento 3 quartos Curitiba 500 mil'). Usado como fallback quando os filtros estruturados estão ausentes.
`filters`	object	no	Filtros estruturados. Se presentes, são autoritativos sobre `query`. Não coloque nomes de pontos de referência de frases como 'perto de X' em `neighborhood`; use `proximity.target`.
`proximity`	object	no	Intenção explícita de proximidade. Quando o usuário disser 'perto de X', 'próximo de X' ou 'nas proximidades de X', preencha `target` com o nome do ponto de referência e não transforme esse ponto em bairro.
`page`	integer	no	—
`pageSize`	integer	no	—

Raw JSON schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Texto livre em português do usuário (ex.: 'apartamento 3 quartos Curitiba 500 mil'). Usado como fallback quando os filtros estruturados estão ausentes."
    },
    "filters": {
      "type": "object",
      "description": "Filtros estruturados. Se presentes, são autoritativos sobre `query`. Não coloque nomes de pontos de referência de frases como 'perto de X' em `neighborhood`; use `proximity.target`.",
      "properties": {
        "transaction": {
          "type": "string",
          "description": "Tipo de transação. Valores principais: 'venda', 'aluguel', 'lancamentos'. Aceita variações NL como 'comprar', 'alugar', 'na planta'.",
          "default": "venda"
        },
        "propertyType": {
          "type": "string",
          "description": "Tipo de imóvel. Exemplos: 'apartamento', 'casa', 'terreno', 'kitnet', 'studio', 'sobrado', 'cobertura', 'loft', 'flat', 'sala comercial', 'casa comercial', 'ponto comercial', 'galpão', 'prédio', 'chácara', 'fazenda', 'garagem', 'casa em condomínio', 'terreno em condomínio', 'terreno comercial'. Categorias: 'comercial', 'rural', 'residencial'."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2,
          "description": "UF com 2 letras (ex.: 'PR')."
        },
        "neighborhood": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "street": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Nome da rua/avenida (ex.: 'Avenida Sete de Setembro'). Abreviações como 'av', 'r.' são normalizadas automaticamente."
        },
        "bedrooms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "bathrooms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "parkingSpots": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10
        },
        "minPrice": {
          "type": "integer",
          "minimum": 0
        },
        "maxPrice": {
          "type": "integer",
          "minimum": 1
        },
        "minArea": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "maxArea": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "amenities": {
          "type": "array",
          "maxItems": 30,
          "items": {
            "type": "string"
          },
          "description": "Características/amenidades do imóvel. Exemplos: 'piscina', 'academia', 'elevador', 'portaria 24h', 'mobiliado', 'churrasqueira', 'sacada', 'aceita pets', 'condomínio fechado', 'direto com proprietário'. Termos são resolvidos dinamicamente contra os filtros disponíveis."
        }
      },
      "additionalProperties": false
    },
    "proximity": {
      "type": "object",
      "description": "Intenção explícita de proximidade. Quando o usuário disser 'perto de X', 'próximo de X' ou 'nas proximidades de X', preencha `target` com o nome do ponto de referência e não transforme esse ponto em bairro.",
      "properties": {
        "target": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "description": "Nome do ponto de referência informado pelo usuário (ex.: 'Passeio Público', 'Hospital Pequeno Príncipe', 'Shopping Curitiba')."
        },
        "category": {
          "type": "string",
          "enum": [
            "busStops",
            "hospitals",
            "parks",
            "schools",
            "gyms",
            "restaurants",
            "supermarkets",
            "pharmacies",
            "malls",
            "metros"
          ],
          "description": "Categoria opcional quando conhecida: busStops, hospitals, parks, schools, gyms, restaurants, supermarkets, pharmacies, malls ou metros."
        }
      },
      "required": [
        "target"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 1
    },
    "pageSize": {
      "type": "integer",
      "minimum": 15,
      "maximum": 15,
      "default": 15
    }
  },
  "additionalProperties": false
}