← Back to Skills Marketplace
Twitter/X Reader
by
Parth Bhateja
· GitHub ↗
· v1.0.0
802
Downloads
0
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install twitter-reader
Description
Extract complete data from X/Twitter tweets by URL, including text, author info, timestamps, engagement stats, media, quoted tweets, and thread context.
Usage Guidance
This skill appears to do what it says: it fetches tweet data via api.fxtwitter.com and falls back to public Nitter instances. Before installing: (1) review the scripts yourself (they're shell scripts and human-readable); (2) be aware that fetching tweets will expose your IP address and User-Agent to the remote host(s) — FxTwitter and any chosen Nitter instance will see those request headers; (3) the Nitter fallback queries multiple community instances (some may be unreliable or untrusted), so if privacy is a concern restrict or remove fallback instances or run the skill only when necessary; (4) verify network access and that curl/jq are up-to-date; (5) test the skill in an isolated environment if you want to avoid contacting third‑party hosts until you've reviewed the code. Overall the skill is internally consistent and does not ask for excessive permissions or secrets.
Capability Analysis
Type: OpenClaw Skill
Name: twitter-reader
Version: 1.0.0
The skill is designed to read tweets from X/Twitter using the FxTwitter API and Nitter as a fallback. While the overall intent appears benign and there are no direct prompt injection attempts in SKILL.md, the `scripts/read_tweet.sh` and `scripts/read_thread.sh` files contain a potential shell injection vulnerability. The `$user` variable, extracted from user-provided URLs using a broad regex `([^/]+)`, is directly inserted into `curl` commands without explicit sanitization. Although `curl` is generally robust, a crafted username could theoretically introduce shell metacharacters, posing a low-probability risk for command execution. Additionally, `scripts/read_tweet_nitter.sh` uses fragile `grep`/`sed` parsing for HTML, which is a reliability vulnerability, though not directly malicious.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and included scripts all consistently implement tweet extraction using the FxTwitter API as primary source and Nitter instances as fallback. No unrelated binaries, credentials, or config paths are requested.
Instruction Scope
Runtime instructions and scripts operate only on the provided tweet URLs and call the documented external hosts (api.fxtwitter.com and listed Nitter instances). Two points to note: (1) the SKILL.md claims 'No external data collection' and 'No telemetry' — while telemetry is absent, any network request reveals requester metadata (IP address, User-Agent) to the remote hosts; (2) the Nitter fallback contacts a list of third‑party instances (community hosts of varying trustworthiness), which may log requests. These are expected for a web‑fetching tool but important privacy considerations.
Install Mechanism
No download/install spec; skill is instruction + shell scripts. Nothing is fetched or executed at install time beyond copying files and making scripts executable. This is low risk compared with remote archive installs.
Credentials
The skill requests no environment variables or credentials and only depends on common system tools (curl, jq, bash). Scripts do not read other env vars or access unrelated configuration files.
Persistence & Privilege
Skill does not request always:true or other elevated persistence. Installation is manual (copy scripts into skills folder). It does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install twitter-reader - After installation, invoke the skill by name or use
/twitter-reader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: FxTwitter API, thread following, Nitter fallback, full media extraction
Metadata
Frequently Asked Questions
What is Twitter/X Reader?
Extract complete data from X/Twitter tweets by URL, including text, author info, timestamps, engagement stats, media, quoted tweets, and thread context. It is an AI Agent Skill for Claude Code / OpenClaw, with 802 downloads so far.
How do I install Twitter/X Reader?
Run "/install twitter-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Twitter/X Reader free?
Yes, Twitter/X Reader is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Twitter/X Reader support?
Twitter/X Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Twitter/X Reader?
It is built and maintained by Parth Bhateja (@iheardulkbtc); the current version is v1.0.0.
More Skills