mcpField
X
x-twitter-scraper

x-twitter-scraper

github.com/hoodiniData & databases29151 installsUpdated 1d ago
Repository

About x-twitter-scraper

x-twitter-scraper is an AI agent skill for collecting and monitoring X (Twitter) data. It supports search, account and interaction extraction, media downloads, and trend lookup, and is available in SKILL.md format for several coding agents.

Key features

  1. 01Tweet search with query and date filters
  2. 02User profile lookup
  3. 03Follower and following extraction
  4. 04Reply, retweet, and quote extraction
  5. 05Tweet image and video downloads
  6. 06Account monitoring and local trends

Use cases

  1. 01OSINT research on public accounts and engagement
  2. 02Collecting giveaway entries from tweet interactions
  3. 03Monitoring competitors and follower changes

MCP support

It includes an MCP server on port 3100 with API key authentication and 20 tools for MCP clients.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hoodini/ai-agents-skills --skill x-twitter-scraper

After installing, type/x-twitter-scraperin Claude Code to confirm it loaded.

Details

From the project README

X/Twitter Scraper

AI agent skill for X (Twitter) data extraction — tweet search, user lookup, follower/following lists, media download, reply/retweet/quote extraction, account monitoring, and trending topics.

Quick Start

Install as a Claude Code skill:

# Copy to your project
mkdir -p .claude/skills
cp -r skills/x-twitter-scraper .claude/skills/

# Or for GitHub Copilot
mkdir -p .github/skills
cp -r skills/x-twitter-scraper .github/skills/

Visit x-twitter-scraper on GitHub for full setup instructions.

Core Capabilities

Tweet Search
Search tweets by keyword, hashtag, or advanced query with date filters and result limits.
User Lookup
Get user profile data: bio, follower/following counts, verification status, account age.
Follower & Following Extraction
Bulk extract follower and following lists for any public account.
Reply, Retweet & Quote Extraction
Extract all replies, retweets, or quote tweets from a specific tweet.
Media Download
Download images and videos from tweets.
Account Monitoring
Set up real-time monitoring for account activity changes.
Trending Topics
Get trending topics by location.

Common Use Cases

OSINT Research
Look up a Twitter user, extract their followers, and analyze engagement patterns.
Giveaway Management
Search for giveaway tweets, extract participants (replies, retweets, quotes), and run draws.
Competitive Analysis
Monitor competitor accounts, track follower growth, and extract engagement data.

Integration

  • MCP Server: Port 3100, API key auth, 20 tools
  • REST API: /api/v1/* endpoints with HMAC webhooks
  • Agent Skill: SKILL.md format for Claude Code, Copilot, Cursor, Windsurf

Resources

Comments

Markdown supported