En bref. La recherche web de Claude accepte une liste de domaines autorisés ou bloqués, avec des règles de correspondance et des restrictions supplémentaires selon l’environnement API.

Définition : Au 17 octobre 2026, Anthropic documente des paramètres de l’API qui limitent les résultats de recherche web de Claude à une liste de domaines autorisés ou excluent une liste de domaines bloqués. Ces paramètres font partie de la configuration de l’outil de recherche dans une application utilisant Claude.

Points clés

La documentation de l’outil de recherche web d’Anthropic décrit allowed_domains et blocked_domains ; une requête contenant les deux renvoie une erreur 400.
Le guide des outils côté serveur indique que l’ajout d’un domaine à une liste inclut aussi ses sous-domaines.
Le guide des restrictions de domaines de Managed Agents prévoit des listes de domaines distinctes pour web_search et web_fetch.

Comment configurer une restriction de domaines ?

Une liste de domaines autorisés sélectionne les domaines pouvant figurer dans les résultats. Une liste de domaines bloqués exclut les domaines indiqués. La définition de l’outil de recherche web d’Anthropic place l’un ou l’autre de ces paramètres dans l’objet de l’outil fourni dans la requête API.

Cet extrait JSON adapte la définition documentée de l’outil pour limiter la recherche à example.com :

{
  "tools": [
    {
      "type": "web_search_20250305",
      "name": "web_search",
      "allowed_domains": ["example.com"]
    }
  ]
}

Pour exclure des domaines, la configuration remplace allowed_domains par blocked_domains. Les entrées sont des domaines seuls, éventuellement suivis d’un chemin, sans https://. Cet extrait configure l’outil ; la requête complète fournit aussi le modèle et les messages présentés dans la même documentation.

Quelles URL correspondent à une entrée de liste ?

Les règles de filtrage des domaines d’Anthropic précisent que example.com couvre docs.example.com. L’ajout de docs.example.com limite les résultats à ce sous-domaine et exclut le domaine parent ainsi que le sous-domaine de même niveau api.example.com.

La recherche web accepte les chemins : l’exemple documenté example.com/blog correspond à example.com/blog/post-1. Un caractère générique (wildcard) est autorisé dans le chemin, comme dans example.com/*/articles ; un caractère générique dans le domaine, comme *.example.com, est invalide. Les formats invalides produisent une erreur 400 invalid_request_error.

Le guide de Managed Agents apporte une précision sur les noms d’hôte : www.example.com couvre ses propres sous-domaines, tandis que l’ajout de example.com couvre à la fois le domaine seul et www.example.com.

Comment les paramètres d’organisation et d’agent s’articulent-ils ?

Le guide des outils côté serveur exige que les domaines de la liste allowed_domains d’une requête appartiennent à toute liste de domaines autorisés définie au niveau de l’organisation dans Claude Console. Une entrée extérieure à cette liste provoque une erreur de validation. Une requête qui autorise un domaine bloqué par l’organisation reçoit également une erreur 400 précisant le conflit.

Le guide de Managed Agents d’Anthropic indique que les paramètres d’organisation de la Console s’appliquent uniquement aux requêtes de l’API Messages. Les sessions Managed Agents utilisent des listes définies dans l’ensemble d’outils de leur agent, chaque liste étant limitée à 64 domaines. Un environnement dont l’accès réseau est réglé sur limited applique en plus allowed_hosts, sa liste d’hôtes réseau autorisés ; les listes des outils restreignent davantage l’accès au sein de ces hôtes.

Comment vérifier une recherche filtrée ?

La documentation des réponses de recherche web d’Anthropic décrit des blocs de résultats contenant les champs url et title d’une source. L’examen de ces champs permet à une application de comparer les pages renvoyées à la liste configurée. Les objets de citation indiquent séparément les URL des sources citées. Une recherche réussie sans résultat correspondant renvoie une liste content vide.

Termes associés

Questions fréquentes

Puis-je utiliser ensemble une liste de domaines autorisés et une liste de domaines bloqués ?

Choisissez une seule liste par configuration d’outil. La documentation de recherche web prévoit une erreur 400 lorsque vous fournissez les deux dans la même requête.

Une restriction de recherche configure-t-elle aussi la récupération web ?

Avec Managed Agents, vous configurez chaque outil séparément. Le guide des restrictions de domaines indique que chaque outil possède sa propre liste.

Puis-je limiter la recherche à une partie d’un site web ?

Vous pouvez fournir un chemin tel que example.com/blog. Pour Managed Agents, Anthropic recommande des noms d’hôte seuls, car le fournisseur de recherche interprète les suffixes de chemin comme des motifs d’URL.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Peut-on limiter la recherche web de Claude à certains domaines ?