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ávelObrigatóriaPadrãoDescrição
SEMANTIC_API_KEYSimSua chave da Semantic API
SEMANTIC_API_URLNãohttps://semanticapi.devSubstituiçã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 API
  • user_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

Licença

MIT