X Twitter Scraper

Use esta habilidade quando um usuário quiser integrar o Xquik em um aplicativo, script, pipeline de dados ou fluxo de trabalho de agente de IA para tarefas de API X e scraper do Twitter.

Casos de Uso

• Pesquisar tweets, buscar detalhes de tweets, ler linhas do tempo e baixar mídias.
• Consultar usuários, verificar relacionamentos e exportar seguidores ou seguindo.
• Iniciar trabalhos de extração para respostas, repostagens, citações, curtidas, listas, comunidades, artigos e resultados de pesquisa.
• Criar monitores de conta e verificar eventos de webhook com assinatura HMAC.
• Adicionar clientes TypeScript, Python, Go, Java, Kotlin, C#, Ruby, PHP, CLI ou Terraform.
• Executar coleta de tweets e público hospedada através de Apify Actors.
• Conectar runtimes de agentes através do servidor MCP do Xquik.
• Instalar o TweetClaw quando o fluxo de trabalho pertencer ao OpenClaw e precisar de aprovações gerenciadas por plugin para ações de conta X.

Verificações de Fonte

Antes de escrever código, inspecione o material fonte atual do Xquik:

• Documentação da API REST: https://docs.xquik.com/api-reference/overview
• Índice de SDK: https://docs.xquik.com/sdks
• Especificação OpenAPI: https://xquik.com/openapi.json
• Documentação do servidor MCP: https://docs.xquik.com/mcp/overview
• Repositório da habilidade: https://github.com/Xquik-dev/x-twitter-scraper
• Plugin TweetClaw OpenClaw: https://github.com/Xquik-dev/tweetclaw
• Metadados do registro npm do TweetClaw: https://registry.npmjs.org/@xquik%2Ftweetclaw
• Ator X Tweet Scraper: https://apify.com/xquik/x-tweet-scraper
• Ator X Follower Scraper: https://apify.com/xquik/x-follower-scraper

Não invente nomes de endpoints, campos de solicitação, campos de resposta, escopos, preços, limites ou nomes de pacotes. Leia primeiro o README do SDK relevante e a página de referência da API.

Fluxo de Implementação

1. Identifique o fluxo de trabalho: pesquisa, consulta, extração, monitoramento, webhook, mídia, ação de escrita, faturamento ou MCP.
2. Escolha a superfície de integração: SDK gerado para código de aplicativo, REST para clientes personalizados, Apify Actors para coleta hospedada, MCP para agentes, TweetClaw para fluxos de trabalho de plugin OpenClaw ou webhooks para entrega de eventos.
3. Confirme os requisitos de autenticação na documentação e use variáveis de ambiente para chaves de API.
4. Use modelos de solicitação e resposta tipados quando um SDK existir para a linguagem do usuário.
5. Adicione retentativas e paginação de acordo com a documentação do SDK ou da API.
6. Mostre a estimativa de destino e uso, então obtenha aprovação explícita antes de leituras privadas, extrações com medição, sorteios, escritas, monitores, webhooks ou outro trabalho persistente.
7. Mantenha a verificação do webhook no lado do servidor e compare as assinaturas HMAC antes de processar eventos.
8. Retorne dados estruturados para o chamador em vez de raspar a saída de UI gerada.

Padrão de SDK

Quando o código do aplicativo estiver envolvido, combine o SDK com a linguagem do projeto do usuário:

• Inspecione os arquivos do projeto e os manifestos de pacotes para identificar a linguagem e o framework.
• Abra o índice de SDK, então leia o README do SDK correspondente antes de escolher comandos de instalação, nomes de pacotes, importações ou métodos de cliente.
• Prefira o SDK oficial para a linguagem detectada quando um existir.
• Use REST apenas quando a linguagem do projeto não tiver um SDK oficial adequado ou quando o usuário solicitar um cliente personalizado.
• Mantenha as chaves de API em variáveis de ambiente ou no gerenciador de segredos existente do projeto.

Use modelos de solicitação e resposta tipados nativos do projeto. Mantenha as chamadas de rede em código do lado do servidor, a menos que a documentação do SDK suporte explicitamente o uso no navegador.

Padrão de Extração

Use trabalhos de extração para exportações completas ou grandes de seguidores, seguindo, respostas, citações, repostagens, curtidas, listas, comunidades, artigos, mídias e pesquisas.

1. Chame POST /extractions/estimate com o destino e filtros pretendidos.
2. Mostre a estimativa de resultado e a estimativa de uso retornadas.
3. Aguarde a aprovação explícita antes de criar a extração.
4. Consulte o trabalho até um estado terminal, então busque ou exporte seus resultados.

Não trate uma exportação de seguidores baseada em extração como uma leitura pública gratuita. A paginação pública direta e limitada permanece somente leitura.

Padrão de Apify Actor

Use o caminho Apify quando um fluxo de trabalho precisar de execuções hospedadas, conjuntos de dados, agendamentos ou orquestração nativa do Apify.

…