ObraAberta CLI

Public property data from the terminal

The official read-only command-line interface lets people, developers and AI agents query the same governed public catalog without building an integration from scratch.

Install with npm

The package name is obraaberta and the published binary is also called obraaberta. Use npx when you want a one-off command, or install it globally for repeated scripts. The package does not require Supabase credentials and does not expose private records.

Commands return human-readable output by default and stable JSON with --json for automation. The CLI respects the public API contract, source attribution, pagination and rate limits.

npx obraaberta health --json
npx obraaberta search --q "Evolve Vila Mariana" --limit 5 --json
npm install --global obraaberta

Available public queries

The CLI can search works and developments, open a public project record, find projects near coordinates, inspect moderated ratings and timelines, list builders and their public projects, query nearby services and retrieve public data sources. It is deliberately read-only: it cannot create accounts, publish contributions, change ratings, access CPF, expose residential addresses or write to the database.

Source code and MCP

The source code is maintained in the ObraAberta GitHub repository under products/agent-tools. The same product also includes a local MCP stdio server for desktop hosts and a separate Streamable HTTP implementation. The hosted public MCP is available at /mcp, with its official Registry manifest at /server.json and its Server Card at /.well-known/mcp/server-card.json.