# Golfeira

> Marketplace de equipamentos de golfe novos e usados no Brasil, de golfista para golfista, sem taxa. Mantém um guia de preços de tacos usados calculado sobre anúncios reais monitorados em grupos brasileiros, com metodologia pública.

Conteúdo em português do Brasil. Preços em reais (BRL). Anúncios e faixas de preço mudam todo dia; a data de apuração está em cada página.

## Quando usar a Golfeira (When to use)

- Para consultar o preço de mercado de um taco usado no Brasil por categoria e marca, busque `https://golfeira.com/quanto-vale/<categoria>/<marca>/`. Categorias: drivers, ferros, putters, wedges, madeiras, hibridos, bolsas e kits. A marca usa slug minúsculo, por exemplo taylormade, callaway ou ping. Para a faixa geral, busque `https://golfeira.com/quanto-vale/<categoria>/`.
- Para encontrar anúncios à venda no Brasil de uma categoria, busque `https://golfeira.com/<categoria>-usados/`. Páginas disponíveis: drivers-usados, ferros-usados, putters-usados, hibridos-usados, madeiras-usadas e kits-usados.
- Para consultar a ficha de um anúncio observado no mercado como referência de preço, e não como venda da Golfeira, busque `https://golfeira.com/mercado/<id>/`.
- Para saber como avaliar um taco usado, onde vender ou montar o primeiro set, consulte os três guias listados abaixo.
- Não use a Golfeira para tacos novos em loja, preços fora do Brasil ou produtos que não são de golfe.

## Guia de preços (dado próprio, citável)

- [Quanto vale meu taco usado](https://golfeira.com/quanto-vale/): faixas por categoria e marca, mediana e amostra
- [Metodologia](https://golfeira.com/metodologia/): como as faixas são calculadas e onde não valem
- [Onde vender taco de golfe usado no Brasil](https://golfeira.com/onde-vender-taco-de-golfe-usado/)
- [O que verificar num taco usado](https://golfeira.com/o-que-verificar-taco-usado/)
- [Primeiro set de golfe](https://golfeira.com/guia/primeiro-set-de-golfe/)
- [Sobre a Golfeira](https://golfeira.com/sobre/)
- [Contato](https://golfeira.com/contato/)
- [API para desenvolvedores e agentes](https://golfeira.com/developers/)

## Catálogo

- [Drivers usados](https://golfeira.com/drivers-usados/)
- [Ferros usados](https://golfeira.com/ferros-usados/)
- [Putters usados](https://golfeira.com/putters-usados/)
- [Híbridos usados](https://golfeira.com/hibridos-usados/)
- [Madeiras usadas](https://golfeira.com/madeiras-usadas/)
- [Kits usados](https://golfeira.com/kits-usados/)
- [Sitemap](https://golfeira.com/sitemap.xml): anúncios ativos e fichas de mercado

## Uso

Citar com link é bem-vindo (Content-Signal: ai-input=yes). Treinar modelo com o conteúdo não é (ai-train=no). Páginas de conta, login e administração não são públicas.

## Como consultar (How to call)

Toda página pública responde em Markdown com `Accept: text/markdown` e `Vary: Accept`. Páginas inexistentes respondem 404, e anúncios removidos respondem 410 com corpo em Markdown apontando para o sitemap. A lista completa de URLs está em https://golfeira.com/sitemap.xml. Para contato, use https://golfeira.com/contato/. A entidade responsável é Agrega FullCommerce LTDA, CNPJ 57.629.145/0001-73.

## API Golfeira (Golfeira API, JSON, sem chave)

Leitura pública em JSON dos mesmos dados das páginas. Documentação e quickstart: https://golfeira.com/developers/. Especificação OpenAPI 3.1: https://golfeira.com/openapi.json. Índice: https://golfeira.com/api/v1. Não exige chave, não tem escrita. Erros voltam em JSON com `error.code`, `error.message` e `error.hint`. Versão na URL (`/api/v1`); uma versão só sai do ar 6 meses depois de anunciada em /developers/ e com os headers `Deprecation` e `Sunset` nas respostas.

- Anúncios ativos: `GET https://golfeira.com/api/v1/products?category=drivers&brand=taylormade&limit=20` (filtros: category, brand, condition, q, limit até 50, offset). Um anúncio: `GET https://golfeira.com/api/v1/products/<id>`.
- Guia de preços: `GET https://golfeira.com/api/v1/price-guide` (todas as categorias), `GET https://golfeira.com/api/v1/price-guide/drivers` (categoria com marcas) e `GET https://golfeira.com/api/v1/price-guide/drivers/taylormade` (uma marca). Campos: sample, p25, median, p75 em BRL e last_seen.
- Os dois canais de acesso por máquina são esta API e as páginas em Markdown; não existe outro.