Nummeropslag

Identificación de llamadas danesa centrada en la privacidad, consulta de empresas CVR, datos de operador y señales de spam.

GitHub

Documentación

API de Nummeropslag

Partner API pública + servidor MCP para consulta de números de teléfono daneses, identificación de llamadas y señales de spam/confianza.

Identifica quién llama desde un número danés: empresa del registro oficial CVR, operador de telecomunicaciones, tipo de número y un veredicto de spam/confianza basado en informes de usuarios anónimos. Impulsado por datos abiertos oficiales, no por scraping. Úsalo desde cualquier cliente HTTP o conecta el servidor MCP directamente a Claude y otros agentes de IA.

🌐 Servicio: nummeropslag.dk · 🔑 Obtén una clave: /api-noegle · 📖 Referencia de API: Redoc · 🧪 Sandbox en vivo: /api-reference · 🤖 MCP

Este repositorio contiene solo documentación pública de la API, la especificación OpenAPI, ejemplos de clientes y el servidor MCP. El código fuente del backend es privado.

Autenticación

Todos los endpoints requieren una clave de API, enviada en el encabezado X-API-Key:

X-API-Key: npk_your_key_here

Cada clave tiene un plan, un conjunto de alcances (lookup, spam, operator) y una cuota de solicitudes. Consulta el estado de tu clave en cualquier momento mediante GET /api/v1/partner/me.

URL base: https://nummeropslag.dk/api/v1

Endpoints

Método	Endpoint	Alcance	Descripción
GET	`/partner/lookup/{e164}`	`lookup`	Consulta completa: operador, empresas CVR, señales de spam/confianza
GET	`/partner/spam/{e164}`	`spam`	Solo veredicto compacto de spam/confianza
GET	`/partner/operator/{e164}`	`operator`	Operador de telecomunicaciones + tipo de número
GET	`/partner/search?q=`	`lookup`	Buscar empresas por nombre (CVR)
GET	`/partner/me`	—	Estado de tu clave: plan, alcances, cuota/uso

{e164} acepta un número danés de 8 dígitos o E.164 completo, p. ej. 33633363 o +4533633363.

Contrato completo legible por máquina: openapi/openapi.yaml · openapi/openapi.json.

Inicio rápido

export NUMMEROPSLAG_API_KEY=npk_your_key_here

curl -H "X-API-Key: $NUMMEROPSLAG_API_KEY" \
  https://nummeropslag.dk/api/v1/partner/spam/33633363

Ejemplos de clientes

Clientes listos para ejecutar y sin dependencias en examples/:

Lenguaje	Archivo	Ejecutar
Bash / curl	`examples/curl.sh`	`./curl.sh 33633363`
Python (stdlib)	`examples/python_client.py`	`python3 python_client.py 33633363`
Node.js 18+	`examples/node_client.js`	`node node_client.js 33633363`
PHP	`examples/php_client.php`	`php php_client.php 33633363`

Todos leen la clave de la variable de entorno NUMMEROPSLAG_API_KEY.

Integraciones de flujos de trabajo

Usa Nummeropslag como nodos y herramientas nativos en los constructores populares de automatización y flujos de trabajo de IA:

Plataforma	Integración	Ubicación
n8n	Nodo comunitario con cinco operaciones y soporte de herramientas de IA	`integrations/n8n`
Dify	Complemento de herramienta instalable para Workflows, Chatflows y Agents	`integrations/dify`
Langflow	Componente personalizado con soporte de modo herramienta	`integrations/langflow`
Flowise	Funciones y esquemas de herramientas personalizadas listos para pegar	`integrations/flowise`

Las integraciones almacenan la clave de API en el sistema de credenciales/secretos de cada plataforma y envían consultas solo a https://nummeropslag.dk.

Servidor MCP (agentes de IA) 🤖

Dale a tu agente de IA (Claude Desktop, Claude Code o cualquier cliente del Model Context Protocol) acceso directo a los datos de números de teléfono daneses. El servidor en mcp/ envuelve la Partner API como herramientas MCP: los mismos datos oficiales, las mismas reglas de privacidad (sin nombres de personas privadas).

Instalación de escritorio con un clic

Descarga el paquete nummeropslag-mcp-*.mcpb más reciente desde GitHub Releases, ábrelo con un cliente de escritorio compatible e ingresa tu clave de API de Nummeropslag cuando se te solicite. El paquete usa el runtime administrado uv, por lo que los usuarios no necesitan instalar dependencias de Python manualmente.

El identificador canónico del registro es io.github.andrey-tut/nummeropslag.

Docker

El mismo servidor stdio se publica como una imagen OCI pública:

docker run --rm -i \
  -e NUMMEROPSLAG_API_KEY=npk_your_key_here \
  ghcr.io/andrey-tut/nummeropslag-mcp:latest

Las llamadas MCP se miden contra una cuota MCP separada (no tu cuota REST); el servidor envía X-Client: mcp automáticamente.

Herramientas

Herramienta	Descripción
`lookup_number(number)`	Registro completo: empresa (CVR), operador, spam/confianza, comentarios
`check_spam(number)`	Veredicto compacto de spam/estafa (estilo identificador de llamadas)
`get_operator(number)`	Solo operador + tipo de número (el más económico)
`search_businesses(query, limit)`	Encontrar empresas danesas por nombre (CVR)
`api_status()`	Alcances de tu clave + uso de cuota

Configuración — vía PyPI (recomendado)

pip install nummeropslag-mcp                    # or: uvx nummeropslag-mcp
export NUMMEROPSLAG_API_KEY=npk_your_key_here   # https://nummeropslag.dk/api-noegle
nummeropslag-mcp                                # stdio transport

Agregar a Claude Desktop (claude_desktop_config.json) o Claude Code (.mcp.json):

{
  "mcpServers": {
    "nummeropslag": {
      "command": "nummeropslag-mcp",
      "env": { "NUMMEROPSLAG_API_KEY": "npk_your_key_here" }
    }
  }
}

Ejecutar desde el código fuente en su lugar (sin PyPI)

pip install "mcp[cli]" httpx
python mcp/server.py

…y usa "command": "python", "args": ["/absolute/path/to/nummeropslag-api/mcp/server.py"] en la configuración anterior.

Reinicia tu cliente y luego pregunta, por ejemplo, "¿Es +45 70 10 20 30 spam?" o "¿Quién es el dueño de 33 63 33 63?".

Errores

Los errores usan un envoltorio consistente:

{ "error": { "code": "forbidden", "message": "…", "details": {} } }

Códigos comunes: unauthorized (clave faltante/inválida), forbidden (alcance no permitido), rate_limited (cuota excedida), not_found.

Datos y privacidad

Datos principales: CVR oficial (empresas + unidades de producción) y el plan de numeración danés (SDFI, CC0).
Los veredictos de spam usan k-anonimato: una etiqueta pública de "spam" requiere varios informes independientes.
Los nombres de personas privadas nunca se exponen. Los contactos nunca se cargan (cumplimiento del RGPD).

Política de privacidad

El servidor MCP envía solo el número de teléfono o la consulta empresarial solicitada por el usuario a la API de Nummeropslag de primera parte. No lee conversaciones, archivos, contactos ni registros de llamadas. Consulta la política de privacidad completa de Nummeropslag para obtener información sobre recopilación, uso, retención, intercambio y contacto de datos.

Licencia

Los ejemplos de clientes y la especificación OpenAPI en este repositorio se publican bajo la Licencia MIT (consulta LICENSE): cópialos y adáptalos libremente. El servicio de API de Nummeropslag en sí y sus datos son propietarios; su uso se rige por los términos en nummeropslag.dk.