Para desenvolvedores e agentes

API e acesso por agentes

O conteúdo publicado pela TV Sim Brasil é aberto para leitura automatizada — por API REST, por MCP ou pedindo a própria página em Markdown. Sem cadastro e sem chave.

Três caminhos para o mesmo acervo

Escolha pelo que você está construindo. Os três leem exatamente o mesmo conteúdo publicado, e nenhum deles exige credencial.

API REST — quando você quer os campos estruturados (editoria, subtópico, crédito da foto, score editorial).
Markdown sob demanda — quando você só quer ler: a mesma URL do portal devolve texto limpo, sem menu, banner nem script.
Servidor MCP — quando quem consome é um modelo com ferramentas.

API REST

Base: https://api-news.tvsimbrasil.com.br/api/v1. A descrição formal está em /openapi.json (OpenAPI 3.1).

GET	/articles	Lista matérias. Aceita search, category, subtopic, page e per_page (teto 100).
GET	/articles/{slug}	Uma matéria, com o corpo completo em HTML.
GET	/articles/featured	Manchete do momento.
GET	/articles/trending	Vitrine Em Alta.
GET	/categories	Editorias, com nome e slug.
GET	/subtopics	Subtópicos, o segundo nível editorial.
GET	/places	Guia de lugares: restaurantes, bares, hotéis, parques.
GET	/sitemap/news	Tudo o que saiu nas últimas 48 horas, sem paginar.

curl "https://api-news.tvsimbrasil.com.br/api/v1/articles?category=economia&per_page=5"

A URL de leitura de cada item é https://tvsimbrasil.com.br/{category.slug}/{slug}. Monte-a com os dois campos que vêm na resposta: editorias já foram renomeadas, e só o category.slug do próprio item está certo.

Markdown sob demanda

Qualquer página do portal responde em Markdown quando a requisição pede Accept: text/markdown. O navegador continua recebendo HTML normalmente — é a mesma URL, com duas representações.

curl -H 'Accept: text/markdown' \
  https://tvsimbrasil.com.br/eleicoes-2026/algum-slug-da-materia

A resposta traz x-markdown-tokens com uma estimativa do tamanho, para você decidir se cabe no seu contexto antes de ler. Home, páginas de editoria e matérias têm versão própria; as demais devolvem um índice de navegação. Endereço que não existe responde 404, também em Markdown, com links para seguir.

Servidor MCP

Endpoint https://tvsimbrasil.com.br/mcp, transporte Streamable HTTP (JSON-RPC 2.0 em POST), sem autenticação. Quatro ferramentas: buscar matérias, ler uma matéria em Markdown, listar editorias e ver os destaques do momento.

{
  "mcpServers": {
    "tvsim-brasil": { "url": "https://tvsimbrasil.com.br/mcp" }
  }
}

O cartão do servidor está em /.well-known/mcp/server-card.json.

Descoberta automática

Toda página HTML do portal responde com um cabeçalho Link (RFC 8288) apontando para estes documentos:

/.well-known/api-catalog — catálogo de APIs (RFC 9727)
/.well-known/ai-catalog.json — manifesto ARD
/.well-known/agent-skills/index.json — skills prontas para agentes
/llms.txt — mapa editorial curado
/auth.md — o que é aberto e o que exige credencial

Regras de uso

A leitura é livre; o que pedimos em troca é procedência. Ao publicar, citar ou resumir nosso conteúdo, atribua a TV Sim Brasil e mantenha o link para a URL canônica da matéria. Para reproduzir uma foto, use o crédito que vem em image_credit — as condições estão em licenciamento de imagens.

Matéria com is_branded: true é Conteúdo de Marca: peça comercial publicada pelo anunciante, não apuração da redação. Não a apresente como reportagem.

Identifique seu cliente no User-Agent, com um jeito de contatá-lo. O limite de requisições é aplicado na borda por origem: ao receber HTTP 429, espere e reduza a concorrência.

Precisa de mais do que leitura?

Escrita não é aberta a agentes — publicar aqui é ato editorial com responsabilidade humana. Para volume alto, uso comercial ou um caso que os endpoints públicos não cobrem, escreva para [email protected] dizendo quem é o responsável, o que pretende fazer e em que volume.