← Back to Skills Marketplace
311
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install xpull
Description
Pull tweets, threads, articles, and replies from X/Twitter. FxTwitter API primary (free), Grok x_search fallback (paid).
Usage Guidance
This skill appears to do what it says: fx-fetch uses the public FxTwitter proxy (no credentials) and grok-x-search uses your xAI API key and writes a local .grok-state.json to enforce a daily cap. Before installing: (1) consider whether you trust api.fxtwitter.com and the x.ai service; (2) keep XAI_API_KEY private (do not commit a .env with the key into version control); (3) expect Grok calls to incur cost — the README mentions pricing; (4) the script will create .grok-state.json in the project root to track usage; if you want more containment, run it in a sandbox or inspect/run the scripts locally first. The repository URL is declared in metadata — review that upstream source if you need higher assurance.
Capability Analysis
Type: OpenClaw Skill
Name: xpull
Version: 1.0.1
The xpull skill bundle provides legitimate utilities for fetching Twitter/X content using the FxTwitter public API and the xAI Grok API. The scripts (fx-fetch.mjs and grok-x-search.mjs) use standard Node.js HTTPS modules to communicate with official or well-known endpoints (api.fxtwitter.com and api.x.ai) and include a local state management system (.grok-state.json) to enforce daily usage caps. There is no evidence of data exfiltration, unauthorized execution, or prompt injection attempts.
Capability Assessment
Purpose & Capability
Name/description match the included scripts. fx-fetch.mjs contacts api.fxtwitter.com and requires only node; grok-x-search.mjs contacts api.x.ai and requires XAI_API_KEY. Optional GROK_DAILY_CAP is present and used. No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md instructs running the two included node scripts and documents which calls require the API key. The scripts only read a local .env (optional), write a .grok-state.json next to the repository to enforce a daily cap, and make HTTPS calls to api.fxtwitter.com and api.x.ai. They do not execute shell commands, read other system files, or contact unexpected endpoints.
Install Mechanism
No install spec is provided (instruction-only); requiring node is appropriate for the provided .mjs scripts. Nothing is downloaded from arbitrary URLs or written to unusual system locations by an installer.
Credentials
Only XAI_API_KEY (primary) is required for Grok features; GROK_DAILY_CAP is optional. The requested environment variables align with the documented Grok usage and no unrelated secrets are requested.
Persistence & Privilege
always:false (normal). The script writes a single .grok-state.json in the repository root to track daily usage — limited, local persistence. The skill does not modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install xpull - After installation, invoke the skill by name or use
/xpull - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: remove home directory .env scanning — XAI_API_KEY now sourced from env var or cwd .env only. Fix: declare XAI_API_KEY and GROK_DAILY_CAP in skill metadata. Add repository URL.
v0.3.1
xpull 0.3.1
- Clarified routing between FxTwitter API (free) and Grok x_search (paid) with explicit fallback guidance.
- Added detailed script usage instructions for tweets, threads, replies, and search.
- Specified output structure for fx-fetch, listing key returned tweet fields.
- Outlined Grok x_search usage, including model info, cost, and daily cap settings.
- Emphasized security rule: never log or display the xAI API key.
Metadata
Frequently Asked Questions
What is xpull?
Pull tweets, threads, articles, and replies from X/Twitter. FxTwitter API primary (free), Grok x_search fallback (paid). It is an AI Agent Skill for Claude Code / OpenClaw, with 311 downloads so far.
How do I install xpull?
Run "/install xpull" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is xpull free?
Yes, xpull is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does xpull support?
xpull is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created xpull?
It is built and maintained by Neo (@sanjeevneo); the current version is v1.0.1.
More Skills