From 31087300802434702deabb6d14aa1b20b5e7ab27 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Burak=20Bay=C4=B1r?= <burakbayir1@gmail.com>
Date: Tue, 10 Mar 2026 17:41:15 +0300
Subject: [PATCH] feat: add x-twitter-scraper

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md                  |  1 +
 x-twitter-scraper/SKILL.md | 49 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+)
 create mode 100644 x-twitter-scraper/SKILL.md

diff --git a/README.md b/README.md
index 5e0e644b..4275fdef 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ Bankr Skills equip builders with plug-and-play tools to build more powerful agen
 | yoink | [yoink](yoink/) | Social on-chain game. "Yoink" a token from the current holder. Uses Bankr for transaction execution. |
 | [Neynar](https://neynar.com) | [neynar](neynar/) | Full Farcaster API integration. Post casts, like, recast, follow users, search content, and manage Farcaster identities. |
 | [Hydrex](https://hydrex.fi) | [hydrex](hydrex/) | Liquidity pools on Base. Lock HYDX for voting power, vote on pool strategies, deposit single-sided liquidity into auto-managed vaults, and claim oHYDX rewards. |
+| [Xquik](https://github.com/Xquik-dev/x-twitter-scraper) | [x-twitter-scraper](x-twitter-scraper/) | X API & Twitter scraper skill for AI coding agents. 40+ tools: tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, trending topics, write actions, Telegram integrations. REST API, MCP server & webhooks. |
 
 ## Adding a Skill
 
diff --git a/x-twitter-scraper/SKILL.md b/x-twitter-scraper/SKILL.md
new file mode 100644
index 00000000..e6ce7678
--- /dev/null
+++ b/x-twitter-scraper/SKILL.md
@@ -0,0 +1,49 @@
+---
+name: x-twitter-scraper
+description: X API & Twitter scraper skill for AI coding agents. 40+ tools for tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, trending topics, write actions, and Telegram integrations. REST API, MCP server & webhooks.
+metadata: {"clawdbot":{"emoji":"𝕏","homepage":"https://github.com/Xquik-dev/x-twitter-scraper"}}
+---
+
+# x-twitter-scraper
+
+X API & Twitter scraper skill for AI coding agents. 40+ tools covering read, write, and analysis operations on X (formerly Twitter).
+
+## Quick Start
+
+```
+> install the x-twitter-scraper skill from https://github.com/BankrBot/skills/tree/main/x-twitter-scraper
+```
+
+Full documentation and setup instructions: [github.com/Xquik-dev/x-twitter-scraper](https://github.com/Xquik-dev/x-twitter-scraper)
+
+## Tools
+
+### Read Operations
+- **Tweet search** — Search tweets by keyword, hashtag, or advanced query
+- **User lookup** — Get profile details by username or user ID
+- **Follower extraction** — List followers and following for any account
+- **Engagement metrics** — Likes, retweets, quotes, replies, and bookmarks
+- **Trending topics** — Current trending topics by region
+- **List members** — Extract members from X lists
+
+### Write Operations
+- **Post tweets** — Create tweets with text and media
+- **Reply, retweet, like** — Engage with existing tweets
+- **Follow/unfollow** — Manage account relationships
+- **Create lists** — Build and manage X lists
+
+### Analysis & Automation
+- **Giveaway draws** — Run verifiable giveaway draws with configurable filters
+- **Community explorer** — Analyze community membership and engagement
+- **Style analyzer** — Analyze tweet writing style and patterns
+- **Account monitoring** — Track account changes over time
+
+### Integrations
+- **REST API** — Full REST API (v1) with API key authentication
+- **MCP server** — Model Context Protocol server for AI agent integration
+- **Webhooks** — HMAC-signed webhook delivery for real-time events
+- **Telegram bot** — Telegram bot for notifications and control
+
+## Compatibility
+
+Works with Claude Code, Cursor, Codex, Copilot, Windsurf, and 40+ AI coding agents.