llms.txt
+49 −20
− > Open construction cost catalog. Aggregates material, labor, and equipment prices from procurement portals, vendor catalogs, and BC3/FIEBDC-3 files, each with its source and observed date. Coverage: Spain (ES), United States (US), and the European Union (EU).− - **Canonical items**: `/api/v1/items` — one row per real-world product, with vendor breakdown and median price− - **Item detail**: `/api/v1/items/{id}` — vendor breakdown + 90-day price history. Send `Accept: text/markdown` for an LLM-readable rendering.− - **Item as markdown**: `/api/markdown/item/{id}` — the same item rendered directly as `text/markdown`, indexable and cached. Use this when you cannot set an `Accept` header. Accepts a canonical `ci_…` id, a bare catalog-item uuid, or a vendor product code.− - **Search**: `/api/v1/search?q=...` — semantic search via Vectorize embeddings− - **MCP server**: `/.well-known/mcp.json` → `/api/mcp`− - **OAuth discovery**: `/.well-known/oauth-authorization-server`, `/.well-known/oauth-protected-resource`− - **Blog**: `/en/blog` — product notes on price crawling, AI budgets, catalog normalization, and construction cost intelligence.− - **Full reference**: `/llms-full.txt` — expanded prose version of this file: entity model, both id spaces, worked answers to common catalog questions.− - **Licensing (RSL 1.0)**: `/.well-known/rsl.xml` — machine-readable terms. Marketing pages, blog and supplier profiles are free to crawl, summarize, cite, and train on, with attribution. Catalog pages are not free for AI systems: use the API or x402.− - `ci_<uuid>` — **canonical item**, one per real-world product. This is what `/api/v1/items` returns and what `/api/v1/items/{id}` expects.− - `<uuid>` (bare) — **catalog item**, one source's row. This is the id in public page URLs: `/{locale}/catalog/{uuid}/{slug}`.− `median_price` on a canonical item is a trust-weighted median that is **FX-normalized** into that item's currency (USD unless the item specifies otherwise). Observations recorded in another currency are converted at aggregation time, so `median_price` is not necessarily a figure any single vendor quoted — an item whose only observation is €263.19 reports roughly $286.08.− Public read endpoints work without auth (60 req/min/IP). Anonymous **machines**− hitting catalog HTML or `/register` receive **HTTP 402** (x402).− **Agents — register via x402** (do not scrape the HTML form):− We welcome AI crawlers on the public catalog + APIs. See https://omnicost.com/robots.txt for the allow/disallow rules. Authenticated AI agents get higher rate limits — set up a key as above.− The public catalog is available for indexing and citation by AI systems. API responses and enrichment metadata are subject to the Omnicost Terms of Service at https://omnicost.com/terms.− licences. If you reproduce or cite it, carry the attribution with it — this is a− - Base de Costes de la Construcción de Andalucía (BCCA) — CC BY 3.0+ > Construction cost management with itemized estimates, budget review and a source-backed price catalog. The catalog aggregates material, labor, and equipment prices from procurement portals, vendor catalogs, and BC3/FIEBDC-3 files, each with its source and observed date. Catalog coverage: Spain (ES), United States (US), and the European Union (EU). Argentina (limited).+ ## Start here+ - [Construction cost management](https://omnicost.com/en): product overview and free estimate entry point.+ - [Gestión de costes de construcción](https://omnicost.com/es): Spanish product overview.+ - [Construction cost planning](https://omnicost.com/en/cost-management): scope, quantities, line-item review and budget workflow.+ - [Planificación de costes de obra](https://omnicost.com/es/cost-management): Spanish planning guide.+ - [Free construction cost estimator](https://omnicost.com/en/ai-cost-estimator): start an estimate without registration.+ - [Presupuesto de obra gratis](https://omnicost.com/es/presupuesto-de-obra-ia): Spanish free estimator.+ - [API reference](https://omnicost.com/api/v1/openapi.json): authenticated catalog and integration endpoints.+ - [Expanded reference](https://omnicost.com/llms-full.txt): catalog entities, identifiers and worked API examples.+ - **Canonical items**: `/api/v1/items`, one row per real-world product, with vendor breakdown and median price+ - **Item detail**: `/api/v1/items/{id}`, vendor breakdown + 90-day price history. Send `Accept: text/markdown` for an LLM-readable rendering.+ - **Item as markdown**: `/api/markdown/item/{id}`, the same item rendered directly as `text/markdown`, indexable and cached. Use this when you cannot set an `Accept` header. Accepts a canonical `ci_…` id, a bare catalog-item uuid, or a vendor product code.+ - **Search**: `/api/v1/search?q=...`, semantic search via Vectorize embeddings+ - **MCP server**: `/.well-known/mcp.json` → `/api/mcp` (API key or OAuth sign-in); x402 clients: `/api/mcp/x402`+ - **OAuth discovery**: `/.well-known/oauth-authorization-server`, `/.well-known/oauth-protected-resource`. MCP connectors (Claude, ChatGPT) sign in with an Omnicost account: authorization code + PKCE (S256) at `/api/oauth/authorize`, DCR or Client ID Metadata Documents. Organization API keys keep working.+ - **Blog**: `/en/blog`, product notes on price crawling, AI budgets, catalog normalization, and construction cost intelligence.+ - **Full reference**: `/llms-full.txt`, expanded prose version of this file: entity model, both id spaces, worked answers to common catalog questions.+ - **Licensing (RSL 1.0)**: `/.well-known/rsl.xml`, machine-readable terms. Marketing pages, blog and supplier profiles are free to crawl, summarize, cite, and train on, with attribution. Catalog pages are not free for AI systems: use the API or x402.+ - `ci_<uuid>`: **canonical item**, one per real-world product. This is what `/api/v1/items` returns and what `/api/v1/items/{id}` expects.+ - `<uuid>` (bare): **catalog item**, one source's row. This is the id in public page URLs: `/{locale}/catalog/{uuid}/{slug}`.+ `median_price` on a canonical item is a trust-weighted median that is **FX-normalized** into that item's currency (USD unless the item specifies otherwise). Observations recorded in another currency are converted at aggregation time, so `median_price` is not necessarily a figure any single vendor quoted. For example, an item whose only observation is €263.19 reports roughly $286.08.+ Send an API key as Bearer on `/api/v1` and `/api/mcp`. Without a key,+ agents pay per call with **x402** (USDC on Base, v1 and v2):+ `GET /api/v1/items` and `/items/{id}` $0.01, `GET /api/v1/search` (and `/items?q=`) $0.02,+ MCP `tools/call` $0.01 on `https://omnicost.com/api/mcp/x402` (`initialize`, `tools/list`, `ping` are free there). Only successful calls are charged.+ No key and no payment: `/api/v1` answers 401 (browsers) or 402 (x402 offer); `/api/mcp` serves `initialize`, `tools/list` and `ping`, and `tools/call` answers 401 (OAuth sign-in) unless the request carries an x402 payment, like `/api/mcp/x402`.+ **Free API key**: an `omc_pub_` key from `POST https://omnicost.com/api/v1/keys/signup` or the agent checkout below gives 200 req/min and 10,000 req/month.+ Anonymous **machines** hitting catalog HTML or `/register` also receive **HTTP 402** (x402).+ **Agents: register via x402** (do not scrape the HTML form):+ **Agents: buy Omnicost Pro by card**: `POST https://omnicost.com/api/v1/checkout/agent` with `{ "email", "plan": "weekly" | "monthly" | "yearly", "key_id"? }`. Returns a Stripe `checkout_url` for a person to pay and, without `key_id`, a new free `omc_pub_` key (shown once) that gets Pro limits after payment. With `key_id`, send that key as the bearer. Status: `GET https://omnicost.com/api/v1/checkout/agent/done?session_id=cs_…`.+ ## Guides+ Each guide answers one question. The first lines are the answer. Tables cite the source and the date the figures were checked.+ - https://omnicost.com/en/guides - English guide index+ - https://omnicost.com/es/guias - Spanish guide index+ - https://omnicost.com/es/guias/base-precios-extremadura-2026-que-sube - La Base de Precios de la Construcción de Extremadura 2026 sube un 1,6% en la partida mediana de edificación respecto a la edición 2025. El índice de costes de edificación del Ministerio de Transportes subió un 4,35% entre abril de 2025 y abril de 2026. El 70% de la subida de la base viene de materiales y el 30% de mano de obra. La maquinaria no cambia.+ - https://omnicost.com/es/guias/bcca-2024-subida-precios-vs-ine - La Base de Costes de la Construcción de Andalucía publicada en enero de 2024 revisa 728 de sus 5.123 precios básicos comparables con la edición 2021-22, con una subida mediana del 28,5%. En los materiales que más suben, la revisión va muy por delante de los índices del INE para el mismo periodo. El cemento sube un 73,1% en la base y un 21,5% en el índice. El ladrillo hueco doble sube un 137,7% en la base y la cerámica un 36,0% en + - https://omnicost.com/es/guias/bcca-vs-base-extremadura-mismo-material - En la Base de Costes de la Construcción de Andalucía de enero de 2024, el acero corrugado B500S cuesta 0,95 €/kg. En la base oficial de Extremadura del mismo año cuesta 1,82 €/kg. Con el yeso negro la diferencia va al revés: 160,00 €/t en Andalucía frente a 57,68 €/t en Extremadura. Son dos comunidades vecinas y dos ediciones publicadas en 2024.+ - https://omnicost.com/en/guides/caltrans-equipment-rental-rates-2026-2027 - Caltrans publishes an hourly rental rate for each piece of construction equipment, listed by class, make and model. The 2026-2027 file has 2,166 rows, and 2,164 of them expire on March 31, 2027 (two rows leave the date blank). A Caterpillar 977L crawler loader, for example, is listed at $135.28 per hour.+ - https://omnicost.com/en/guides/class-a-concrete-price-per-cubic-yard-tdot - On Tennessee DOT contracts awarded in 2025, the statewide average price of Class A concrete ranged from $704.72 to $2,260.71 per cubic yard. Where the concrete goes drives most of that spread: leveling concrete sits at the bottom and pipe endwalls at the top.