ADHX - Leitor de Posts do X/Twitter

Busque qualquer post do X/Twitter como JSON estruturado para análise usando a API ADHX.

Visão Geral

ADHX é um serviço de recuperação de terceiros. Ele pode fornecer dados estruturados de posts/artigos públicos; não prometa todos os posts, conteúdo completo, acesso gratuito ou métricas atuais. Verifique a disponibilidade do provedor e o tempo de recuperação do registro. Não envie URLs privadas, cookies ou tokens de autenticação.

Quando Usar Esta Habilidade

• Use quando um usuário compartilhar um link do X/Twitter e quiser ler, analisar ou resumir o post.
• Use quando precisar de dados estruturados de um post do X/Twitter (autor, engajamento, conteúdo).
• Use ao trabalhar com Artigos do X de formato longo que precisam de extração de conteúdo completo.

Endpoint da API

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

Padrões de URL

Extraia username e statusId de qualquer um dos seguintes formatos de URL:

Fluxo de Trabalho

Quando um usuário compartilha um link do X/Twitter:

1. Analise a URL para extrair username e statusId dos segmentos do caminho.
2. Busque o JSON usando curl:

curl --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/{username}/{statusId}"

3. Use a resposta estruturada para responder à pergunta do usuário (resumir, analisar, extrair pontos-chave, etc.).

Esquema de Resposta

{
  "id": "statusId",
  "url": "original x.com URL",
  "text": "short-form tweet text (empty if article post)",
  "author": {
    "name": "Display Name",
    "username": "handle",
    "avatarUrl": "profile image URL"
  },
  "createdAt": "timestamp",
  "engagement": {
    "replies": 0,
    "retweets": 0,
    "likes": 0,
    "views": 0
  },
  "article": {
    "title": "Article title (for long-form posts)",
    "previewText": "First ~200 chars",
    "coverImageUrl": "hero image URL",
    "content": "Full markdown content with images"
  }
}

Instalação

Opção A: Marketplace de plugins do Claude Code (recomendado)

/plugin marketplace add itsmemeworks/adhx

Opção B: Instalação manual

# AAS already includes this skill; installing a second copy is optional.
# Review an immutable upstream revision in a private staging directory first.
# Copy into an explicitly selected host directory only if the user requested installation.
# Preserve an existing host skill instead of overwriting it silently.

Exemplos

Exemplo 1: Resumir um tweet

Usuário: "Resuma este post https://x.com/dgt10011/status/2020167690560647464"

curl --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/dgt10011/2020167690560647464"

Em seguida, use o JSON retornado para fornecer o resumo.

Exemplo 2: Analisar engajamento

Usuário: "Quantas curtidas este tweet recebeu? https://x.com/handle/status/123"

1. Analisar URL: nome de usuário = handle, statusId = 123
2. Buscar: curl --fail --show-error --silent --max-time 20 "https://adhx.com/api/share/tweet/handle/123"
3. Retorne o valor engagement.likes da resposta.

Melhores Práticas

• Analise e valide uma URL HTTPS do x.com, twitter.com ou adhx.com com o caminho exato /<handle>/status/<decimal-ID>. Rejeite credenciais incorporadas, handles/IDs malformados e hosts não relacionados em vez de interpolar entradas arbitrárias em solicitações.
• Verifique o campo article quando o usuário desejar o conteúdo completo (não apenas o texto do tweet).
• Use o campo engagement quando os usuários perguntarem sobre curtidas, retweets ou visualizações.
• Não tente fazer scraping direto do x.com - use esta API em vez disso.

Notas

• O endpoint ilustrado historicamente não exigia autenticação; não infira acesso a posts privados ou excluídos.
• Funciona tanto com tweets curtos quanto com artigos do X de formato longo.
• Use o método de recuperação selecionado pelo usuário; se a API de terceiros não estiver disponível, use um navegador/fonte autorizado ou informe que o conteúdo não pôde ser recuperado.
• Se a API retornar um erro ou uma resposta vazia, informe ao usuário que o post pode não estar disponível.

Recursos Adicionais

• Repositório GitHub do ADHX
• Site do ADHX

Limitações

…