← Back to Skills Marketplace
446
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install x-research-skill
Description
Research trending topics, tweets, user profiles, and conversations on X (Twitter) using twitterapi.io for insights and trend reports.
Usage Guidance
Before installing or running this skill:
- Expect it to need a twitterapi.io API key (TWITTERAPI_KEY). The skill's metadata does not declare that; confirm and only provide a key you trust for this use. Store the key in a secure file and ensure it is not world-readable.
- The SKILL.md and script will source ~/.openclaw/secrets/twitterapi.env — check that file to ensure it contains only the expected TWITTERAPI_KEY and nothing else.
- The bundled script assumes curl and jq are available; verify those binaries exist on the agent host. Consider adding checks in the script or to the metadata.
- The script's default OUTPUT_DIR is hard-coded to /home/artex/.openclaw/workspace/research. Change it to a portable path (use $HOME/.openclaw/... or pass an explicit output directory) to avoid writing into someone else's home or failing unexpectedly.
- Review the script for any other hidden endpoints or modifications; run it in a sandbox or with a throwaway API key first to confirm behavior and costs.
- Note rate/cost guidance in the SKILL.md and monitor API usage to avoid unexpected charges.
Resolve the metadata mismatches (declare required env var(s) and required binaries) or treat this skill as untrusted until fixed.
Capability Analysis
Type: OpenClaw Skill
Name: x-research-skill
Version: 1.0.0
The skill bundle provides a legitimate tool for researching Solana-related trends on X (Twitter) via the twitterapi.io service. The shell script (generate-report.sh) and markdown instructions (SKILL.md) focus on querying public data and generating reports in a local workspace, with no evidence of data exfiltration, malicious execution, or unauthorized access beyond the stated purpose.
Capability Assessment
Purpose & Capability
The SKILL.md and the included script legitimately call twitterapi.io endpoints for Twitter/X research, which matches the name/description. However, the skill metadata declares no required credentials or binaries while the instructions and script rely on an API key (TWITTERAPI_KEY) and common tools (curl, jq). Also the script uses a hard-coded absolute default output directory (/home/artex/.openclaw/...), which is inconsistent with a general-purpose research skill and suggests sloppy packaging.
Instruction Scope
Runtime instructions require sourcing ~/.openclaw/secrets/twitterapi.env (to obtain TWITTERAPI_KEY) and then only make requests to api.twitterapi.io — no unexpected external endpoints. That is appropriate for the stated purpose. The concerns: (1) instructions and script reference a specific secrets path and a hard-coded /home/artex output path (may cause writes to another user's directory or fail unexpectedly), and (2) the skill does not declare or validate the external tools it expects (curl, jq).
Install Mechanism
There is no install spec (instruction-only plus a shell script), which minimizes install-time risk. That said the shipped script expects curl, jq, mkdir, head, date and will write files to disk; the package does not declare these requirements. No downloads or archive extraction are present.
Credentials
The skill requires a TWITTERAPI_KEY (and instructs storing it at ~/.openclaw/secrets/twitterapi.env), but the registry metadata lists no required env vars or primary credential. This mismatch is a red flag: the skill will access a secret not declared to the platform. There are no other unrelated credential requests, so the sensitivity is limited to that single API key, but it should be declared explicitly.
Persistence & Privilege
The skill does not request permanent always:true, does not alter other skills or global agent settings, and only writes reports to disk. Autonomous invocation is allowed (platform default) but not combined with other high privileges, so no elevated persistence concerns are present.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-research-skill - After installation, invoke the skill by name or use
/x-research-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
**Major update: Migrated from custom agentic research CLI to simple API-driven workflow using twitterapi.io.**
- Replaced all custom CLI code and supporting library files with a single shell script, `generate-report.sh`.
- Removed detailed CLI documentation, operator heuristics, and multi-step research loop from the skill.
- Updated instructions to focus on using the twitterapi.io API via `curl`, with clear examples for searching, trends, user tweets, and compiling daily Solana research reports.
- Simplified authentication setup and redefined output/reporting structure in markdown.
- Provided new vertical-specific search examples and an updated key account monitoring list.
- Detailed API cost/rate guidance and clarified typical usage patterns.
Metadata
Frequently Asked Questions
What is X/Twitter Research?
Research trending topics, tweets, user profiles, and conversations on X (Twitter) using twitterapi.io for insights and trend reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 446 downloads so far.
How do I install X/Twitter Research?
Run "/install x-research-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X/Twitter Research free?
Yes, X/Twitter Research is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X/Twitter Research support?
X/Twitter Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X/Twitter Research?
It is built and maintained by 0xArtex (@0xartex); the current version is v1.0.0.
More Skills