Nummeropslag

API Nummeropslag

Partner API pública + servidor MCP para consulta de números de telefone dinamarqueses, identificação de chamadas e sinais de spam/confiança.

Identifique quem está ligando de um número dinamarquês: empresa do registro oficial CVR, operadora de telecomunicações, tipo de número e um veredito de spam/confiança baseado em relatos anônimos de usuários. Alimentado por dados abertos oficiais — sem scraping. Use-o a partir de qualquer cliente HTTP ou conecte o servidor MCP diretamente ao Claude e outros agentes de IA.

🌐 Serviço: nummeropslag.dk · 🔑 Obtenha uma chave: /api-noegle · 📖 Referência da API: Redoc · 🧪 Sandbox ao vivo: /api-reference · 🤖 MCP

Este repositório contém apenas documentação pública da API, a especificação OpenAPI, exemplos de clientes e o servidor MCP. O código-fonte do backend é privado.

Autenticação

Todos os endpoints exigem uma chave de API, enviada no cabeçalho X-API-Key:

X-API-Key: npk_your_key_here

Cada chave possui um plano, um conjunto de escopos (lookup, spam, operator) e uma cota de solicitações. Verifique o status da sua chave a qualquer momento via GET /api/v1/partner/me.

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

Endpoints

{e164} aceita um número dinamarquês de 8 dígitos ou E.164 completo — ex.: 33633363 ou +4533633363.

Contrato completo legível por máquina: openapi/openapi.yaml · openapi/openapi.json.

Início 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

Exemplos de clientes

Clientes prontos para execução, sem dependências, em examples/:

Todos leem a chave da variável de ambiente NUMMEROPSLAG_API_KEY.

Integrações de fluxo de trabalho

Use o Nummeropslag como nós e ferramentas nativos em construtores populares de automação e fluxos de trabalho de IA:

As integrações armazenam a chave de API no sistema de credenciais/segredos de cada plataforma e enviam consultas apenas para https://nummeropslag.dk.

Servidor MCP (agentes de IA) 🤖

Dê ao seu agente de IA (Claude Desktop, Claude Code ou qualquer cliente Model Context Protocol) acesso direto aos dados de números de telefone dinamarqueses. O servidor em mcp/ encapsula a Partner API como ferramentas MCP — mesmos dados oficiais, mesmas regras de privacidade (sem nomes de pessoas físicas).

Instalação desktop em um clique

Baixe o pacote nummeropslag-mcp-*.mcpb mais recente de GitHub Releases, abra-o com um cliente desktop compatível e insira sua chave de API Nummeropslag quando solicitado. O pacote usa o runtime gerenciado uv, portanto os usuários não precisam instalar dependências Python manualmente.

O identificador canônico do registro é io.github.andrey-tut/nummeropslag.

Docker

O mesmo servidor stdio é publicado como uma imagem OCI pública:

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

As chamadas MCP são medidas contra uma cota MCP separada (não sua cota REST); o servidor envia X-Client: mcp automaticamente.

Ferramentas

Configuração — via 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

Adicionar ao Claude Desktop (claude_desktop_config.json) ou Claude Code (.mcp.json):

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

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

Reinicie seu cliente e pergunte, por exemplo, "O +45 70 10 20 30 é spam?" ou "Quem é o dono do 33 63 33 63?".

Erros

Os erros usam um envelope consistente:

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

Códigos comuns: unauthorized (chave ausente/inválida), forbidden (escopo não permitido), rate_limited (cota excedida), not_found.

Dados e privacidade

• Dados principais: CVR oficial (empresas + unidades de produção) e o plano de numeração dinamarquês (SDFI, CC0).
• Vereditos de spam usam k-anonimato — um rótulo público de "spam" exige vários relatos independentes.
• Nomes de pessoas físicas nunca são expostos. Contatos nunca são enviados (em conformidade com a GDPR).

Política de privacidade

O servidor MCP envia apenas o número de telefone ou consulta comercial solicitada pelo usuário à API Nummeropslag de primeira parte. Ele não lê conversas, arquivos, contatos ou registros de chamadas. Consulte a política de privacidade completa do Nummeropslag para informações sobre coleta, uso, retenção, compartilhamento e contato.

Licença

Os exemplos de clientes e a especificação OpenAPI neste repositório são publicados sob a Licença MIT (veja LICENSE) — copie e adapte livremente. O serviço da API Nummeropslag em si e seus dados são proprietários; o uso é regido pelos termos em nummeropslag.dk.