API pública de conteúdo

maximofn.com expõe uma API pública somente leitura com o índice do seu conteúdo (artigos do blog, projetos e dicas). Não requer autenticação e é pensada para agentes de IA, crawlers e desenvolvedores que queiram descobrir o conteúdo do site de forma legível por máquinas.

Endpoints

• GET /api/v1/content.json — índice completo de conteúdo (es / en / pt-br). Rota versionada: é a que convém fixar.
• GET /api/content.json — alias sem versão, segue sempre a última.

Versionamento

As rotas sob /api/{versão}/ mantêm a sua forma: os campos existentes não são removidos nem mudam de tipo, apenas se acrescentam novos. Uma mudança incompatível é publicada como uma versão nova e a anterior continua a funcionar. Por isso, para uma integração estável convém apontar para /api/v1/content.json e não para o alias sem versão.

Retirada de versões: quando uma versão nova for publicada, a anterior continuará a ser servida sem alterações durante pelo menos 12 meses. Nesse período as suas respostas levarão os cabeçalhos Deprecation e Sunset com a data de retirada, e o campo versions.deprecation do JSON anunciará a sucessora. Passada a data, a rota retirada responderá 410 Gone com um JSON que aponte para a versão vigente.

Especificação e descoberta

• OpenAPI 3.1 (/openapi.json) — documentação legível por máquina.
• /.well-known/ai-plugin.json — manifesto para agentes de IA.
• /llms.txt — guia de navegação para LLMs.
• /mcp — servidor MCP (Model Context Protocol) com as tools list_content, search_content e content_stats.

Características

• Sem autenticação nem chaves de API.
• Somente leitura (requisições GET).
• Sem limites de taxa.
• Resposta em JSON (application/json), com URLs em es / en / pt-br.
• Versionado através da especificação OpenAPI.

Exemplo de resposta

{
  "site": "https://www.maximofn.com",
  "name": "MaximoFN",
  "languages": ["es", "en", "pt-br"],
  "counts": { "posts": 78, "projects": 11, "tips": 13, "total": 102 },
  "content": [
    {
      "type": "post",
      "title": "QLoRA Explicado: Quantização NF4...",
      "description": "...",
      "url": "https://www.maximofn.com/qlora",
      "url_en": "https://www.maximofn.com/en/qlora",
      "url_pt": "https://www.maximofn.com/pt-br/qlora",
      "image": "https://images.maximofn.com/QLoRA_thumbnail_ES.webp"
    }
  ]
}

Quickstart

Não requer autenticação: uma única requisição GET devolve todo o índice.

# curl
curl https://www.maximofn.com/api/content.json

# Python
import httpx
data = httpx.get("https://www.maximofn.com/api/content.json").json()
posts = [c for c in data["content"] if c["type"] == "post"]
print(len(posts), "posts")

// JavaScript
const res = await fetch("https://www.maximofn.com/api/content.json");
const data = await res.json();
console.log(data.counts);

O conteúdo é propriedade de MaximoFN; seu uso é permitido para descoberta e indexação.