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.

Endpoint

• GET /api/content.json — índice completo de conteúdo (es / en / pt-br).

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.