Waesy Developer & Agent Readiness Hub
Portal de Desenvolvedores e Agentes
Integre agentes de IA, clientes MCP, crawlers de busca generativa (GEO) e aplicacoes web ao ecossistema Waesy Local Marketplace usando padroes abertos: OpenAPI 3.1, MCP Streamable HTTP JSON-RPC 2.0, Markdown Content Negotiation (RFC 9110) e dados estruturados Schema.org.
Endpoints e Artefatos Canonicos
| Recurso | Metodo e Caminho | Formato | Finalidade |
|---|---|---|---|
| Descoberta Publica | GET /api/v1/public/discovery | application/json | Status da plataforma, versao da API, links de documentacao e capacidades publicas. |
| OpenAPI 3.1 | GET /api/openapi.json | application/json | 100% das operacoes REST com operationId unico e schemas de resposta tipados. |
| MCP Streamable HTTP | POST /api/mcp/v1/tools/call | JSON-RPC 2.0 / REST | Suporta initialize, ping, tools/list, tools/call, resources/list e prompts/list. |
| Manifesto WebMCP | GET /api/webmcp.json | application/json | Catalogo de ferramentas WebMCP para busca de ofertas, empresas, eventos e frete. |
| Instrucoes de Agente | GET /.well-known/agent-instructions.md | text/markdown | Regras When-to-Use, seguranca Zero-Trust e negociacao de conteudo Markdown. |
Ferramenta CLI Oficial (@waesy/cli)
Desenvolvedores e agentes com acesso a terminal podem consultar o ecossistema Waesy, testar a negociacao Markdown, invocar ferramentas MCP e executar auditorias de prontidao agentica via linha de comando.
# Verificar status da API e descoberta publica npx @waesy/cli status --url https://waesy.com.br # Buscar ofertas e empresas verificadas via MCP npx @waesy/cli search "farmacia centro" --city "Sao Miguel do Oeste" # Invocar handshake MCP JSON-RPC 2.0 (tools/list) npx @waesy/cli mcp tools/list # Auditar prontidao agentica (20 verificacoes Ora / Is-Agentic) node scripts/waesy-cli.mjs audit https://waesy.com.br
Negociacao de Conteudo Markdown
Todas as rotas publicas do Waesy implementam negociacao de conteudo HTTP conforme o padrao acceptmarkdown.com. Ao enviar o cabecalho Accept: text/markdown, o servidor responde com Content-Type: text/markdown; charset=utf-8 e Vary: Accept, incluindo tambem respostas 404 estruturadas em Markdown para caminhos inexistentes.
# Obter a pagina inicial em Markdown estruturado para LLMs curl -sS -L -i -H "Accept: text/markdown" https://waesy.com.br/ # Verificar resposta 404 amigavel para agentes em Markdown curl -sS -L -i -H "Accept: text/markdown" https://waesy.com.br/caminho-inexistente
Versionamento REST e Descontinuacao
Versionamento Semantico e Cabecalhos
Todas as rotas sob /api/v1/* e /api/mcp/v1/* emitem os cabecalhos X-API-Version: 2026-10-29.v1, Deprecation: false e limites de taxa RFC (RateLimit-Limit, RateLimit-Remaining,RateLimit-Reset, RateLimit-Policy).
Janela de Sunset de 180 Dias
Qualquer alteracao incompativel gera uma nova versao (/api/v2/*). Endpoints marcados para descontinuacao passam a emitir Deprecation: true e o cabecalho RFC 8594 Sunset com antecedencia minima de 180 dias antes da desativacao.
Simulador Interno de Prontidao Agentica
Motor nativo Waesy baseado nas 20 verificacoes do modelo Ora / Is-Agentic + GEO e Backlinks.
| # | Verificacao | Categoria | Status | Score |
|---|---|---|---|---|
| 1 | Content is available without JavaScript | essential | passed | 100% |
| 2 | Agent-friendly 404s | essential | passed | 100% |
| 3 | JSON error responses | essential | passed | 100% |
| 4 | Markdown content negotiation (acceptmarkdown.com) | essential | passed | 100% |
| 5 | Brand name discoverability | recommended | passed | 100% |
| 6 | Public API with reachable endpoints | recommended | passed | 100% |
| 7 | Developer portal | recommended | passed | 100% |
| 8 | Public API/docs linked from homepage | recommended | passed | 100% |
| 9 | Agent instruction / when-to-use | recommended | passed | 100% |
| 10 | CLI tool available | recommended | passed | 100% |
| 11 | Trust anchor pages | recommended | passed | 100% |
| 12 | Rate limit response headers | recommended | passed | 100% |
| 13 | REST response schema coverage | recommended | passed | 100% |
| 14 | Developer resource discoverability | recommended | passed | 100% |
| 15 | MCP server / manifest | recommended | passed | 100% |
| 16 | JSON-LD structured data | recommended | passed | 100% |
| 17 | Metadata completeness | recommended | passed | 100% |
| 18 | Organization schema completeness | recommended | passed | 100% |
| 19 | Function calling compatibility | recommended | passed | 100% |
| 20 | REST versioning / deprecation policy | recommended | passed | 100% |