← Back to Skills Marketplace
342
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install twitterapi-research-skill
Description
General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert...
Usage Guidance
Do not install blindly. The code requires a twitterapi.io API key (TWITTERAPI_IO_KEY) even though the registry metadata doesn't declare it—that mismatch is a red flag. Before installing: (1) verify the skill source (review the GitHub repo or author) and confirm you trust twitterapi.io; (2) avoid 'sourcing' a global env file that may contain many other secrets—prefer storing the TWITTERAPI_IO_KEY in a dedicated secret store or an agent-specific environment variable; (3) be aware agent session logs or tooling may record HTTP headers/commands (the README warns your API key could appear in logs), and rotate the key if you suspect exposure; (4) note this tool writes caches, a watchlist and saved drafts to your home directory—review those paths if privacy matters; (5) ensure Bun is acceptable in your environment. If the author can update the registry metadata to declare TWITTERAPI_IO_KEY (and any other required vars) and remove guidance to source a global env containing unrelated secrets, the inconsistency would be resolved and this would look far more benign.
Capability Analysis
Type: OpenClaw Skill
Name: twitterapi-research-skill
Version: 0.1.0
The OpenClaw AgentSkills skill bundle is benign. It functions as a Twitter research agent, making API calls to `twitterapi.io` as described. All file system operations (cache, watchlist, saving drafts) are confined to the skill's own `data/` directory or the designated `~/clawd/drafts/` output directory. The `SKILL.md` and `README.md` files are well-behaved, providing clear instructions without any prompt injection attempts or malicious directives. The `README.md` even includes a transparent warning about potential API key logging by the AI agent platform, demonstrating good security awareness from the developer rather than malicious intent.
Capability Assessment
Purpose & Capability
The code and SKILL.md clearly require a TWITTERAPI_IO_KEY and Bun to run, which is coherent with a twitterapi.io-based research tool — but the registry metadata lists no required environment variables or primary credential. That mismatch (manifest says 'none' while runtime code insists on an API key) is a material inconsistency.
Instruction Scope
SKILL.md and README instruct the user/agent to 'source ~/.config/env/global.env' and the code will read that file to extract TWITTERAPI_IO_KEY. Sourcing a global env file can expose many unrelated environment variables to the shell/agent session and agent logs. Apart from that, the instructions stick to search/profile/thread workflows and fetching linked web resources (web_fetch) which is expected for research, but the explicit guidance to source a global env file expands the skill's read scope beyond only the Twitter key.
Install Mechanism
No remote install/downloads or obscure URLs are used; this skill is provided as source files and is run with Bun per the README. There is no install spec that would fetch arbitrary code at runtime. The only external dependency is the third-party API (twitterapi.io) which is expected for this purpose.
Credentials
The runtime requires TWITTERAPI_IO_KEY (read from env or ~/.config/env/global.env) but the registry metadata does not declare this or any primary credential. The skill also accesses HOME paths (writes drafts to ~/clawd/drafts and a watchlist under the skill data directory). Requesting a single API key is proportionate to the stated purpose, but the manifest omission and instruction to source a global env file (potentially exposing other secrets) are disproportionate and risky.
Persistence & Privilege
The skill does local, expected file writes (cache, data/watchlist.json, and optional saved drafts) within its own skill directory and a drafts directory under the user's home. It does not request always:true, nor does it appear to modify other skills or system-wide configs. No elevated persistence is requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install twitterapi-research-skill - After installation, invoke the skill by name or use
/twitterapi-research-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the general-purpose X/Twitter research agent using twitterapi.io for full-archive, real-time searches.
- Supports targeted CLI commands for search, profile lookup, thread/conversation fetching, tweet details, and account watchlist management.
- Features robust search refinements: operator-based queries, sorting, time filtering, minimum likes/impressions, and engagement-based noise reduction.
- Enables saving, markdown/JSON output formats, and local result caching (15-minute TTL).
- Outlines best-practice research workflows: question decomposition, thread following, linked content investigation, synthesis, and saving.
- Includes heartbeat/watchlist functionality to monitor and flag notable tweets from key accounts.
Metadata
Frequently Asked Questions
What is TwitterApi Research?
General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert... It is an AI Agent Skill for Claude Code / OpenClaw, with 342 downloads so far.
How do I install TwitterApi Research?
Run "/install twitterapi-research-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is TwitterApi Research free?
Yes, TwitterApi Research is completely free (open-source). You can download, install and use it at no cost.
Which platforms does TwitterApi Research support?
TwitterApi Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created TwitterApi Research?
It is built and maintained by Blasco (@blascokoa); the current version is v0.1.0.
More Skills