ADHX - Leitor de Posts X/Twitter
Busque qualquer post do X/Twitter como JSON estruturado para análise usando a API ADHX.
Visão Geral
ADHX fornece uma API gratuita que retorna JSON limpo para qualquer post do X, incluindo o conteúdo completo de artigos longos. Esta abordagem é muito superior a scraping ou métodos baseados em navegador para consumo por LLMs. Funciona tanto com tweets curtos quanto com Artigos X completos.
Quando Usar Esta Skill
- Use quando um usuário compartilhar um link do X/Twitter e quiser ler, analisar ou resumir o post
- Use quando você precisar de dados estruturados de um post do X/Twitter (autor, engajamento, conteúdo)
- Use ao trabalhar com Artigos X longos que precisam de extração completa de conteúdo
Endpoint da API
https://adhx.com/api/share/tweet/{username}/{statusId}
Padrões de URL
Extraia username e statusId de qualquer um destes formatos de URL:
| Formato | Exemplo |
|---|---|
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 |
Fluxo de Trabalho
Quando um usuário compartilhar um link do X/Twitter:
- Analise a URL para extrair
usernameestatusIddos segmentos do caminho - Busque o JSON usando curl:
curl -s "https://adhx.com/api/share/tweet/{username}/{statusId}"
- Use a resposta estruturada para responder à pergunta do usuário (resumir, analisar, extrair pontos-chave, etc.)
Esquema da Resposta
{
"id": "statusId",
"url": "URL original do x.com",
"text": "texto curto do tweet (vazio se for post de artigo)",
"author": {
"name": "Nome de Exibição",
"username": "handle",
"avatarUrl": "URL da imagem de perfil"
},
"createdAt": "timestamp",
"engagement": {
"replies": 0,
"retweets": 0,
"likes": 0,
"views": 0
},
"article": {
"title": "Título do artigo (para posts longos)",
"previewText": "Primeiros ~200 caracteres",
"coverImageUrl": "URL da imagem principal",
"content": "Conteúdo completo em markdown com imagens"
}
}
Instalação
Opção A: Plugin do Claude Code (recomendado)
/plugin marketplace add itsmemeworks/adhx
Opção B: Instalação manual
curl -sL https://raw.githubusercontent.com/itsmemeworks/adhx/main/skills/adhx/SKILL.md -o ~/.claude/skills/adhx/SKILL.md
Exemplos
Exemplo 1: Resumir um tweet
Usuário: "Resuma este post https://x.com/dgt10011/status/2020167690560647464"
curl -s "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"
- Analise a URL: username =
handle, statusId =123 - Busque:
curl -s "https://adhx.com/api/share/tweet/handle/123" - Retorne o valor de
engagement.likesda resposta
Melhores Práticas
- Sempre analise a URL completa para extrair username e statusId antes de chamar a API
- Verifique o campo
articlequando o usuário quiser o conteúdo completo (não apenas o texto do tweet) - Use o campo
engagementquando os usuários perguntarem sobre curtidas, retweets ou visualizações - Não tente fazer scraping do x.com diretamente - use esta API
Notas
- Nenhuma autenticação necessária
- Funciona tanto com tweets curtos quanto com artigos longos do X
- Sempre prefira esta abordagem ao scraping baseado em navegador para conteúdo do X
- Se a API retornar um erro ou resposta vazia, informe ao usuário que o post pode não estar disponível
Recursos Adicionais
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica de ambiente, testes ou revisão de especialistas.
- Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.