← Back to Skills Marketplace
1966
Downloads
0
Stars
37
Active Installs
1
Versions
Install in OpenClaw
/install x-research
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
Install only if you are comfortable giving the skill an X API bearer token and paying for API reads. Use a token scoped for this purpose, monitor X API spending, avoid storing sensitive unrelated secrets in the same global env file, clear cache/drafts when researching sensitive topics, and enable heartbeat watchlist checks only intentionally.
Capability Analysis
Type: OpenClaw Skill
Name: x-research
Version: 1.0.0
The OpenClaw AgentSkills bundle 'x-research' is designed for X/Twitter research, utilizing a local Bun CLI tool to fetch and format tweet data. The skill's instructions and core logic align with its stated purpose of searching, profiling, and monitoring X. However, the `lib/api.ts` file directly reads `~/.config/env/global.env` to retrieve the `X_BEARER_TOKEN`. While the explicit intent is to obtain its own required credential, this direct file system access to a user's global environment file represents a vulnerability, as it could potentially be abused if the file path were controllable or if the parsing logic were less specific, making the skill's behavior fall into the 'suspicious' category due to this risky capability without clear malicious intent.
Capability Assessment
Purpose & Capability
The artifacts consistently describe X/Twitter research: search, profile lookup, thread expansion, single tweet fetch, watchlist checks, and synthesis. The code uses read-style X API endpoints and does not show posting, liking, following, account management, unrelated data access, or hidden endpoints.
Instruction Scope
The agentic loop may run several searches, follow threads, and fetch linked pages; this fits the research purpose but can consume paid X API credits and should stay user-directed, especially for heartbeat watchlist checks.
Install Mechanism
README and SKILL.md disclose Bun, X_BEARER_TOKEN setup, and the optional ~/.config/env/global.env token location. Registry-style metadata appears under-declared, but the install and usage documents are explicit enough to avoid treating this as hidden behavior.
Credentials
The skill reads X_BEARER_TOKEN from the process environment or ~/.config/env/global.env and sends it as an Authorization header to api.x.com. This is proportionate for X API access, though a dedicated per-skill secret would be cleaner than reading a shared env file.
Persistence & Privilege
It persists local watchlist data, short-lived cache files, and optional markdown drafts under documented paths. No daemon installation, self-starting persistence, privilege escalation, destructive file operations beyond cache clearing, or broad local indexing is shown.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-research - After installation, invoke the skill by name or use
/x-research - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
x-research 1.0.0 — Initial release
- General-purpose agent for real-time research on X/Twitter, synthesizing perspectives, product feedback, news, and expert opinions.
- Provides CLI tool for searching tweets, profiles, threads, individual tweets, and managing a watchlist.
- Supports advanced filtering (by time, likes, engagement, replies, etc.), sorting, noise reduction, and output formats (JSON, markdown).
- Includes caching to reduce duplicate API calls and optimize cost.
- Features an agentic research loop: decompose questions, run targeted searches, follow threads, deep-dive linked content, and synthesize findings.
- Integrated watchlist and heartbeat system for monitoring key accounts.
Metadata
Frequently Asked Questions
What is X 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 1966 downloads so far.
How do I install X Research?
Run "/install x-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Research free?
Yes, X Research is completely free (open-source). You can download, install and use it at no cost.
Which platforms does X Research support?
X Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Research?
It is built and maintained by aviclaw (@aviclaw); the current version is v1.0.0.
More Skills