Xquik-dev/x-twitter-scraper

O que x-twitter-scraper faz?

Habilidade de API de raspagem do Twitter para pesquisa de tweets, pesquisa avançada, tweets de perfil, exportação de seguidores, download de mídia, monitores, webhooks, MCP e automação de postagem: envio de tweets e respostas.

Funcionalidades

• Pesquisa de Tweets: Busca tweets por palavras-chave, hashtags ou termos avançados.
• Pesquisa Avançada: Suporte a operadores de pesquisa do Twitter (como from:, to:, near:, etc.).
• Tweets de Perfil: Recupera tweets de um perfil específico do Twitter.
• Exportação de Seguidores: Exporta a lista de seguidores de uma conta.
• Download de Mídia: Baixa imagens, vídeos e GIFs de tweets.
• Monitores: Cria monitores contínuos para rastrear palavras-chave ou perfis.
• Webhooks: Envia notificações em tempo real via webhooks.
• MCP (Model Context Protocol): Integração com o protocolo MCP para comunicação entre agentes.
• Postagem Automática: Envia tweets e respostas diretamente pela API.

Como Usar

1. Configure as credenciais da API do Twitter (Bearer Token ou API Keys).
2. Defina as variáveis de ambiente (ex.: TWITTER_BEARER_TOKEN, TWITTER_API_KEY).
3. Utilize os endpoints disponíveis conforme a documentação para realizar as operações desejadas.

Exemplo de Uso

import requests

# Exemplo de pesquisa de tweets
response = requests.get(
    "https://api.xquik.dev/twitter/search",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    params={"query": "IA agents"}
)
print(response.json())

Configuração de Webhooks

1. Crie um webhook no seu serviço de destino.
2. Registre a URL do webhook na configuração do scraper.
3. Os dados dos tweets serão enviados automaticamente para a URL configurada.

Suporte a MCP

O scraper suporta o protocolo MCP, permitindo que agentes de IA troquem contexto e comandos de forma padronizada.

Notas

• Respeite os limites de taxa da API do Twitter.
• Use apenas para fins legais e de acordo com os termos de serviço do Twitter.