Points clés
Un appel incapable de récupérer la page doit l'indiquer rapidement. Auto apprend désormais, site par site, si la recherche d'autres sorties permet encore de récupérer la page. Lorsque ce n'est presque jamais le cas, l'appel s'interrompt dès la première recherche infructueuse. Single, Proxy Finder et Auto renvoient aussi un statut clair 400 pour une URL contenant un espace, la révocation d'une session dans le Dashboard déconnecte cet appareil immédiatement, et MCP 0.8.4 maintient offload_large fonctionnel après le nettoyage de son dossier de payload.
Nouveautés
Auto apprend quand chercher plus de sorties est inutile
La semaine dernière, Auto a commencé à limiter les appels à trois requêtes de navigateur sur les sites où celles effectuées après la troisième ne ramènent presque jamais la page. Désormais, il applique cet apprentissage à l'étape suivante. Si la recherche d'une sortie après ces trois navigateurs n'a rien donné récemment sur ce site, l'appel s'arrête dès la première recherche qui revient vide. Cela reste en vigueur pendant les 24 heures suivantes, puis Auto vérifie à nouveau.
La réponse précise la situation : error commence par the browser has not got through to this site, et status contient la dernière réponse du site. Vous savez donc pourquoi l'appel s'est arrêté avant de décider de réessayer.
L'arrêt est défini par site, et non par clé API. Comme il s'applique à tous ceux qui interrogent ce site, Auto le détermine d'après la réponse directe du site et non selon votre règle validate (une règle stricte de votre part ne peut pas le déclencher). De plus, un appel avec exitClass: "premium" bénéficie toujours de ses sorties premium.
Le rôle de Auto est de trouver la route. Dès qu'il vous transmet une session fonctionnelle sur un site, rejouez cette session sur Single ou Browser pour traiter le volume. Smart Fetch (Auto) montre le rejeu et détaille chaque cas où un appel Auto peut s'interrompre plus tôt.
Un 400 explicite pour un espace dans une URL
Les crawlers extraient les liens exactement comme une page les écrit, et les pages écrivent parfois des éléments étranges : javascript: void(0), un lien de partage contenant une phrase entière. Envoyez à Single, Proxy Finder ou Auto une URL contenant un espace ou un caractère de contrôle, et vous obtenez désormais un 400 avant que la requête ne quitte FourA :
invalid URL: it contains a space; encode it as %20 (the URL as sent: "...")
Rien n'est récupéré, aucun crédit n'est dépensé et le résultat est client_error (voir Request Outcomes). Le navigateur fait exception: il encode l'espace lui-même et récupère la page.
Le correctif de votre côté ne prend que quelques lignes. Résolvez chaque lien par rapport à sa page d'origine, ignorez ceux qui ne sont pas des pages, puis encodez le reste:
from urllib.parse import urljoin, quote
import requests
SKIP = ("javascript:", "mailto:", "tel:")
def to_fetch(page_url, href):
href = href.strip()
if href.lower().startswith(SKIP):
return None
# %20 for a space; an already-encoded link stays as it is
return quote(urljoin(page_url, href), safe=":/?#[]@!$&'()*+,;=%")
url = to_fetch("https://example.com/shop/", "/items/blue shoes?size=42")
# -> https://example.com/items/blue%20shoes?size=42
r = requests.post(
"https://api.foura.ai/api/single",
headers={"X-API-Key": "pk_live_..."},
json={"url": url},
).json()
Problèmes courants présente le symptôme et le correctif côte à côte.
Révoquer une session déconnecte l'appareil immédiatement
Les Paramètres disposent d'un onglet Sessions qui répertorie chaque session sur l'ensemble de vos appareils. Sélectionnez-y des sessions, cliquez sur Révoquer la sélection, et ces appareils sont déconnectés du Dashboard sur-le-champ, tout comme avec Déconnecter les autres. Un appareil que vous avez révoqué doit se reconnecter avant de pouvoir ouvrir votre Dashboard.
C'est le bouton idéal pour l'ordinateur portable resté connecté dans les bureaux d'un client. Un seul appareil est déconnecté, et toutes vos autres sessions restent inchangées.
MCP 0.8.4 permet à offload_large de continuer à renvoyer son lien
Avec offload_large: true, le serveur MCP écrit les responses de 50 Ko ou plus sur le disque et transmet à votre client une resource_link à la place du corps. Sur votre propre instance, la documentation vous invite à supprimer du répertoire des payloads les fichiers de plus d'une heure. Dans la version 0.8.4, offload_large continue de renvoyer son lien après ce nettoyage (ou après la purge du dossier temporaire par le système), car le serveur recrée le dossier avant chaque écriture. Un payload dont les fichiers ont disparu renvoie Payload not found.
Cette version met également à jour les dépendances verrouillées, éliminant ainsi les avis de sécurité publiés, et npm audit ne signale aucune vulnérabilité connue. Les outils, leurs schémas et les requests qu'ils envoient ne changent pas. Mettez à jour @fouradata/mcp, ou faites pointer votre client vers le serveur hébergé, qui fonctionne déjà sous 0.8.4. La configuration et toutes les options figurent dans la documentation du serveur MCP.
L'appel en échec le plus économique est celui qui se termine en quelques secondes et vous indique précisément quelle ligne modifier.