# Para desenvolvedores e agentes

> API pública, servidor MCP, feeds RSS, Markdown e arquivos de descoberta do SmartDrugs para desenvolvedores e agentes de IA.

Página: https://smartdrugs.com.br/desenvolvedores/

Dados abertos

# Para desenvolvedores e agentes

As 109 fichas do SmartDrugs estão disponíveis em formatos para máquinas: API JSON, servidor MCP, Markdown e feeds RSS. Tudo é público, só de leitura e sem cadastro. Ao reutilizar, cite a URL da ficha. Conteúdo educacional. Não substitui orientação médica; não faz diagnóstico nem prescrição.

## API JSON

| Endereço | O que devolve |
| `/api/v1/substancias.json` | Todas as fichas: nome, tipo, objetivos, resumo, links, imagem e molécula. |
| `/api/v1/substancias/{slug}.json` | Ficha completa: mecanismo, evidência, efeitos, doses usadas nos estudos, regulação e fontes. |
| `/api/v1/objetivos.json` | Objetivos com a contagem de fichas e o feed de cada um. |
| `/api/v1/openapi.json` | Descrição OpenAPI 3.1 da API. |

## Servidor MCP

Endereço `https://smartdrugs.com.br/mcp` (Streamable HTTP, sem autenticação). Ferramentas: `buscar_substancias`, `obter_ficha`, `listar_objetivos` e `listar_artigos`, todas só de leitura.

`{ "mcpServers": { "smartdrugs": { "url": "https://smartdrugs.com.br/mcp" } } }`

## Agente A2A

Endereço `https://smartdrugs.com.br/a2a` (JSON-RPC, método `message/send`), com cartão em [/.well-known/agent-card.json](https://smartdrugs.com.br/.well-known/agent-card.json). Recebe uma pergunta em texto e devolve as fichas relacionadas.

## Markdown

Toda página tem uma versão em Markdown: acrescente `index.md` ao endereço (por exemplo [/substancias/l-teanina/index.md](https://smartdrugs.com.br/substancias/l-teanina/index.md)) ou peça a página com o cabeçalho `Accept: text/markdown`. Resumo do site em [/llms.txt](https://smartdrugs.com.br/llms.txt) e versão completa em [/llms-full.txt](https://smartdrugs.com.br/llms-full.txt).

## Feeds RSS

Todos os itens têm imagem. Feed geral: [/feed.xml](https://smartdrugs.com.br/feed.xml). Artigos: [/feed/artigos.xml](https://smartdrugs.com.br/feed/artigos.xml). Fichas: [/feed/fichas.xml](https://smartdrugs.com.br/feed/fichas.xml). Por objetivo: [Memória](https://smartdrugs.com.br/feed/memoria.xml), [Foco](https://smartdrugs.com.br/feed/foco.xml), [Humor](https://smartdrugs.com.br/feed/humor.xml), [Energia](https://smartdrugs.com.br/feed/energia.xml), [Calma](https://smartdrugs.com.br/feed/calma.xml), [Sono](https://smartdrugs.com.br/feed/sono.xml), [Desempenho físico](https://smartdrugs.com.br/feed/desempenho-fisico.xml), [Saúde cardiovascular](https://smartdrugs.com.br/feed/saude-cardiovascular.xml), [Estresse](https://smartdrugs.com.br/feed/estresse.xml), [Inflamação](https://smartdrugs.com.br/feed/inflamacao.xml), [Libido](https://smartdrugs.com.br/feed/libido.xml), [Imunidade](https://smartdrugs.com.br/feed/imunidade.xml).

## Descoberta

- [/.well-known/api-catalog](https://smartdrugs.com.br/.well-known/api-catalog)
- [/.well-known/mcp/server-card.json](https://smartdrugs.com.br/.well-known/mcp/server-card.json)
- [/.well-known/agent-card.json](https://smartdrugs.com.br/.well-known/agent-card.json)
- [/.well-known/ai-catalog.json](https://smartdrugs.com.br/.well-known/ai-catalog.json)
- [/.well-known/agent-skills/index.json](https://smartdrugs.com.br/.well-known/agent-skills/index.json)
- [/auth.md](https://smartdrugs.com.br/auth.md)
- [/robots.txt](https://smartdrugs.com.br/robots.txt)
- [/sitemap.xml](https://smartdrugs.com.br/sitemap.xml)

## Uso

Sem chave e sem limite formal; use com moderação e guarde em cache por algumas horas. O conteúdo é educacional: não apresente doses de estudo como recomendação e indique sempre a página da ficha. Dúvidas e parcerias: [contato](https://smartdrugs.com.br/contato/).

---

Conteúdo educacional. Não substitui orientação médica; não faz diagnóstico nem prescrição. Fonte: SmartDrugs, https://smartdrugs.com.br/desenvolvedores/
