What problem does it solve?
Collecting tweets from X (Twitter) requires handling different URL types — search results, user profiles, single tweets, and lists — each backed by a different internal GraphQL endpoint. This Skill unifies them under one entry point: paste any X URL and get back structured per-tweet data with engagement metrics, media, hashtags, and pagination cursors, without writing API integration code.
Core Features & Use Cases
- Automatic URL classification: Detects whether a URL is a search, profile (tweets/replies/media), tweet detail, or list timeline, and maps it to the correct GraphQL endpoint.
- Normalized tweet output: Returns text, author details, retweet/reply/like/quote/bookmark/view counts, media, hashtags, mentions, and conversation IDs in a consistent JSON schema.
- Scroll-based pagination: Captures successive pages via browser scrolling with cursor tracking, deduplication by tweet ID, and clear termination conditions.
- Use Case: A social listening analyst pastes a mixed batch of X links — a brand search URL, three KOL profiles, and a curated list — and collects all matching tweets into one dataset for sentiment and engagement analysis.
Quick Start
Use the x-tweet-by-url skill to scrape all tweets from this X search URL and return the results as structured JSON.