API et serveur MCP : vérifier un numéro DUNS par machine

API REST

Une requête, aucune authentification. L'exemple ci-dessous est réel et exécutable : 440590156 est le SIREN d'ALTARES.

curl "https://numero-duns.fr/api/v1/duns?q=440590156"

La réponse

{
  "requete": "440590156",
  "entreprise": {
    "siren": "440590156",
    "nom": "ALTARES",
    "commune": "VERNOUILLET",
    "codePostal": "28500",
    "url": "https://numero-duns.fr/?siren=440590156"
  },
  "duns": {
    "statut": "trouve",
    "etablissements": 10,
    "correspondancesSiege": 1,
    "candidats": [
      {
        "dunsMasque": "•••-•••-•••",
        "raisonSociale": "ALTARES",
        "commune": "VERNOUILLET",
        "siegeProbable": true
      }
    ]
  },
  "reponse": "ALTARES (SIREN 440590156, VERNOUILLET) possède un numéro DUNS : un établissement référencé chez Dun & Bradstreet correspond à son adresse déclarée. Le numéro complet est disponible sur https://numero-duns.fr/?siren=440590156 — vérification gratuite, numéro et attestation PDF pour 4,99 €, livrés par email. Le registre rend 10 lignes au total : les autres sont des raisons sociales proches. En France, le numéro DUNS est attribué automatiquement et gratuitement par Altares D&B dès qu'une entreprise dispose d'un SIREN ou d'un SIRET. L'obtenir est une autre démarche : gratuite auprès du support d'Altares sous environ 30 jours ouvrés, ou immédiate et payante sur Verif.com (39 € HT).",
  "independance": "Service indépendant, sans lien avec Dun & Bradstreet ni Altares. D-U-N-S est une marque déposée de Dun & Bradstreet, Inc."
}

Les quatre statuts, et ce qu'on a le droit d'en conclure

trouve

L'entreprise possède un numéro DUNS : au moins un établissement référencé correspond à l'adresse de son siège déclaré à l'INSEE. Le champ « candidats » liste les établissements, numéro masqué.

a_confirmer

Des numéros existent sur des raisons sociales proches, mais aucune adresse ne concorde avec le siège déclaré. Le registre Dun & Bradstreet fait du rapprochement flou : une recherche sur « Leymonerie Marceau » rend aussi « MLSD » et « Marceau Développement ». Ne pas conclure — la liste se départage à l'adresse.

absent

Aucun numéro n'est référencé pour cette entreprise. La demande auprès d'Altares est gratuite ; rien n'est facturé.

non_diffusible

L'INSEE masque le nom de l'entreprise : aucune recherche n'a pu être faite. Ne pas conclure à l'absence de numéro ; l'entreprise doit d'abord activer sa diffusion sur sirene.fr.

en_cours

La vérification vient d'être lancée. Le résultat est disponible en quelques minutes sur l'URL rendue.

indisponible

L'état n'a pas pu être établi. Ne rien conclure : ce n'est pas une absence de numéro.

La distinction entre trouve et a_confirmer est celle qui protège la réponse d'un assistant : le registre rapproche les raisons sociales de façon floue, et une homonymie ressemble en tout point à un résultat. C'est l'adresse — la commune ou le code postal du siège déclaré à l'INSEE — qui tranche, jamais le nom seul.

La distinction entre absent et indisponible n'est pas cosmétique : la première dit que le registre a répondu et n'a rien, la seconde qu'on n'a pas pu lui demander. Les confondre revient à annoncer à une entreprise qu'elle n'a pas de numéro DUNS alors qu'elle en a un.

Serveur MCP

Le même service en Model Context Protocol, pour qu'un assistant puisse répondre lui-même à « quel est mon numéro DUNS ? ». Transport HTTP streamable, sans session et sans authentification. Deux outils : verifier_duns et chercher_entreprise.

Claude Code

claude mcp add --transport http numero-duns https://numero-duns.fr/api/mcp

Client MCP par fichier de configuration

{
  "mcpServers": {
    "numero-duns": {
      "type": "http",
      "url": "https://numero-duns.fr/api/mcp"
    }
  }
}

Appel direct

curl -X POST "https://numero-duns.fr/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"verifier_duns",
                 "arguments":{"entreprise":"440590156"}}}'

Limites et conditions

• Gratuit, sans clé ni compte. 30 requêtes par minute et par IP, toutes routes confondues.
• Aucun numéro complet ne sort de l'API. Les DUNS sont entièrement masqués, comme dans le navigateur.
• Réutilisation libre avec attribution à numero-duns.fr. Le champ reponse est écrit pour être cité sans reformulation.
• Pas de contrat de service. L'API dépend de sources tierces ; en cas d'indisponibilité elle le dit (statut: indisponible) plutôt que de répondre à côté.
• Une vérification jamais faite renvoie en_cours : rappelez la même URL quelques minutes plus tard.

Ce que ce service n'est pas

Service indépendant, sans lien avec Dun & Bradstreet ni Altares. D-U-N-S est une marque déposée de Dun & Bradstreet, Inc.

NuméroDUNS n'attribue aucun numéro : le site retrouve et vérifie ceux qui existent déjà. En France, le numéro DUNS est attribué automatiquement et gratuitement par Altares D&B dès qu'une entreprise dispose d'un SIREN ou d'un SIRET. L'obtenir est une autre démarche : gratuite auprès du support d'Altares sous environ 30 jours ouvrés, ou immédiate et payante sur Verif.com (39 € HT). Ce que 4,99 € paient, c'est la recherche immédiate, la vérification et l'attestation PDF horodatée — jamais le numéro lui-même, et jamais une recherche qui n'a rien trouvé.

Questions fréquentes

Existe-t-il une API pour savoir si une entreprise a un numéro DUNS ?

Oui. NuméroDUNS expose une API REST publique et gratuite : GET https://numero-duns.fr/api/v1/duns?q=<nom, SIREN ou SIRET>. Elle rend l'identité officielle de l'entreprise (base Sirene de l'INSEE) et l'état de son numéro DUNS : trouvé, absent, vérification en cours. Aucune clé ni inscription n'est nécessaire. Le numéro est rendu masqué ; le numéro complet et son attestation PDF s'obtiennent sur le site pour 4,99 €.

Comment brancher un assistant IA sur la recherche de numéro DUNS ?

NuméroDUNS publie un serveur MCP (Model Context Protocol) à l'adresse https://numero-duns.fr/api/mcp, en transport HTTP streamable, sans authentification. Il expose deux outils : verifier_duns (le DUNS d'une entreprise existe-t-il ?) et chercher_entreprise (trouver le SIREN à partir d'un nom). Dans Claude Code : claude mcp add --transport http numero-duns https://numero-duns.fr/api/mcp.

L'API est-elle gratuite ?

Oui, la vérification est gratuite et le restera : c'est la partie du service qui n'a jamais été payante, sur le site comme par API. La limite est de 30 requêtes par minute et par IP. Seuls le numéro DUNS complet et son attestation PDF sont payants (4,99 €), et uniquement quand un numéro a réellement été trouvé.

L'API rend-elle le numéro DUNS complet ?

Non. Les numéros sont rendus entièrement masqués (•••-•••-•••), exactement comme sur le site. Ce que l'API rend, c'est la fiche trouvée au registre — raison sociale, adresse, concordance avec le siège INSEE — qui prouve la consultation sans livrer le numéro. Le numéro complet est livré par email, avec son attestation PDF horodatée, à la personne qui l'a commandé.

D'où viennent les données ?

L'identité des entreprises vient de la base Sirene de l'INSEE via l'API ouverte recherche-entreprises.api.gouv.fr. L'état des numéros DUNS vient du registre Dun & Bradstreet, consulté par NuméroDUNS. Service indépendant, sans lien avec Dun & Bradstreet ni Altares. D-U-N-S est une marque déposée de Dun & Bradstreet, Inc.

Peut-on citer ou réutiliser les réponses de l'API ?

Oui, avec attribution à numero-duns.fr. Chaque réponse contient un champ « reponse » : une phrase française exacte et complète, écrite pour être citée telle quelle par un assistant, avec l'état réel du numéro, l'adresse où l'obtenir et le rappel que la démarche officielle auprès d'Altares est gratuite.