ADHX - X/Twitter-Beitragsleser
Rufe jeden X/Twitter-Beitrag als strukturiertes JSON zur Analyse über die ADHX-API ab.
Übersicht
ADHX bietet eine kostenlose API, die sauberes JSON für jeden X-Beitrag zurückgibt, einschließlich des vollständigen Langtext-Artikelinhalts. Dies ist für die LLM-Verarbeitung weitaus besser geeignet als Scraping oder browserbasierte Ansätze. Funktioniert sowohl mit normalen Tweets als auch mit vollständigen X-Artikeln.
Wann diese Fähigkeit verwendet werden sollte
- Wenn ein Nutzer einen X/Twitter-Link teilt und den Beitrag lesen, analysieren oder zusammenfassen möchte
- Wenn strukturierte Daten von einem X/Twitter-Beitrag benötigt werden (Autor, Engagement, Inhalt)
- Wenn mit langen X-Artikeln gearbeitet wird, die eine vollständige Textextraktion erfordern
API-Endpunkt
https://adhx.com/api/share/tweet/{username}/{statusId}
URL-Muster
Extrahiere username und statusId aus einem dieser URL-Formate:
| Format | Beispiel |
|---|---|
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 |
Arbeitsablauf
Wenn ein Nutzer einen X/Twitter-Link teilt:
- URL parsen, um
usernameundstatusIdaus den Pfadsegmenten zu extrahieren - JSON abrufen mit curl:
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
- Strukturierte Antwort verwenden, um die Frage des Nutzers zu beantworten (zusammenfassen, analysieren, Kernpunkte extrahieren usw.)
Antwortschema
{
"id": "statusId",
"url": "originale x.com-URL",
"text": "Kurzer Tweet-Text (leer bei Artikelbeiträgen)",
"author": {
"name": "Anzeigename",
"username": "Handle",
"avatarUrl": "Profilbild-URL"
},
"createdAt": "Zeitstempel",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "Artikeltitel (bei Langtext-Beiträgen)",
"previewText": "Erste ~200 Zeichen",
"coverImageUrl": "Heldenbild-URL",
"content": "Vollständiger Markdown-Inhalt mit Bildern"
}
}
Installation
Option A: Claude Code Plugin-Marktplatz (empfohlen)
/plugin marketplace add itsmemeworks/adhx
Option B: Manuelle Installation
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
Beispiele
Beispiel 1: Tweet zusammenfassen
Nutzer: "Fasse diesen Beitrag zusammen https://x.com/dgt10011/status/2020167690560647464"
curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"
Dann das zurückgegebene JSON verwenden, um die Zusammenfassung zu liefern.
Beispiel 2: Engagement analysieren
Nutzer: "Wie viele Likes hat dieser Tweet? https://x.com/handle/status/123"
- URL parsen: username =
handle, statusId =123 - Abrufen:
curl -s "https://adhx.com/api/share/tweet/handle/123" - Den Wert
engagement.likesaus der Antwort zurückgeben
Best Practices
- Immer die vollständige URL parsen, um username und statusId vor dem API-Aufruf zu extrahieren
- Das
article-Feld prüfen, wenn der Nutzer den vollständigen Inhalt haben möchte (nicht nur den Tweet-Text) - Das
engagement-Feld verwenden, wenn Nutzer nach Likes, Retweets oder Aufrufen fragen - Nicht versuchen, x.com direkt zu scrapen – stattdessen diese API verwenden
Hinweise
- Keine Authentifizierung erforderlich
- Funktioniert sowohl mit kurzen Tweets als auch mit langen X-Artikeln
- Immer browserbasiertem Scraping für X-Inhalte vorziehen
- Wenn die API einen Fehler oder eine leere Antwort zurückgibt, den Nutzer informieren, dass der Beitrag möglicherweise nicht verfügbar ist
Zusätzliche Ressourcen
Einschränkungen
- Diese Fähigkeit nur verwenden, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder fachkundige Überprüfung betrachten.
- Bei fehlenden erforderlichen Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien anhalten und nach Klärung fragen.