Amphybi Docs
Documentation

Tout pour créer vos API
avec Amphybi

Installez l'extension, branchez votre IA, décrivez une tâche avec vos mots et publiez-la en API. Comptez dix minutes pour la première.

Démarrer

Présentation

Amphybi est une extension Chrome qui donne une API aux sites web qui n'en ont pas.

Vous ouvrez un site, vous décrivez la tâche avec vos mots (« Cherche le dossier 2041 et donne-moi son statut »), et l'IA la fait sous vos yeux dans votre navigateur. Vous l'enregistrez, puis vous la publiez en API d'un clic. n8n, Make, votre application ou un agent IA peuvent ensuite l'appeler autant de fois que nécessaire.

1. Décrire

Écrivez la tâche dans la langue de votre choix, sur le site ouvert.

2. Tester

L'IA clique, saisit et lit la page. Vous voyez chaque étape.

3. Enregistrer

La tâche réussie devient une automatisation, avec ses variables.

4. Publier

Vous obtenez une adresse HTTP, une clé et une adresse MCP.

Bon à savoir : c'est votre Chrome qui fait le travail. Pour que vos API répondent, Chrome doit rester ouvert et l'ordinateur ne doit pas être en veille.

Démarrer

Installation

Pas besoin de savoir coder. Comptez deux minutes.

Décompressez le dossier

Décompressez le fichier .zip et rangez le dossier dans Documents. Ne le supprimez pas ensuite : Chrome l'utilise.

Ouvrez la page des extensions

Dans Chrome, tapez chrome://extensions dans la barre d'adresse et appuyez sur Entrée.

Activez le mode développeur

En haut à droite de la page, activez Mode développeur.

Chargez l'extension

Cliquez sur Charger l'extension non empaquetée, puis choisissez le dossier de l'extension.

Épinglez Amphybi

Cliquez sur l'icône puzzle de Chrome, puis sur l'épingle à côté d'Amphybi. Cliquez sur l'icône bleue : le panneau s'ouvre à droite.

Le panneau Amphybi s'ouvre avec un écran d'accueil. Passez à l'étape suivante : brancher votre IA.

Démarrer

Brancher votre IA

Amphybi utilise l'IA de votre choix, avec votre propre clé. Le coût de l'IA est facturé directement par votre fournisseur ; avec Ollama, tout reste gratuit et sur votre ordinateur.

Créez une clé chez votre fournisseur

Par exemple sur aistudio.google.com/apikey pour Gemini, ou console.anthropic.com pour Claude. Le lien exact s'affiche dans les Réglages.

Ouvrez les Réglages d'Amphybi

Choisissez le fournisseur, collez la clé, puis cliquez sur Charger pour lister les modèles disponibles.

Testez la connexion

Cliquez sur Enregistrer, puis sur Tester. Le test vérifie aussi que le modèle sait piloter une page (« tool calling »).

Si le message « ce modèle n'appelle pas les outils » s'affiche, choisissez un modèle plus récent dans la liste. Pour aller plus vite, préférez les modèles « flash », « mini » ou « haiku ».

Démarrer

Compte, essai et paiement

Un compte Amphybi sert à protéger vos API, à synchroniser vos automatisations et à gérer votre offre. Il n'y a pas de mot de passe : vous recevez un code par e-mail.

Connectez-vous avec votre e-mail

Dans l'extension, entrez votre adresse e-mail, puis le code à 6 chiffres reçu (valable 10 minutes). Le premier code crée votre compte et démarre 14 jours d'essai complet, sans carte bancaire.

Choisissez une offre quand vous êtes prêt

Cliquez sur votre initiale en haut à droite, puis sur Voir les offres. Le paiement se fait sur la page sécurisée de GeniusPay : Wave, Orange Money, MTN MoMo, Moov Money ou carte.

L'offre s'active toute seule

L'extension vérifie le paiement auprès du serveur : dès qu'il est confirmé, votre offre est active. Vous pouvez fermer l'onglet de paiement.

Sans prélèvement automatique. Chaque paiement couvre une période (1 mois ou 12 mois). Renouveler avant la fin prolonge votre offre sans perdre de jours.

Synchronisation entre appareils

Vos automatisations suivent votre compte : connectez-vous sur un autre ordinateur et elles apparaissent. La synchronisation se fait toute seule après chaque changement, ou à la demande avec le bouton Synchroniser.

  • La clé secrète d'une API n'est jamais synchronisée : elle reste sur l'appareil où vous l'avez créée. Sur un autre appareil, utilisez Nouvelle clé si besoin.
  • Vos API répondent depuis un seul ordinateur à la fois. Si vous ouvrez Amphybi ailleurs, le premier affiche « Reprendre ici ».
  • Une suppression se propage sur tous vos appareils.

Que se passe-t-il à la fin de l'essai ?

Vos automatisations sont conservées, mais l'Assistant, la publication, la synchronisation et les appels API sont suspendus jusqu'au choix d'une offre. Les appels API reçoivent alors l'erreur PAYMENT_REQUIRED.

Démarrer

Votre première API

Entraînez-vous sur books.toscrape.com, un site fait exprès pour ça.

Décrivez la tâche

Ouvrez books.toscrape.com, puis écrivez dans l'onglet Assistant :

Assistant
Va dans la catégorie Poetry et donne-moi le titre et le prix du premier livre.

Testez

Cliquez sur Tester et regardez l'IA travailler. Le bouton Arrêter interrompt la tâche à tout moment.

Enregistrez

Quand la réponse verte apparaît, cliquez sur Enregistrer et créer l'API. Amphybi repère les valeurs variables (ici, la catégorie).

Publiez

Dans Automatisations, cliquez sur Publier en API. Dans « Champs à renvoyer », tapez titre, prix, puis Publier l'API.

Testez votre API

Dans l'encadré 1. Tester mon API, changez la catégorie (par exemple Travel) et cliquez sur Tester maintenant.

Réponse
{ "titre": "…", "prix": "£…" }

Vous avez créé une API pour un site qui n'en avait pas.

Automatiser

Mode sans IA et auto-réparation

L'IA sert à apprendre une tâche, pas à la répéter. Une fois enregistrée, une automatisation se rejoue sans appeler votre IA : c'est plus rapide, gratuit et plus fiable.

BadgeCe qui s'est passéAppels IA
Sans IATous les éléments ont été retrouvés avec leurs repères enregistrés.0
RéparéeLa page a changé : Amphybi a retrouvé l'élément par son texte ou sa ressemblance, ou en demandant à l'IA une seule petite question. Le nouveau repère est mémorisé.0 ou 1
AppriseLe résultat est lu avec des règles apprises (par exemple « la valeur à côté du libellé Prix »).0
AgentDernier recours : l'IA reprend la tâche.plusieurs

Les règles apprises sont contrôlées : un prix qui ne ressemble plus à un nombre, ou un champ vide, déclenche une réparation au lieu de renvoyer une mauvaise valeur.

Automatiser

Enregistreur visuel et modèles

Enregistrer sans écrire

Lancez l'enregistrement

Dans l'onglet Assistant, cliquez sur Enregistrer, puis faites la tâche normalement sur le site.

Choisissez la donnée

Cliquez sur Choisir une donnée, nommez le champ, puis cliquez sur la valeur voulue dans la page.

Terminez et vérifiez

Relisez les étapes, renommez les valeurs variables (numéro de dossier, ville…), puis enregistrez.

Les mots de passe ne sont jamais enregistrés : l'étape est marquée « à saisir par vous ».

Modèles prêts à l'emploi

L'onglet Assistant propose des modèles (suivi de colis, prix d'un produit, statut de dossier…). Choisissez-en un, remplissez les variables et enregistrez : aucun appel IA n'est nécessaire pour la création.

Automatiser

Planification

Dans Automatisations, cliquez sur Planifier : toutes les X minutes (5 minimum), chaque jour ou certains jours de la semaine, à l'heure choisie.

  • La planification tourne dans le Chrome de l'appareil actif : Chrome doit être ouvert.
  • Chaque exécution planifiée compte dans votre quota mensuel, comme un appel d'API.
  • Option « seulement si le résultat change » : le webhook n'est envoyé que lorsqu'une valeur a changé.
  • Un échec déclenche une notification Chrome.
Automatiser

Webhooks sortants

Après chaque exécution planifiée, Amphybi envoie le résultat à l'adresse https:// de votre choix, sans passer par n8n.

Corps envoyé (JSON)
{ "event": "automation.run", "status": "succeeded",
  "automation": { "id": "…", "name": "Prix du produit" },
  "result": { "prix": "19,90" }, "changed": true }

Vérifier la signature

Chaque envoi porte les en-têtes X-Amphybi-Timestamp et X-Amphybi-Signature: sha256=…. La signature est un HMAC-SHA256 de <timestamp>.<corps brut> avec la clé de signature affichée dans Réglages. Refusez les requêtes trop anciennes.

Node.js
const sig = crypto.createHmac('sha256', SECRET)
  .update(ts + '.' + rawBody).digest('hex');
const ok = req.headers['x-amphybi-signature'] === 'sha256=' + sig;

En cas d'erreur serveur (5xx) ou de réseau, trois tentatives sont faites. Une erreur 4xx n'est pas renvoyée.

Appel d'API asynchrone

Pour les tâches longues, ajoutez callback_url au corps de l'appel : l'API répond tout de suite 202 avec un run_id, puis envoie le résultat signé (api.run.completed) à votre adresse. Les adresses locales, privées et non https sont refusées.

Appel
{ "input": { "numero": "2041" }, "callback_url": "https://votre-serveur.example/amphybi" }
Connecter

n8n, Make, Zapier et votre application

Chaque API publiée est une simple requête POST. Elle se branche partout où l'on peut appeler une adresse HTTP.

n8n

Copiez la requête

Dans Amphybi, ouvrez votre API et cliquez sur Copier pour n8n.

Importez-la

Dans n8n, ajoutez un nœud HTTP Request, cliquez sur Import cURL et collez.

Augmentez le délai

Dans Options → Timeout, mettez 120000 (2 minutes) : une exécution prend de 10 à 60 secondes.

Make, Zapier et votre code

Utilisez le module HTTP de l'outil avec l'adresse, la clé et le corps ci-dessous.

curl
curl -X POST "https://VOTRE-RELAIS/v1/ESPACE/actions/ID/run" \
  -H "Authorization: Bearer kp_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "categorie": "Travel" } }'
JavaScript
const res = await fetch(ENDPOINT, {
  method: "POST",
  headers: { Authorization: `Bearer ${CLE}`, "Content-Type": "application/json" },
  body: JSON.stringify({ input: { categorie: "Travel" } })
});
const data = await res.json();
Connecter

Agents IA (MCP)

Chaque API publiée est aussi un serveur MCP. Votre agent (Claude, Cursor, un agent n8n…) l'utilise comme un outil, et décide seul quand l'appeler.

Copiez l'adresse et la clé

Dans l'encadré 3. Brancher à un agent IA (MCP), copiez l'adresse MCP et la clé.

Ajoutez le serveur à votre agent

Ajoutez un serveur MCP de type HTTP, avec l'adresse et l'en-tête Authorization: Bearer <clé>.

Configuration MCP (exemple)
{
  "mcpServers": {
    "stock-article": {
      "type": "http",
      "url": "https://VOTRE-RELAIS/mcp/ESPACE/ID",
      "headers": { "Authorization": "Bearer kp_live_…" }
    }
  }
}

Le nom et la description de l'automatisation servent de description à l'outil : choisissez-les clairs pour que l'agent sache quand l'utiliser.

Connecter

Référence de l'API

Exécuter une automatisation

ÉlémentValeur
MéthodePOST
Adresse/v1/{espace}/actions/{id}/run
AuthentificationAuthorization: Bearer kp_live_…
Corps{ "input": { "<variable>": "<valeur>" } }
RéponseLes champs choisis à la publication, ou answer (texte) si aucun champ n'a été choisi.
DescriptionGET /v1/{espace}/actions/{id} renvoie les entrées et sorties attendues.

Codes d'erreur

CodeSignificationQue faire
MISSING_INPUTUne variable attendue est absente ou vide.Vérifiez le corps input.
ACTION_NOT_FOUNDL'API n'est plus publiée.Republiez l'automatisation.
BROWSER_OFFLINEChrome est fermé ou l'ordinateur est en veille.Ouvrez Chrome et désactivez la veille.
HUMAN_REQUIREDLe site demande une connexion ou une vérification.Connectez-vous une fois au site dans Chrome, puis réessayez.
SENSITIVE_ACTION_BLOCKEDLa tâche voulait envoyer, payer, valider ou supprimer.Republiez en autorisant les actions sensibles, si c'est voulu.
PAYMENT_REQUIREDL'essai est terminé et aucune offre n'est active.Choisissez une offre dans l'extension.
QUOTA_EXCEEDEDLe quota d'appels du mois est atteint.Passez à l'offre supérieure ou attendez le mois suivant.
INVALID_CALLBACK_URLAdresse de retour non autorisée (non https, locale ou privée).Utilisez une adresse https:// publique.
EXECUTION_FAILEDLa tâche n'a pas abouti (page changée, élément introuvable…).Refaites la tâche dans l'Assistant et réenregistrez-la.
Comprendre

Langues

Amphybi n'est pas limité au français. Décrivez vos tâches dans la langue de votre choix : français, anglais, espagnol, portugais, arabe… L'IA comprend votre demande et la page, même si le site est dans une autre langue, et répond dans votre langue.

Français

Cherche le dossier 2041 et donne-moi son statut.

English

Find order #5521 and return its delivery status.

Español

Busca el expediente 2041 y dame su estado.

Português

Procura o processo 2041 e diz-me o seu estado.

العربية

ابحث عن الملف 2041 وأعطني حالته.

La qualité dépend du modèle choisi : les grands modèles récents gèrent très bien les langues moins courantes.

Comprendre

Limites et offres

LimiteValeur
Débit par API30 requêtes par minute
Exécutions simultanées1 à la fois par navigateur (les suivantes attendent leur tour)
Durée maximale2 minutes par exécution
Étapes maximales25 actions par tâche
Champs de sortie12 au maximum
DisponibilitéTant que Chrome est ouvert et l'ordinateur allumé

Offres

OffrePrix (1 mois)API publiéesAppels / moisActions sensibles
Essai 14 joursGratuit2510 000Oui
Essentiel7 900 FCFA31 000Non
Pro19 000 FCFA2510 000Oui
Équipe51 800 FCFA20050 000Oui

Chaque compte commence par 14 jours d'essai sans carte bancaire. Tarif annuel : -20 %. Le paiement couvre une période, sans prélèvement automatique. L'IA est payée directement à votre fournisseur. Les quotas sont appliqués par le serveur et se remettent à zéro chaque mois. Comparer les offres

Comprendre

Sécurité et confidentialité

Mots de passe protégés

L'extension ne tape jamais de mot de passe, de code OTP ni de numéro de carte. Elle réutilise la session où vous êtes déjà connecté.

Actions sensibles bloquées

Envoyer, payer, valider, supprimer : confirmation demandée dans l'Assistant, refus par défaut dans l'API.

Vos clés restent chez vous

Les clés d'IA restent dans votre navigateur. Le relais ne connaît que l'empreinte de vos clés d'API.

Ce qui circule

Le contenu de la page est envoyé à votre fournisseur d'IA pendant une tâche. Le relais voit les entrées et résultats des API, jamais vos cookies.

Règle d'or : automatisez uniquement des sites auxquels vous avez légitimement accès, dans le respect de leurs conditions et de la protection des données. Commencez par des tâches en lecture. Aucun contournement de CAPTCHA.

Comprendre

Cas d'usage

Un bon candidat est une tâche répétitive, courte (moins de 10 clics), sur un site stable sans API.

Aide

Dépannage

Ce que vous voyezQue faire
« Impossible de lire la page »Ouvrez un vrai site : les pages chrome:// et les PDF ne marchent pas.
« Clé refusée »Recopiez la clé dans Réglages, puis cliquez sur Tester.
« Ce modèle n'appelle pas les outils »Choisissez un modèle plus récent dans la liste.
Le modèle ne répond plusChoisissez un modèle plus rapide (« flash », « mini », « haiku »).
Ollama ne répond pasLancez-le avec OLLAMA_ORIGINS="chrome-extension://*".
Serveur API en « Connexion… »Vérifiez Internet, puis fermez et rouvrez le panneau.
« Limite d'étapes atteinte »Découpez la tâche en demandes plus petites.
L'automatisation ne marche plusLe site a changé : refaites la tâche dans l'Assistant et réenregistrez-la.
Aide

Mettre à jour

Remplacez le dossier de l'extension par la nouvelle version, puis cliquez sur l'icône de rechargement dans chrome://extensions. Vos automatisations, vos clés et vos API publiées sont conservées.

Aucun résultat. Essayez un autre mot, par exemple « n8n », « clé » ou « erreur ».