Claude-code-plugins-plus-skills tweetclaw

install

source · Clone the upstream repo

git clone https://github.com/jeremylongshore/claude-code-plugins-plus-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jeremylongshore/claude-code-plugins-plus-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/automation/tweetclaw/skills/tweetclaw" ~/.claude/skills/jeremylongshore-claude-code-plugins-plus-skills-tweetclaw && rm -rf "$T"

manifest: plugins/automation/tweetclaw/skills/tweetclaw/SKILL.md

TweetClaw

Overview

TweetClaw provides full X/Twitter automation via the Xquik REST API. It covers 121 endpoints across 12 categories: tweet operations, user lookups, search, bulk extractions (23 tools), giveaway draws, account monitoring, webhook delivery, AI composition, style analysis, drafts, write actions, and account management.

Two MCP tools are available via the hosted server at

xquik.com/mcp

(not bundled with this plugin). See the MCP setup section in Resources for configuration instructions.

Prerequisites

An API key from xquik.com (starts with
```
xq_
```
)

Set

XQUIK_API_KEY

environment variable or configure via OpenClaw:

openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"

Instructions

Reading Data

Search tweets, fetch user profiles, get timelines, bookmarks, notifications, DM history, and trending topics.

# Search tweets
curl -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/x/tweets/search?query=AI+agents&count=20"

# Get user profile
curl -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/x/users/elonmusk"

# Get tweet by ID
curl -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/x/tweets/1234567890"

Writing Data

Post tweets, delete tweets, like/unlike, retweet, follow/unfollow, send DMs, update profile, upload media.

# Post a tweet
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from TweetClaw!"}' \
  "https://xquik.com/api/v1/x/tweets"

# Like a tweet
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/x/tweets/1234567890/like"

# Follow a user (requires numeric user ID)
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/x/users/44196397/follow"

Bulk Extractions

23 extraction tools for replies, quotes, retweets, followers, following, mentions, community members, list members, space participants, and more. Always estimate before extracting.

# Estimate extraction cost
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "reply_extractor", "params": {"tweetId": "1234567890"}}' \
  "https://xquik.com/api/v1/extractions/estimate"

# Create extraction
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "reply_extractor", "params": {"tweetId": "1234567890"}}' \
  "https://xquik.com/api/v1/extractions"

# Retrieve results (poll status first)
curl -H "x-api-key: $XQUIK_API_KEY" \
  "https://xquik.com/api/v1/extractions/{id}/results"

Giveaway Draws

Run auditable draws from tweet replies with filters (retweet required, follow check, min followers, account age, language, keywords).

curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tweetUrl": "https://x.com/handle/status/1234567890",
    "winnerCount": 3,
    "filters": {"mustRetweet": true, "mustFollow": "handle", "minFollowers": 10}
  }' \
  "https://xquik.com/api/v1/draws"

Account Monitoring

Monitor X accounts for new tweets, follows, unfollows. Deliver events via webhook or Telegram.

# Create monitor
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "openai"}' \
  "https://xquik.com/api/v1/monitors"

# Create webhook
curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/webhook", "events": ["tweet.new"]}' \
  "https://xquik.com/api/v1/webhooks"

AI Composition

Compose algorithm-optimized tweets with scoring, refinement, and style analysis.

curl -X POST -H "x-api-key: $XQUIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"step": "compose", "topic": "AI productivity", "tone": "professional"}' \
  "https://xquik.com/api/v1/compose"

Output

All endpoints return JSON. Successful responses include the requested data. Errors return

{"error": "error_code"}

Status	Meaning	Action
200	Success	Process response
400	Invalid request	Fix parameters
401	Unauthenticated	Check API key
402	Billing issue	Subscribe or add credits
404	Not found	Resource does not exist
429	Rate limited	Retry with backoff
5xx	Server error	Retry with backoff

Error Handling

Retry only 429 and 5xx (max 3 retries, exponential backoff). Never retry other 4xx.
Rate limits are per method tier: Read (120/60s), Write (30/60s), Delete (15/60s).
Follow/DM endpoints require numeric user IDs, not usernames. Look up the user first via
```
GET /x/users/{username}
```
.
Extraction IDs are strings (bigints that overflow JavaScript Number). Always treat as strings.
Webhook secrets are shown only once at creation. Store immediately.
Cursors are opaque. Never decode or construct
```
nextCursor
```
values.
Always estimate before extracting to avoid 402 errors mid-extraction.

Examples

Full workflow: search, analyze, and compose

Search tweets:

GET /x/tweets/search?query=AI+agents&count=50

Analyze engagement: Check likes, retweets, reply counts in results
Compose optimized tweet:
```
POST /compose
```
with topic and tone
Score the draft:
```
POST /compose
```
with
```
step: "score"
```
Post the tweet:
```
POST /x/tweets
```
with the final text

Full workflow: giveaway draw

Create draw:
```
POST /draws
```
with tweet URL and filters
Poll status:
```
GET /draws/{id}
```
until
```
status: "completed"
```
Export results:
```
GET /draws/{id}/export?format=csv
```