Nummeropslag

Nummeropslag API

面向丹麦电话号码查询、来电显示和垃圾电话／信任信号的公开 合作伙伴 API + MCP 服务。

识别丹麦号码的来电者：官方 CVR 登记中的公司、电信运营商、号码类型，以及基于匿名用户举报的垃圾电话／信任判定。由官方开放数据提供支持，而非抓取数据。可通过任何 HTTP 客户端使用，也可以将 MCP 服务 直接接入 Claude 和其他 AI Agent。

🌐 服务：nummeropslag.dk · 🔑 获取密钥：/api-noegle · 📖 API 参考：Redoc · 🧪 在线沙盒：/api-reference · 🤖 MCP

此仓库仅包含公开 API 文档、OpenAPI 规范、客户端示例和 MCP 服务。后端源代码为私有。

身份验证

所有端点均需要 API 密钥，并通过 X-API-Key 标头发送：

X-API-Key: npk_your_key_here

每个密钥都有一个套餐、一组作用域（lookup、spam、operator）和一个请求配额。 可随时通过 GET /api/v1/partner/me 查看密钥状态。

基础 URL：https://nummeropslag.dk/api/v1

端点

{e164} 接受 8 位丹麦号码或完整的 E.164 格式，例如 33633363 或 +4533633363。

完整的机器可读规范：openapi/openapi.yaml · openapi/openapi.json。

快速开始

export NUMMEROPSLAG_API_KEY=npk_your_key_here

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

客户端示例

examples/ 中提供可直接运行、无需依赖的客户端：

所有示例都从 NUMMEROPSLAG_API_KEY 环境变量读取密钥。

工作流集成

在常见的自动化与 AI 工作流构建器中，将 Nummeropslag 用作原生节点和工具：

这些集成会将 API 密钥存储在各平台的凭据／机密系统中， 且仅向 https://nummeropslag.dk 发送查询。

MCP 服务（AI Agent）🤖

让你的 AI Agent（Claude Desktop、Claude Code 或任何 Model Context Protocol 客户端） 直接访问丹麦电话号码数据。mcp/ 中的服务将 Partner API 封装为 MCP 工具——使用相同的官方数据，并遵守相同的隐私规则（不包含私人个人的姓名）。

一键安装桌面应用

从 GitHub Releases 下载最新的 nummeropslag-mcp-*.mcpb 捆绑包，用兼容的桌面客户端打开，并在出现提示时输入你的 Nummeropslag API 密钥。该捆绑包使用托管的 uv 运行时，因此用户无需手动安装 Python 依赖项。

规范注册表标识符为 io.github.andrey-tut/nummeropslag。

Docker

同一个 stdio 服务以公共 OCI 镜像的形式发布：

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

MCP 调用计入单独的 MCP 配额（不占用 REST 配额）；服务会自动发送 X-Client: mcp。

工具

设置 — 通过 PyPI（推荐）

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

添加到 Claude Desktop（claude_desktop_config.json）或 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

重启客户端，然后尝试询问 “+45 70 10 20 30 是垃圾电话吗？” 或 “33 63 33 63 属于谁？”。

错误

错误使用统一的封装格式：

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

常见代码：unauthorized（缺少或无效的密钥）、forbidden（权限范围不允许）、 rate_limited（超出配额）、not_found。

数据与隐私

• 核心数据：官方 CVR（公司及生产单位）和丹麦号码计划（SDFI，CC0）。
• 垃圾电话判定采用 k-匿名性——公开标记为“垃圾电话”需要多份独立报告。
• 绝不公开私人个人的姓名。 联系人信息绝不会上传（符合 GDPR）。

隐私政策

MCP 服务只会将用户请求的电话号码或企业查询发送到第一方 Nummeropslag API。它不会读取对话、文件、联系人或通话记录。有关数据收集、使用、保留、共享和联系信息，请参阅完整的 Nummeropslag 隐私政策。

许可证

本仓库中的客户端示例和 OpenAPI 规范采用 MIT License 发布（参见 LICENSE）——可自由复制和改编。Nummeropslag API 服务本身及其数据为专有内容；使用须遵守 nummeropslag.dk 上的条款。