Recherche express groupée Xdcc pour Openclaw

Guide les clients lors de la configuration de leur compte xdccy.com, puis suit les envois par lots, résume les données de livraison et exporte des rapports.

xdccycom
v1.0.0
Oct 5, 2026
0
185
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install batch-query

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer batch-query via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Recherche express groupée Xdcc ?

Xdcc Batch Express Query est une skill destinée aux clients qui permet de suivre des colis par lots via xdccy.com. Elle peut guider les nouveaux utilisateurs lors de la création de leur compte, récupérer et stocker les identifiants API en toute sécurité, les valider et interroger plusieurs numéros de suivi grâce à des options d’entrée configurables. Les clients doivent effectuer eux-mêmes la vérification par code SMS et curseur ; la skill ne contourne pas ces contrôles de sécurité.

Intégrée à Openclaw Skills, elle transforme une tâche de configuration et de suivi en plusieurs étapes en un processus guidé comprenant des résumés d’état et des exports JSON, CSV compatible avec Excel ou TXT lisible. Elle signale également les numéros d’envoi qui peuvent nécessiter un suffixe de numéro de téléphone avant la requête et fournit des étapes de dépannage pendant la session en cas d’échec de la configuration ou des appels API. Elle sert uniquement au suivi et à la création de rapports, pas à l’expédition de colis, au calcul des frais d’affranchissement ou aux déclarations en douane.

Cas d'utilisation de Recherche express groupée Xdcc

  • Un nouveau client souhaite être guidé lors de son inscription et suivre des envois par lots dans un même processus.
  • Un utilisateur possède déjà des identifiants xdccy.com et doit interroger une liste de numéros de suivi.
  • Une équipe opérationnelle souhaite obtenir des résumés de l’état des livraisons, du nombre de délais dépassés, de la répartition des transporteurs ou des heures de signature.
  • Un utilisateur a besoin d’un rapport JSON, CSV ou TXT pour le traiter ou le partager ultérieurement.
  • Les demandes de suivi peuvent nécessiter un suffixe de numéro de téléphone ; les données téléphoniques manquantes doivent donc être repérées avant le traitement par lots.

Comment fonctionne Recherche express groupée Xdcc

  1. Vérifie si le fichier d’identifiants existe et si les identifiants de suivi sont valides.
  2. Si les identifiants manquent, demande au client son numéro de téléphone et son mot de passe, puis lance le processus guidé d’inscription dans le navigateur. Le client effectue lui-même les vérifications par SMS et curseur.
  3. Récupère la clé API du compte, associe les identifiants de plateforme et d’utilisateur renvoyés aux identifiants de requête, les enregistre en toute sécurité et valide le résultat.
  4. Lit les numéros de suivi depuis un fichier, des arguments intégrés ou un fichier CSV de correspondance téléphonique. Signale les suffixes de téléphone probablement manquants avant la requête.
  5. Envoie des requêtes simultanées à l’API de suivi xdccy.com, analyse les états et détails de suivi des envois et collecte les requêtes qui ont échoué.
  6. Agrège les statistiques de livraison et génère le résultat demandé en JSON, CSV ou TXT. En cas d’échec d’une opération, fournit dans la conversation des étapes concrètes d’autovérification.

Configuration de Recherche express groupée Xdcc

Le moteur de requête utilise la bibliothèque standard de Python. Le processus guidé d’inscription nécessite Playwright ; si cet outil n’est pas disponible, la skill signale le problème au lieu de contourner silencieusement les vérifications d’inscription. Utilisez le point d’entrée fourni onboard.py pour effectuer le processus complet de vérification des identifiants, d’inscription, de validation et de requête.

# Première utilisation : fournir le numéro de téléphone et le mot de passe du client pour l’inscription
python onboard.py --phone <customer-phone> --password <customer-password> --file orders.txt --output results

# Compte existant ou identifiants enregistrés : interroger un fichier de numéros de suivi
python onboard.py --file orders.txt --output results

# Valider les identifiants enregistrés sans lancer de requête
python onboard.py --validate-only

# Exécuter l’autotest statique du package et créer une distribution ZIP
python scripts\/selftest.py
python scripts\/package.py

Le client doit effectuer personnellement les vérifications par SMS et curseur. Ne demandez pas et ne stockez pas le numéro de téléphone complet lorsque seuls les quatre derniers chiffres sont nécessaires au suivi. Ne placez pas les identifiants API dans le code source ou la documentation publique.

Schéma de données et taxonomie de Recherche express groupée Xdcc

Les identifiants sont stockés dans ~\/ .workbuddy\/xdcc-credentials.env avec les clés suivantes :

Clé d’identifiant Rôle
XDCC_PLATFORM_ID Identifiant de plateforme utilisé par l’API de suivi
XDCC_MEMBER_ID Identifiant de membre associé à l’identifiant utilisateur du compte
XDCC_API_KEY Clé API utilisée pour authentifier et signer les requêtes

Les données de suivi peuvent être fournies dans un fichier contenant un enregistrement NO ou NO,TEL par ligne, sous forme de numéros de suivi intégrés via --nos ou dans un CSV de correspondance téléphonique via --telmap. Une valeur commune --tel peut servir de valeur de repli. Les formats de sortie pris en charge sont JSON, CSV UTF-8 avec BOM pour une ouverture directe dans Excel et rapports TXT lisibles.

Les résultats comprennent l’état et la description de l’envoi, les horodatages de collecte/expédition/signature, les villes de collecte et de livraison, les détails du transporteur, les indicateurs de durée et de délai dépassé, ainsi que des événements de suivi tels que TraceList, LastTrace et Count. Les agrégats couvrent la répartition des états, le total des délais dépassés, les moyennes et les pics des heures de signature, la répartition des transporteurs et les échecs. La documentation associée se trouve dans references\/api_reference.md, references\/onboarding_guide.md et references\/SECURITY_AUDIT.md.

Fonctionnalités avancées de Recherche express groupée Xdcc

  • Inscription guidée dans le navigateur, avec remplissage automatique des formulaires et instructions claires sur la page ; le client effectue lui-même les vérifications par SMS et curseur.
  • Orchestration en une seule commande de la vérification des identifiants, de l’inscription si nécessaire, de la validation, des requêtes par lots et de l’exportation.
  • Requêtes simultanées avec une concurrence de cinq par défaut.
  • Plusieurs modes d’entrée, notamment les fichiers, les numéros de suivi intégrés et les correspondances téléphoniques en CSV.
  • Vérifications des préfixes des transporteurs qui avertissent lorsqu’un suffixe téléphonique est probablement manquant ; les numéros de suivi exclusivement numériques ne sont pas devinés.
  • Signature des requêtes respectant la séquence documentée MD5, Base64 et encodage URL, vérifiée à partir de l’exemple officiel.
  • Gestion sécurisée des identifiants, notamment avec des autorisations Unix restrictives, et conseils de dépannage limités à la session.
  • Autotests statiques et script de packaging créant un ZIP versionné sans les répertoires de développement.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*