Semantic API
Descoberta de API em linguagem natural — pesquise mais de 700 capacidades de API, obtenha endpoints, configuração de autenticação e trechos de código.
Documentação
Servidor MCP Semantic API
Um servidor MCP (Model Context Protocol) que permite que Claude, ChatGPT e outros agentes de LLM pesquisem e descubram APIs usando linguagem natural via Semantic API. Pergunte por qualquer capacidade de API em inglês simples e receba detalhes de endpoints, parâmetros, informações de autenticação e trechos de código.
Instalação
pip install semanticapi-mcp
Ou execute diretamente com uvx:
uvx semanticapi-mcp
Configuração
Obtenha uma Chave de API
Cadastre-se em semanticapi.dev para obter sua chave de API.
Variáveis de Ambiente
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
SEMANTIC_API_KEY | Sim | — | Sua chave da Semantic API |
SEMANTIC_API_URL | Não | https://semanticapi.dev | Substituição da URL base da API |
Claude Desktop
Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"semanticapi": {
"command": "uvx",
"args": ["semanticapi-mcp"],
"env": {
"SEMANTIC_API_KEY": "your-api-key-here"
}
}
}
}
Ou se instalado com pip:
{
"mcpServers": {
"semanticapi": {
"command": "semanticapi-mcp",
"env": {
"SEMANTIC_API_KEY": "your-api-key-here"
}
}
}
}
Ferramentas
semantic_query
Pesquise por uma capacidade de API usando linguagem natural.
Entradas:
query(string, obrigatório) — O que você deseja fazer, ex.: "enviar um e-mail com Gmail"auto_discover(booleano, opcional, padrão: true) — Descobrir automaticamente novas APIs se necessário
Exemplo: "Encontre uma API para converter moedas em tempo real"
semantic_discover
Descoberta aprofundada de um provedor/API específico por nome e intenção.
Entradas:
provider_name(string, obrigatório) — Nome do provedor da API, ex.: "stripe", "twilio"user_intent(string, opcional) — O que você deseja fazer com esta API
Exemplo: Descubra as capacidades do Stripe para "processar um reembolso"
semantic_discover_url
Analise qualquer API a partir da URL de sua documentação.
Entradas:
url(string, obrigatório) — URL da documentação da APIuser_intent(string, opcional) — O que você deseja fazer com esta API
Exemplo: Analise https://docs.example.com/api para gerar uma configuração de provedor
Relacionados
- Semantic API — O serviço de API hospedado
- semanticapi-engine — Motor de código aberto (AGPL-3.0)
- semantic-api-skill — Pacote de habilidade para frameworks de agentes
- Ferramenta CLI — Interface de linha de comando (
pip install semanticapi-cli)
Licença
MIT