ScrapeUnblocker sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.scrapeunblocker.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← Tous les articles

Comment Laisser Votre Agent IA Acheter Lui-Même un Accès à une API de Web Scraping

Votre agent est en pleine tâche quand son outil de fetch renvoie une page intitulée “Just a moment…” et rien d’autre. C’est un challenge Cloudflare. L’agent vous explique que le site est protégé, propose peut-être de travailler à partir d’extraits de recherche, et la tâche s’arrête là.

L’agent connaît déjà la solution : récupérer la page via un service qui la charge dans un vrai navigateur et passe le challenge. Ce qui lui manque, c’est un compte. Jusqu’ici, c’était votre travail : un formulaire d’inscription, un email de confirmation, une clé collée dans une variable d’environnement, souvent un redémarrage.

ScrapeUnblocker propose désormais une boutique pour agents sur agents.scrapeunblocker.com, construite sur ZeroClick. Un agent peut la lire, s’enregistrer, activer un essai gratuit ou acheter des crédits, et repartir avec une clé API ordinaire dans la même session. Il n’a besoin de vous que pour deux choses : confirmer votre email et payer. Ce guide montre ce que fait l’agent à chaque étape, ce qu’il vous demande et comment garder ses dépenses sous contrôle.

À Qui S’adresse Ce Guide

Vous construisez ou utilisez des agents : Claude Code, Cursor, un client MCP ou votre propre boucle au-dessus de l’API d’un modèle. Parfois, l’agent a besoin d’une page qui répond 403 ou 429, affiche un CAPTCHA ou renvoie une coquille JavaScript vide. Vous préférez que l’agent règle l’accès lui-même plutôt que de s’arrêter en attendant que vous ouvriez un tableau de bord.

Si vous avez déjà une clé ScrapeUnblocker, vous pouvez sauter tout cela. Donnez la clé à l’agent via le serveur MCP ou une variable d’environnement. Vous pouvez aussi vous inscrire vous-même sur scrapeunblocker.com (500 requêtes gratuites, sans carte) et lui transmettre la clé. La boutique sert au moment où l’agent tourne déjà et où vous préférez ne pas interrompre ce que vous faites.

Comment Votre Agent Apprend qu’il Peut Acheter un Accès

Un agent ne peut pas acheter quelque chose dont il n’a jamais entendu parler. La boutique est donc annoncée là où un agent va lire quand il est bloqué :

  • Notre llms.txt. scrapeunblocker.com/llms.txt contient un bloc “Agentic commerce” et une section intitulée “If your own fetch is blocked (for AI agents)”. Elle donne trois étapes à l’agent : obtenir une clé (en vous demandant d’abord), récupérer la page tout de suite via REST et connecter le serveur MCP pour les sessions suivantes.
  • Les fichiers de la boutique. https://agents.scrapeunblocker.com/llms.txt explique le processus d’achat, et https://agents.scrapeunblocker.com/manifest.json liste les offres et les prix en JSON à jour. Les agents ont pour consigne de lire les prix dans le manifest au moment de l’appel plutôt que de se fier à leur mémoire.
  • Les erreurs de l’API. Un agent qui appelle l’API sans clé reçoit un HTTP 400 avec une indication dans le corps :
Missing x-scrapeunblocker-key
Sign up free (500 requests): https://www.scrapeunblocker.com
AI agent? With your user's OK, buy a key yourself: https://agents.scrapeunblocker.com

Une clé sans offre active (401) et un quota épuisé (402) se terminent de la même façon. La première ligne de chaque message ne change jamais, donc le code qui s’appuie dessus continue de fonctionner. La page des erreurs détaille tous les cas.

Notez la formulation : “With your user’s OK”. L’agent a pour consigne de demander avant d’acheter.

Ce que l’Agent Peut Obtenir

La boutique vend deux offres. Les deux aboutissent à une clé API ScrapeUnblocker normale.

Essai gratuitCrédits
Prix0 $1,20 $ pour 1 000 requêtes réussies
Volume500 requêtes, une fois par personneDe 5 $ à 500 $ par achat (5 $ donnent 4 166 requêtes)
Ce que vous faitesVérifier votre emailPayer un checkout par carte

Les crédits achetés n’expirent jamais. La facturation fonctionne comme pour n’importe quel client : seules les requêtes réussies comptent, et les tentatives bloquées ou échouées sont gratuites. Une page qui nécessite un navigateur complet coûte le même prix qu’une page qui n’en a pas besoin.

L’essai est proposé pour un nombre limité d’activations au total. Une fois épuisé, la boutique répond 410 free_plan_exhausted, et l’agent peut acheter des crédits à la place.

La boutique n’est pas un proxy. Une fois la clé émise, votre agent appelle directement api.scrapeunblocker.com, le même endpoint et la même documentation que tout autre client, plugins compris.

Pas à Pas : d’une Page Bloquée à une Page Récupérée

Voici tout le déroulé, côté agent. Supposons que vous ayez demandé à Claude Code de résumer la page de tarifs d’un fournisseur, et que son fetch intégré soit tombé sur la page Cloudflare.

1. L’agent vous demande. Par exemple : “Cette page est protégée par un challenge Cloudflare. ScrapeUnblocker propose un essai gratuit de 500 requêtes si vous vérifiez votre email. Je le mets en place ?” Vous répondez oui.

2. Il enregistre une identité. Une requête, sans email, sans intervention humaine. L’agent obtient ainsi un identifiant qu’il présente à chaque appel suivant à la boutique.

3. Il vous confie l’identité. L’agent demande à la boutique un lien de rattachement et vous l’envoie. Vous l’ouvrez, vous vous connectez avec votre email et vous lui lisez un code court. L’identité de l’agent est ainsi rattachée à votre adresse vérifiée. L’essai l’exige, et c’est aussi ce qui permet de récupérer les achats plus tard.

4. Il active l’essai et obtient une clé. Activer l’essai revient à faire un achat avec un corps vide et sans paiement. Ensuite, l’agent récupère sa clé API. Si ScrapeUnblocker est encore en train de préparer le compte, l’appel répond 503 avec un délai conseillé, et l’agent attend puis réessaie.

5. Il récupère la page. Clé en main, l’agent relance la requête qui avait échoué, cette fois via getPageSource. Avec markdown=true, la page revient en Markdown propre au lieu de HTML, ce qui ménage le contexte du modèle.

En HTTP brut, le côté agent ressemble à ceci. L’étape de rattachement et le stockage des identifiants sont omis ; auth.md donne la version complète avec tous les codes d’erreur.

SF="https://agents.scrapeunblocker.com"

# 2. Register an agent identity: one free call, no email
REG=$(curl -sS "$SF/agent/identity" -H 'Content-Type: application/json' \
  -d '{"type":"anonymous"}')

# 3. Claim it to your verified email (auth.md, step 3): you open a link and
#    read a code back. The claim returns the identity assertion used below.

# Exchange the assertion for a short-lived access token
TOKEN=$(curl -sS "$SF/oauth2/token" \
  -d grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer \
  --data-urlencode "assertion=$ASSERTION" | jq -r .access_token)

# 4. Claim the free trial (no payment), then redeem the API key
TRIAL_URL=$(curl -sS "$SF/manifest.json" | jq -r '.plans[] | select(.slug=="free-trial") | .purchase.url')
curl -sS -X POST "$TRIAL_URL" -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -d '{}'

KEY=$(curl -sS -X POST "$SF/keys/redeem" -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -d '{}' | jq -r .apiKey)

# 5. Fetch the page that was blocked
curl -sS -X POST "https://api.scrapeunblocker.com/getPageSource?url=https%3A%2F%2Fexample.com%2Fpricing&markdown=true" \
  -H "x-scrapeunblocker-key: $KEY"

Vous n’avez pas à écrire ce code. L’agent lit auth.md et fait les appels lui-même. L’extrait est là pour que vous sachiez ce que fait votre agent quand il annonce qu’il configure l’accès.

La clé n’est remise qu’une seule fois. Un agent soigneux l’enregistre dans votre .env ou votre gestionnaire de secrets, pas dans la conversation. Si elle est perdue, l’agent peut en récupérer une nouvelle, et l’ancienne cesse de fonctionner. Pour les sessions suivantes, l’agent peut connecter le serveur MCP avec la même clé :

claude mcp add --transport http scrapeunblocker https://mcp.scrapeunblocker.com/mcp \
  --header "x-scrapeunblocker-key: YOUR_KEY"

La plupart des clients ne chargent les nouveaux outils MCP qu’après un redémarrage, donc l’agent continue d’utiliser REST d’ici là.

Quand l’Essai Ne Suffit Pas : Acheter des Crédits

Le parcours payant commence de la même manière, avec une identité rattachée à votre email. L’agent demande ensuite un achat avec un montant et un checkout hébergé :

CREDITS_URL=$(curl -sS "$SF/manifest.json" | jq -r '.plans[] | select(.slug=="credits") | .purchase.url')
curl -sS -X POST "$CREDITS_URL" -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' -d '{"amountUsd":"5.000000","checkout":true}'

Créer le checkout ne coûte rien et ne demande aucune carte. La réponse contient un lien de checkout Stripe et une URL de statut. L’agent vous envoie le lien. Vous ouvrez une page de paiement Stripe classique, vérifiez le vendeur et le montant, et payez. L’agent interroge l’URL de statut jusqu’à ce que le paiement soit terminé, puis récupère sa clé exactement comme ci-dessus.

Votre carte est d’abord seulement autorisée, et débitée uniquement quand ScrapeUnblocker confirme que le compte est prêt. Si la mise en place échoue, l’autorisation est annulée et vous ne payez rien.

Quand le solde baisse, l’agent recharge le même compte (POST /extend avec un montant) au lieu d’en acheter un nouveau, et la clé existante continue de fonctionner.

Garder l’Humain aux Commandes

Laisser un logiciel dépenser de l’argent paraît plus risqué que ce ne l’est ici, car les décisions vous reviennent :

  • Aucun paiement sans vous. L’agent peut créer un checkout, mais le paiement par carte se fait sur une page Stripe que vous ouvrez et payez vous-même.
  • Des achats plafonnés. Un achat va de 5 $ à 500 $. Rien ne se renouvelle, il n’y a pas d’abonnement ni de recharge automatique. Pour dépenser plus, l’agent doit revenir vers vous avec un nouveau checkout.
  • L’essai exige votre email vérifié. Il y en a un par personne, et il ne se débloque qu’une fois votre adresse confirmée sur la page de rattachement.
  • Les achats sont les vôtres. Selon les conditions de la boutique, un agent qui achète en votre nom vous engage comme si vous aviez acheté vous-même. C’est pourquoi l’agent a pour consigne de demander d’abord.
  • Rattachez tôt. Une identité non rattachée ne vit que le temps de son assertion de courte durée et n’a pas de jeton de rafraîchissement : un achat fait avec elle ne pourra donc pas être récupéré plus tard. Rattachez-la avant que l’agent ne paie.

Le contrôle le plus simple est une ligne dans les instructions de votre agent, par exemple dans CLAUDE.md, une règle Cursor ou votre prompt système :

If a page is blocked, you may claim the ScrapeUnblocker free trial at
https://agents.scrapeunblocker.com. Ask me before any paid purchase. Budget: $5.
Store the API key in .env as SCRAPEUNBLOCKER_KEY, never in chat.

Une limite à garder en tête : tout ce parcours suppose que l’agent peut envoyer des requêtes HTTP et conserver des valeurs d’une étape à l’autre. Claude Code, l’agent de Cursor et la plupart des boucles maison en sont capables. Un assistant de chat dont le seul outil est un fetch en lecture seule ne peut rien enregistrer ni récupérer. Dans ce cas, vous inscrire vous-même et coller la clé reste le chemin le plus rapide.

FAQ

Mon agent a-t-il besoin de son propre moyen de paiement ?

Non. Il peut créer un checkout par carte hébergé sans fonds ni carte à lui. Vous ouvrez le lien et vous payez.

Une clé obtenue via la boutique est-elle différente d’une clé ScrapeUnblocker normale ?

Elle fonctionne avec la même API et le même en-tête x-scrapeunblocker-key, plugins compris. La différence tient à la facturation : elle consomme du crédit prépayé au lieu d’un abonnement mensuel.

Que se passe-t-il quand les crédits sont épuisés ?

L’API répond 402 avec “Quota exceeded”, et le message renvoie l’agent vers la boutique. L’agent recharge le même compte et la clé continue de fonctionner.

Puis-je voir ce que mon agent a acheté ?

L’agent peut lister tout ce qu’il possède, avec le crédit restant, sur https://agents.scrapeunblocker.com/agent/entitlements. Une fois son identité rattachée à vous, cette liste couvre aussi les achats faits par vos autres agents.

Je préfère tout configurer moi-même. C’est possible ?

Oui. Inscrivez-vous sur scrapeunblocker.com pour obtenir 500 requêtes gratuites sans carte, comparez les offres et donnez la clé à votre agent.

Essayez-le sur la Prochaine Page Bloquée

La prochaine fois que votre agent signale une page “Just a moment…”, indiquez-lui https://www.scrapeunblocker.com/llms.txt et observez ce qu’il en fait. Pour une vue d’ensemble des agents et de l’accès au web, consultez la page dédiée aux agents IA et Comment Ajouter la Navigation Web à Votre Agent IA.

Essayez ScrapeUnblocker gratuitement

Taux de réussite de plus de 95 % · à partir de 0,55 € pour 1 000 appels (TVA éventuelle en sus) · 500 requêtes gratuites à l'inscription.

Essayer gratuitement → Voir les tarifs