Semantic API
Descubrimiento de API en lenguaje natural: busca más de 700 capacidades de API, obtén endpoints, configuración de autenticación y fragmentos de código.
Documentación
Servidor MCP de Semantic API
Un servidor MCP (Model Context Protocol) que permite a Claude, ChatGPT y otros agentes LLM buscar y descubrir APIs usando lenguaje natural a través de Semantic API. Solicita cualquier capacidad de API en inglés sencillo y obtén detalles de endpoints, parámetros, información de autenticación y fragmentos de código.
Instalación
pip install semanticapi-mcp
O ejecuta directamente con uvx:
uvx semanticapi-mcp
Configuración
Obtén una Clave de API
Regístrate en semanticapi.dev para obtener tu clave de API.
Variables de Entorno
| Variable | Requerida | Predeterminada | Descripción |
|---|---|---|---|
SEMANTIC_API_KEY | Sí | — | Tu clave de Semantic API |
SEMANTIC_API_URL | No | https://semanticapi.dev | Anulación de la URL base de la API |
Claude Desktop
Agrega a tu configuración de 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"
}
}
}
}
O si está instalado con pip:
{
"mcpServers": {
"semanticapi": {
"command": "semanticapi-mcp",
"env": {
"SEMANTIC_API_KEY": "your-api-key-here"
}
}
}
}
Herramientas
semantic_query
Busca una capacidad de API usando lenguaje natural.
Entradas:
query(cadena, requerida) — Lo que quieres hacer, p. ej. "enviar un correo electrónico con Gmail"auto_discover(booleano, opcional, predeterminado: true) — Descubrir automáticamente nuevas APIs si es necesario
Ejemplo: "Encuéntrame una API para convertir divisas en tiempo real"
semantic_discover
Descubrimiento profundo de un proveedor/API específico por nombre e intención.
Entradas:
provider_name(cadena, requerida) — Nombre del proveedor de la API, p. ej. "stripe", "twilio"user_intent(cadena, opcional) — Lo que quieres hacer con esta API
Ejemplo: Descubre las capacidades de Stripe para "procesar un reembolso"
semantic_discover_url
Analiza cualquier API desde su URL de documentación.
Entradas:
url(cadena, requerida) — URL de la documentación de la APIuser_intent(cadena, opcional) — Lo que quieres hacer con esta API
Ejemplo: Analiza https://docs.example.com/api para generar una configuración de proveedor
Relacionados
- Semantic API — El servicio de API alojado
- semanticapi-engine — Motor de código abierto (AGPL-3.0)
- semantic-api-skill — Paquete de habilidades para marcos de agentes
- Herramienta CLI — Interfaz de línea de comandos (
pip install semanticapi-cli)
Licencia
MIT