ADHX - Lecteur de posts X/Twitter
Récupère n'importe quel post X/Twitter sous forme de JSON structuré pour analyse via l'API ADHX.
Présentation
ADHX fournit une API gratuite qui renvoie un JSON propre pour n'importe quel post X, y compris le contenu complet des articles longs. C'est bien supérieur au scraping ou aux approches basées sur un navigateur pour la consommation par un LLM. Fonctionne avec les tweets classiques et les articles X complets.
Quand utiliser cette compétence
- Lorsqu'un utilisateur partage un lien X/Twitter et souhaite lire, analyser ou résumer le post
- Lorsque vous avez besoin de données structurées d'un post X/Twitter (auteur, engagement, contenu)
- Lorsque vous travaillez avec des articles X longs nécessitant une extraction complète du contenu
Point d'accès API
https://adhx.com/api/share/tweet/{username}/{statusId}
Formats d'URL
Extrayez username et statusId de l'un de ces formats d'URL :
| Format | Exemple |
|---|---|
x.com/{user}/status/{id} | https://x.com/dgt10011/status/2020167690560647464 |
twitter.com/{user}/status/{id} | https://twitter.com/dgt10011/status/2020167690560647464 |
adhx.com/{user}/status/{id} | https://adhx.com/dgt10011/status/2020167690560647464 |
Flux de travail
Lorsqu'un utilisateur partage un lien X/Twitter :
- Analyser l'URL pour extraire
usernameetstatusIddes segments du chemin - Récupérer le JSON à l'aide de curl :
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
- Utiliser la réponse structurée pour répondre à la question de l'utilisateur (résumer, analyser, extraire les points clés, etc.)
Schéma de réponse
{
"id": "statusId",
"url": "URL x.com d'origine",
"text": "texte du tweet court (vide s'il s'agit d'un article)",
"author": {
"name": "Nom affiché",
"username": "pseudo",
"avatarUrl": "URL de l'image de profil"
},
"createdAt": "horodatage",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "Titre de l'article (pour les posts longs)",
"previewText": "Premiers ~200 caractères",
"coverImageUrl": "URL de l'image principale",
"content": "Contenu complet en Markdown avec images"
}
}
Installation
Option A : Place de marché des plugins Claude Code (recommandé)
/plugin marketplace add itsmemeworks/adhx
Option B : Installation manuelle
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
Exemples
Exemple 1 : Résumer un tweet
Utilisateur : "Résume ce post https://x.com/dgt10011/status/2020167690560647464"
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
Utilisez ensuite le JSON renvoyé pour fournir le résumé.
Exemple 2 : Analyser l'engagement
Utilisateur : "Combien de likes ce tweet a-t-il obtenu ? https://x.com/handle/status/123"
- Analyser l'URL : username =
handle, statusId =123 - Récupérer :
curl -s "https://adhx.com/api/share/tweet/handle/123" - Renvoyer la valeur
engagement.likesde la réponse
Bonnes pratiques
- Toujours analyser l'URL complète pour extraire username et statusId avant d'appeler l'API
- Vérifier la présence du champ
articlelorsque l'utilisateur souhaite le contenu complet (pas seulement le texte du tweet) - Utiliser le champ
engagementlorsque les utilisateurs posent des questions sur les likes, les retweets ou les vues - Ne pas tenter de scraper x.com directement - utilisez cette API à la place
Remarques
- Aucune authentification requise
- Fonctionne aussi bien avec les tweets courts qu'avec les articles X longs
- Toujours préférer cette méthode au scraping basé sur un navigateur pour le contenu X
- Si l'API renvoie une erreur ou une réponse vide, informez l'utilisateur que le post n'est peut-être pas disponible
Ressources supplémentaires
Limitations
- N'utilisez cette compétence que lorsque la tâche correspond clairement au périmètre décrit ci-dessus.
- Ne considérez pas la sortie comme un substitut à une validation, un test ou une revue experte spécifique à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées requises, les autorisations, les limites de sécurité ou les critères de succès sont manquants.