SamuelChien/mega-skills-collection

ADHX - Lector de Publicaciones X/Twitter

Obtén cualquier publicación de X/Twitter como JSON estructurado para análisis usando la API de ADHX.

Descripción General

ADHX proporciona una API gratuita que devuelve JSON limpio para cualquier publicación de X, incluyendo el contenido completo de artículos largos. Esto es muy superior al scraping o enfoques basados en navegador para consumo por LLMs. Funciona tanto con tweets normales como con Artículos X completos.

Cuándo Usar Esta Habilidad

• Úsala cuando un usuario comparta un enlace de X/Twitter y quiera leer, analizar o resumir la publicación
• Úsala cuando necesites datos estructurados de una publicación de X/Twitter (autor, interacción, contenido)
• Úsala cuando trabajes con Artículos X largos que necesiten extracción completa de contenido

Endpoint de la API

https://adhx.com/api/share/tweet/{username}/{statusId}

Patrones de URL

Extrae username y statusId de cualquiera de estos formatos de URL:

Formato	Ejemplo
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

Flujo de Trabajo

Cuando un usuario comparta un enlace de X/Twitter:

1. Analiza la URL para extraer username y statusId de los segmentos de la ruta
2. Obtén el JSON usando curl:

curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"

3. Usa la respuesta estructurada para responder a la pregunta del usuario (resumir, analizar, extraer puntos clave, etc.)

Esquema de Respuesta

{
  "id": "statusId",
  "url": "URL original de x.com",
  "text": "texto del tweet corto (vacío si es artículo)",
  "author": {
    "name": "Nombre a Mostrar",
    "username": "handle",
    "avatarUrl": "URL de la imagen de perfil"
  },
  "createdAt": "marca de tiempo",
  "engagement": {
    "replies": 0,
    "retweets": 0,
    "likes": 0,
    "views": 0
  },
  "article": {
    "title": "Título del artículo (para publicaciones largas)",
    "previewText": "Primeros ~200 caracteres",
    "coverImageUrl": "URL de la imagen principal",
    "content": "Contenido completo en markdown con imágenes"
  }
}

Instalación

Opción A: Marketplace de plugins de Claude Code (recomendada)

/plugin marketplace add itsmemeworks/adhx

Opción B: Instalación manual

curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md

Ejemplos

Ejemplo 1: Resumir un tweet

Usuario: "Resume esta publicación https://x.com/dgt10011/status/2020167690560647464"

curl -s "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"

Luego usa el JSON devuelto para proporcionar el resumen.

Ejemplo 2: Analizar interacción

Usuario: "¿Cuántos likes tiene este tweet? https://x.com/handle/status/123"

1. Analiza URL: username = handle, statusId = 123
2. Obtén: curl -s "https://adhx.com/api/share/tweet/handle/123"
3. Devuelve el valor engagement.likes de la respuesta

Mejores Prácticas

• Siempre analiza la URL completa para extraer username y statusId antes de llamar a la API
• Verifica el campo article cuando el usuario quiera contenido completo (no solo texto del tweet)
• Usa el campo engagement cuando los usuarios pregunten por likes, retweets o vistas
• No intentes hacer scraping de x.com directamente - usa esta API en su lugar

Notas

• No se requiere autenticación
• Funciona tanto con tweets cortos como con artículos largos de X
• Siempre prefiere esto sobre el scraping basado en navegador para contenido de X
• Si la API devuelve un error o respuesta vacía, informa al usuario que la publicación puede no estar disponible

Recursos Adicionales

• Repositorio de GitHub de ADHX
• Sitio Web de ADHX

Limitaciones

• Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
• No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión de expertos.
• Detente y pide aclaración si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.