Para desenvolvedores e agentes

Tudo aqui é público, somente leitura e não exige autenticação. A API e o servidor MCP têm limite de 60 requisições por minuto por IP; acima disso a resposta é HTTP 429 com o cabeçalho Retry-After. Os cabeçalhos RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset mostram o consumo. Ao usar o conteúdo, siga a política de uso por agentes.

Páginas em Markdown

Qualquer página do site responde em Markdown limpo quando o cliente prefere esse formato no cabeçalho Accept. A URL é a mesma; a resposta traz Vary: Accept.

curl -H "Accept: text/markdown" https://economiapaulista.com/noticia/{slug}

API pública (v1)

Base: https://economiapaulista.com/api/v1 · Especificação OpenAPI 3.1: /api/v1/openapi.json

• GET /noticias: matérias mais recentes; filtros editoria, tema, cidade, limite (até 50) e pagina.
• GET /noticias/{slug}: matéria completa, com autor, datas, fontes e referência para citação.
• GET /busca?q=: busca por palavras no título, linha fina, temas e texto.
• GET /editorias: editorias do site.
• GET /impostometro: arrecadação de tributos em São Paulo no ano, calculada no momento da consulta.
• GET /agro: cotações do boi gordo, açúcar cristal e etanol hidratado (Cepea/Esalq-USP).
• GET /status: situação da API.

Servidor MCP

Endpoint https://economiapaulista.com/mcp (Model Context Protocol, transporte Streamable HTTP, sem sessão, somente leitura). Ferramentas: buscar_noticias, listar_noticias, ler_noticia, listar_editorias, impostometro_sp e cotacoes_agro_sp. Para adicionar a um cliente compatível:

{ "mcpServers": { "economia-paulista": { "type": "http", "url": "https://economiapaulista.com/mcp" } } }

A descrição completa, com exemplos de uso, está no MCP Server Card.

Descoberta

• /.well-known/api-catalog: catálogo de APIs (RFC 9727).
• /.well-known/mcp/server-card.json: MCP Server Card.
• /.well-known/agent-skills/index.json: índice de Agent Skills, com tarefas, esquemas de entrada e saída, autenticação e limites.
• /llms.txt, /sitemap.xml e /robots.txt (com Content Signals).
• Todas as páginas trazem um cabeçalho HTTP Link apontando para esses recursos (api-catalog, service-desc, service-doc, service-meta, terms-of-service).

Contato

Uso comercial em escala, parcerias ou problemas técnicos: comercial@economiapaulista.com.