Nummeropslag

電話番号検索 API

デンマークの電話番号検索、発信者 ID、迷惑電話・信頼性シグナルを提供する、公開 パートナー API と MCP サーバー です。

デンマークの番号から発信者を特定できます。公式の CVR 登録情報による企業名、通信事業者、番号の種類、匿名ユーザーの報告に基づく 迷惑電話・信頼性の判定 を確認できます。スクレイピングではなく、公式のオープンデータを利用しています。あらゆる HTTP クライアントから利用できるほか、MCP サーバー を Claude やその他の AI エージェントに直接接続できます。

🌐 サービス：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 エージェント）🤖

AI エージェント（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 を参照）で公開されています。自由にコピーして変更できます。Nummeropslag API サービス自体とそのデータはプロプライエタリです。利用には nummeropslag.dk の利用規約が適用されます。