A dual-engine utility designed to extract tweets, threads, and search results from X using free and high-fidelity API fallbacks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xpull
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install xpull using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is xpull?
xpull is a robust data extraction utility tailored for developers and AI agents who need to ingest social media content from X (formerly Twitter) into their local environments. By incorporating xpull into your collection of Openclaw Skills, you gain the ability to scrape individual posts, reconstruct long threads, and perform deep searches without complex browser automation.
The skill provides a hybrid approach to data retrieval. It uses the free api.fxtwitter.com for basic fetching and the advanced Grok x_search API for premium features like reply extraction and author-specific searches. This makes it an essential bridge for feeding real-time social data into LLM contexts or research pipelines.
xpull Use Cases
- Archiving viral threads for long-term sentiment analysis or summarization.
- Monitoring specific industry experts by searching their latest posts programmatically.
- Retrieving full conversation context, including replies, to understand public discourse on a topic.
- Feeding high-quality X data into RAG (Retrieval-Augmented Generation) systems via Openclaw Skills.
How xpull Works
- The user initiates a request via a specific Node.js script targeting a URL or a search query.
- For standard single tweets or articles, the skill calls the FxTwitter API, which requires no credentials.
- For advanced queries like full thread reconstruction or search, the skill utilizes the Grok x_search tool via the xAI API.
- The system checks the local state file to ensure the daily request cap has not been exceeded.
- Structured data is returned to the terminal or calling agent for immediate processing.
xpull Setup
To get started with xpull as part of your Openclaw Skills setup, ensure you have Node.js installed and configure your environment variables:
# Set your xAI API Key for Grok-powered features
export XAI_API_KEY="your_xai_key_here"
# Optional: Customize the daily usage cap (defaults to 20)
export GROK_DAILY_CAP=50
# Run a test fetch using the free engine
node scripts/fx-fetch.mjs "https://x.com/example/status/123"
xpull Data Schema & Taxonomy
The skill manages its operation and output through the following data structures:
| Component | Format | Description |
|---|---|---|
.grok-state.json |
JSON | A local file that tracks daily API usage to prevent unexpected costs. |
| Fetch Output | JSON/Object | Standardized objects containing tweet text, author info, and media links. |
| Configuration | ENV | Managed via XAI_API_KEY and GROK_DAILY_CAP variables. |
xpull Advanced Features
- Upward thread walking: Automatically reconstructs a full thread starting from a single tweet URL.
- Grok-powered fallback: Seamlessly switch to premium search tools when free APIs are insufficient for the task.
- Usage Governance: Built-in daily caps protect your xAI API budget from accidental overruns during automation.
- Targeted Search: Filter search results by handle or specific query parameters directly through Openclaw Skills scripts.
SKILL.md
Loading
Related Openclaw Skills
MadStory: Professional Cinematic Storyboarding
MadStory is a professional-grade cinematic storyboard design tool optimized for the Seedance 2.0 multi-modal engine.
FusionAlpha A&Crypto Desk
A sophisticated cross-market analysis engine that delivers data-anchored reports and morning briefings for both A-shares and cryptocurrency markets.
Buffer API Integration
A powerful GraphQL-based integration for automating social media scheduling and channel management via the Buffer API.
Vibe Prompt Compiler Portable
A sophisticated prompt engineering engine that converts natural language implementation requests into structured, tool-agnostic coding briefs.
Remove Watermark
A local, privacy-focused image processing tool designed to strip light-colored text watermarks and overlays from white-background document scans.
AI Prompt Generator
A sophisticated prompt engineering toolkit designed to generate structured, high-context AI prompts for specialized development and business workflows.
Featured*
