Xquik-dev/xquik-docs

O que xquik-docs faz?

Documentação da API para Xquik - automação completa do X com 120 operações REST API, 2 ferramentas MCP, 23 tipos de extração, webhooks HMAC e guias de SDK.

Visão Geral

Xquik é uma plataforma de automação all-in-one para a rede social X (anteriormente Twitter). Este skill fornece a documentação completa da API REST, permitindo que desenvolvedores e agentes de IA realizem mais de 120 operações diferentes, desde postagem de tweets até extração avançada de dados.

Recursos Principais

• 120+ Operações REST API: Inclui autenticação, timeline, usuários, tendências, buscas, listas, mensagens diretas e muito mais.
• 2 Ferramentas MCP: Integração com Model Context Protocol para uso direto por agentes de IA.
• 23 Tipos de Extração: Extraia tweets, perfis, imagens, vídeos, threads, analytics e mais.
• Webhooks HMAC: Receba notificações em tempo real com assinatura HMAC para segurança.
• SDKs Disponíveis: Guias de integração para Python e Node.js.

Exemplo de Uso (Python)

import requests
from xquik import XquikClient

# Inicialização do cliente
client = XquikClient(api_key="sua_api_key_aqui")

# Obter timeline de tendências
trends = client.trends.get_place(woeid=1)
print(trends)

# Publicar um tweet
response = client.tweets.create(text="Olá, mundo! Usando Xquik para automação.")
print(response)

Endpoints Principais

Recurso	Método	Endpoint	Descrição
Tweets	POST	/api/v1/tweets	Publicar um tweet
Timeline	GET	/api/v1/timeline	Obter timeline do usuário
Trending	GET	/api/v1/trends	Obter tópicos em tendência
Search	GET	/api/v1/search	Buscar tweets por palavra-chave
Usuários	GET	/api/v1/users/:id	Obter perfil de um usuário

Webhooks

Para configurar webhooks seguros com HMAC:

import hmac
import hashlib

# Verificar assinatura do webhook
signature = request.headers.get('X-Xquik-Signature')
expected = hmac.new(
    key=b'seu_segredo_hmac',
    msg=request.body,
    digestmod=hashlib.sha256
).hexdigest()

if hmac.compare_digest(signature, expected):
    # Processar evento
    pass

Integração com MCP

O skill oferece duas ferramentas MCP:

1. extract_content: Extrai conteúdo de perfis, tweets ou tópicos
2. execute_action: Executa ações como postar, curtir ou seguir

Para usar no seu agente MCP:

{
  "mcpServers": {
    "xquik": {
      "command": "python",
      "args": ["-m", "xquik_mcp_server"],
      "env": {
        "XQUIK_API_KEY": "sua_api_key"
      }
    }
  }
}

Documentação Detalhada

Para a documentação completa, consulte os seguintes guias:

• Guia de início rápido
• Referência da API
• Exemplos de código
• Guia de webhooks
• SDK Python
• SDK Node.js

Suporte

Para dúvidas ou problemas, consulte as issues do repositório ou entre em contato pelo suporte oficial.