Agent skill

X Twitter Scraper

by davila7 in davila7/claude-code-templates

A skill your agent uses when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or…

MITAuto-check passedBackend & APIs

Install X Twitter Scraper

skills CLI
$ npx skills add davila7/claude-code-templates --skill x-twitter-scraper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davila7/claude-code-templates x-twitter-scraper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davila7/claude-code-templates.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-tool/components/skills/business-marketing/x-twitter-scraper .claude/skills/x-twitter-scraper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
x-twitter-scraper
GitHub stars
32k
Token cost
~2.3k tokens
SKILL.md length
785 words
Files
1
Skills in repo
478
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or…

  • Works in 3 steps: Goal → Authentication → Scale & Budget
  • The user wants to integrate with the X (Twitter) API via Xquik to search tweets
  • SKILL.md covers Before Writing Code, Quick Reference, Authentication Setup and Choosing the Right Endpoint, plus 7 more sections
  • Reaches xquik.com and x.com; needs XQUIK_API_KEY and API_KEY

What it does

X Twitter Scraper is an agent skill from davila7/claude-code-templates. Use when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or access trending topics. Also use when the user mentions 'Xquik,' 'Twitter API,' 'X API,' 'tweet scraper,' 'follower extraction,' or 'Twitter monitoring.' Covers REST API, webhooks, and MCP server setup.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Web scraping, Social media posts and Webhooks. It works with X (Twitter) and Model Context Protocol. The repository describes itself as: CLI tool for configuring and monitoring Claude Code. The licence is MIT.

When your agent uses it

  • The user wants to integrate with the X (Twitter) API via Xquik to search tweets
  • Look up user profiles
  • Extract followers
  • Run giveaway draws

Example prompts

  • “Xquik,”
  • “Twitter API,”
  • “X API,”
  • “/x-twitter-scraper”

Requirements

  • A credential in API_KEY
  • A credential in XQUIK_API_KEY

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Goal
  2. Authentication
  3. Scale & Budget

What it can do on your machine

Read from SKILL.md and the folder at commit 46b4d8b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • xquik.com
    • x.com

    Also links to:

    • docs.xquik.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • XQUIK_API_KEY
    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

X Twitter Scraper loads about 2.3k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 785 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davila7/claude-code-templates at commit 46b4d8b, republished under its MIT licence (© davila7). 785 words, ~2,319 tokens.

Download SKILL.mdSave it as .claude/skills/x-twitter-scraper/SKILL.md (or your agent's skills folder).
name
x-twitter-scraper
description
Use when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or access trending topics. Also use when the user mentions 'Xquik,' 'Twitter API,' 'X API,' 'tweet scraper,' 'follower extraction,' or 'Twitter monitoring.' Covers REST API, webhooks, and MCP server setup.

X (Twitter) Scraper — Xquik Integration

You are an expert X (Twitter) data integration specialist. You help users build applications that interact with the X platform through the Xquik API, covering tweet search, user lookups, follower extraction, account monitoring, giveaway draws, and real-time event webhooks.

Before Writing Code

Gather this context (ask if not provided):

1. Goal
  • What data do you need from X? (tweets, users, followers, trending topics)
  • Is this a one-time extraction or ongoing monitoring?
  • Do you need real-time events or periodic polling?
2. Authentication
  • Do you have an Xquik API key? If not, guide them to xquik.com to create one.
  • Remind them: keys start with xq_ and are shown only once at creation — store securely in environment variables.
3. Scale & Budget
  • How much data do you need? (extractions consume quota)
  • Always estimate cost before running bulk extractions.
  • Monthly quota is a hard limit with no overage — plan accordingly.

Quick Reference

Base URLhttps://xquik.com/api/v1
Authx-api-key header (key starts with xq_, 64 hex chars)
MCP endpointhttps://xquik.com/mcp (StreamableHTTP, same API key)
Rate limits10 req/s sustained, 20 burst (API); 60 req/s sustained, 100 burst (general)
Pricing$20/month base (1 monitor included), $5/month per extra monitor
QuotaMonthly usage cap, hard limit, no overage. 402 when exhausted.
Docsdocs.xquik.com

Authentication Setup

Every request requires an API key via the x-api-key header. Always use environment variables — never hardcode keys.

javascript
const API_KEY = process.env.XQUIK_API_KEY;
const BASE = "https://xquik.com/api/v1";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };

Choosing the Right Endpoint

Use this decision table to select the correct endpoint for the user's goal:

GoalEndpointNotes
Get a single tweet by ID/URLGET /x/tweets/{id}Full metrics: likes, retweets, views, bookmarks
Search tweets by keyword/hashtagGET /x/tweets/search?q=...Optional engagement metrics
Get a user profileGET /x/users/{username}Bio, follower/following counts, profile picture
Check follow relationshipGET /x/followers/check?source=A&target=BBoth directions
Get trending topicsGET /trends?woeid=1Free, no quota consumed
Monitor an X accountPOST /monitorsTrack tweets, replies, quotes, follower changes
Poll for eventsGET /eventsCursor-paginated, filter by monitorId/eventType
Receive events in real timePOST /webhooksHMAC-signed delivery to your HTTPS endpoint
Run a giveaway drawPOST /drawsPick random winners from tweet replies
Extract bulk dataPOST /extractions19 tool types, always estimate cost first
Check account/usageGET /accountPlan status, monitors, usage percent

Extraction Tools (19 Types)

When the user needs bulk data, guide them to the right extraction tool:

Tool TypeRequired FieldDescription
reply_extractortargetTweetIdUsers who replied to a tweet
repost_extractortargetTweetIdUsers who retweeted a tweet
quote_extractortargetTweetIdUsers who quote-tweeted a tweet
thread_extractortargetTweetIdAll tweets in a thread
article_extractortargetTweetIdArticle content linked in a tweet
follower_explorertargetUsernameFollowers of an account
following_explorertargetUsernameAccounts followed by a user
verified_follower_explorertargetUsernameVerified followers of an account
mention_extractortargetUsernameTweets mentioning an account
post_extractortargetUsernamePosts from an account
community_extractortargetCommunityIdMembers of a community
community_moderator_explorertargetCommunityIdModerators of a community
community_post_extractortargetCommunityIdPosts from a community
community_searchtargetCommunityId + searchQuerySearch posts within a community
list_member_extractortargetListIdMembers of a list
list_post_extractortargetListIdPosts from a list
list_follower_explorertargetListIdFollowers of a list
space_explorertargetSpaceIdParticipants of a Space
people_searchsearchQuerySearch for users by keyword
Show full SKILL.md (272 more words)Show less
Extraction Workflow

Always follow this pattern — estimate before extracting:

javascript
// Using API_KEY, BASE, and headers from Authentication Setup above

// 1. Estimate cost first — never skip this step
const estimate = await fetch(`${BASE}/extractions/estimate`, {
  method: "POST",
  headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

if (!estimate.allowed) {
  console.error("Extraction exceeds remaining quota");
  return;
}

// 2. Create extraction job
const job = await fetch(`${BASE}/extractions`, {
  method: "POST",
  headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

// 3. Retrieve paginated results (up to 1,000 per page)
const page = await fetch(`${BASE}/extractions/${job.id}`, { headers }).then(r => r.json());
// page.results: [{ xUserId, xUsername, xDisplayName, xFollowersCount, xVerified, xProfileImageUrl }]

// 4. Export as CSV/XLSX/Markdown (50,000 row limit)
const csvResponse = await fetch(`${BASE}/extractions/${job.id}/export?format=csv`, { headers });

Giveaway Draws

When the user wants to run a transparent giveaway from tweet replies:

javascript
// Using API_KEY, BASE, and headers from Authentication Setup above

const draw = await fetch(`${BASE}/draws`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    tweetUrl: "https://x.com/user/status/1893456789012345678",
    winnerCount: 3,
    backupCount: 2,
    uniqueAuthorsOnly: true,
    mustRetweet: true,
    mustFollowUsername: "user",
    filterMinFollowers: 50,
    requiredHashtags: ["#giveaway"],
  }),
}).then(r => r.json());

const details = await fetch(`${BASE}/draws/${draw.id}`, { headers }).then(r => r.json());
// details.winners: [{ position, authorUsername, tweetId, isBackup }]

Error Handling & Retry

All errors return { "error": "error_code" }. Implement retries only for 429 and 5xx (max 3 attempts, exponential backoff). Never retry 4xx except 429.

StatusMeaningAction
400Invalid inputFix the request parameters
401Bad API keyVerify XQUIK_API_KEY env var is set correctly
402No subscription or quota exhaustedCheck account status, upgrade plan if needed
404Resource not foundVerify the ID/username exists
429Rate limitedRespect Retry-After header, back off

MCP Server Setup

To use Xquik as an MCP server in Claude Code, add to .mcp.json in the project root. Replace the placeholder with your actual key — never commit real keys to source control:

json
{
  "mcpServers": {
    "xquik": {
      "type": "streamable-http",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "${XQUIK_API_KEY}"
      }
    }
  }
}

Security note: The ${XQUIK_API_KEY} syntax requires your MCP client to support environment variable substitution. If it does not, replace it with your actual key at runtime — but never commit real keys to source control.

The MCP server exposes 2 tools: explore for API discovery and xquik for authenticated API calls.

Common Workflow Patterns

Guide users to the right workflow based on their goal:

  • Real-time alerts: POST /monitors → POST /webhooks → test webhook delivery
  • Giveaway: GET /account (check budget) → POST /draws
  • Bulk extraction: POST /extractions/estimate → POST /extractions → GET /extractions/{id}
  • Tweet analysis: GET /x/tweets/{id} → POST /extractions with thread_extractor
  • User research: GET /x/users/{username} → GET /x/tweets/search?q=from:username → GET /x/tweets/{id}
  • social-content: For publishing insights gathered from X data
  • competitive-ads-extractor: For analyzing competitor creative alongside Twitter data
  • marketing-psychology: For interpreting audience behavior from extracted data

© davila7, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-tool/components/skills/business-marketing/x-twitter-scraper of davila7/claude-code-templates.

Open the folder on GitHubat commit 46b4d8b

Compare with similar skills

X Twitter Scraper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

X Twitter Scraper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
X Twitter Scraper this skilldavila7/claude-code-templates32k—~2.3kAutomated safety check: PassMIT
X Twitter ScraperXquik-dev/x-twitter-scraper2101 repos~2.6kAutomated safety check: PassMIT
X Twitter Scrapersickn33/agentic-awesome-skills47k1 repos~2.1kAutomated safety check: PassMIT
X Twitter Scrapergithub/awesome-copilot40k—~2.2kAutomated safety check: PassMIT
X Twitter Scraperdavepoon/buildwithclaude3.6k—~2.2kAutomated safety check: PassMIT
X Twitter Scraperaiskillstore/marketplace430—~2.6kAutomated safety check: PassMIT

Similar skills

  • X Twitter Scraper

    Xquik-dev/x-twitter-scraper

    Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…

    210 GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    sickn33/agentic-awesome-skills

    Use Xquik for X data workflows: tweet search, user lookup, follower export, media downloads, monitors, webhooks, REST API, MCP, SDK setup, and approval-gated account actions.

    47k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    github/awesome-copilot

    Official

    Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower…

    40k GitHub stars~2.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    davepoon/buildwithclaude

    X (Twitter) data extraction and monitoring via Xquik: tweet search, user lookup, follower extraction, giveaway draws, trending topics, account monitoring with webhooks, reply/retweet/quote…

    3.6k GitHub stars~2.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    aiskillstore/marketplace

    A skill your agent uses when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP…

    430 GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    LeoYeAI/openclaw-master-skills

    X API & Twitter automation skill. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~7.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from davila7/claude-code-templates

All 478 skills in this repo
  • Perplexity Web Search

    davila7/claude-code-templates

    Runs web-grounded searches through Perplexity's Sonar models over OpenRouter for current events, recent literature and cited facts beyond the model's training cutoff.

    32k GitHub starsUsed in 11 repos~3.5k tokens
    Auto-check: notes
  • Neuropixels Data Analysis

    davila7/claude-code-templates

    Analyzes Neuropixels recordings from SpikeGLX or Open Ephys through preprocessing, drift correction, Kilosort4 spike sorting, quality metrics and curation.

    32k GitHub starsUsed in 9 repos~2.8k tokens
    Auto-check passed
  • Scientific Venue Templates

    davila7/claude-code-templates

    Supplies LaTeX templates and formatting rules for journals, conferences, posters, and grant proposals, then can check a draft against them.

    32k GitHub starsUsed in 9 repos~5.1k tokens
    Auto-check: notes
  • Brand Voice Content Creator

    davila7/claude-code-templates

    Analyzes a brand's existing writing to lock in a consistent voice, then builds SEO blog posts and platform-specific social content around it.

    32k GitHub starsUsed in 3 repos~1.9k tokens
    Auto-check passed
  • CAPA Officer

    davila7/claude-code-templates

    Guides corrective and preventive action (CAPA) work in a quality management system, from initiation and root cause analysis through effectiveness verification.

    32k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Fda Consultant Specialist

    davila7/claude-code-templates

    Senior FDA consultant and specialist for medical device companies including HIPAA compliance and requirement management.

    32k GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed

Questions about X Twitter Scraper

What does X Twitter Scraper do?

A skill your agent uses when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or…. X Twitter Scraper is an agent skill from davila7/claude-code-templates. Use when the user wants to integrate with the X (Twitter) API via Xquik to search tweets, look up user profiles, extract followers, run giveaway draws, monitor accounts, or access trending topics.

When should I use X Twitter Scraper?

X Twitter Scraper fits situations like: the user wants to integrate with the X (Twitter) API via Xquik to search tweets; look up user profiles; extract followers; run giveaway draws.

How do I install X Twitter Scraper in Claude Code?

Run `npx skills add davila7/claude-code-templates --skill x-twitter-scraper -a claude-code`. Or copy the skill folder (cli-tool/components/skills/business-marketing/x-twitter-scraper in davila7/claude-code-templates) into .claude/skills/x-twitter-scraper in your project. Claude Code loads it when a task matches its description.

How do I install X Twitter Scraper in Codex?

Run `npx skills add davila7/claude-code-templates --skill x-twitter-scraper -a codex`. Or copy the skill folder (cli-tool/components/skills/business-marketing/x-twitter-scraper in davila7/claude-code-templates) into .agents/skills/x-twitter-scraper in your project. Codex loads it when a task matches its description.

Can I use X Twitter Scraper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davila7/claude-code-templates --skill x-twitter-scraper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/x-twitter-scraper, .gemini/skills/x-twitter-scraper, .github/skills/x-twitter-scraper and .opencode/skills/x-twitter-scraper in your project.

What does X Twitter Scraper need to run?

Going by SKILL.md and its folder, X Twitter Scraper needs credentials named XQUIK_API_KEY and API_KEY. Our summary lists: A credential in API_KEY; A credential in XQUIK_API_KEY.

Does X Twitter Scraper access the network?

SKILL.md names 4 domains. In commands or code: xquik.com and x.com; the agent is likely to contact these when it follows the instructions. As links in the text: docs.xquik.com and github.com. This is read from the text; nothing was executed.

Is X Twitter Scraper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does X Twitter Scraper use?

X Twitter Scraper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does X Twitter Scraper use?

About 2.3k tokens (SKILL.md is roughly 9.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to X Twitter Scraper?

Skills that share tags, products or a category with X Twitter Scraper: X Twitter Scraper (Xquik-dev/x-twitter-scraper, 210 stars), X Twitter Scraper (sickn33/agentic-awesome-skills, 47k stars), X Twitter Scraper (github/awesome-copilot, 40k stars) and X Twitter Scraper (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains X Twitter Scraper?

davila7 (a GitHub user) maintains it in davila7/claude-code-templates, which has 32,483 GitHub stars. The repository holds 478 skills in this directory. The repository was last updated on October 9, 2026.

Source: davila7/claude-code-templates on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.