← Back to Skills Marketplace
X-search-skill
by
Pratikbhosale7
· GitHub ↗
· v1.0.0
· MIT-0
93
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install x-search-skill
Description
Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social med...
Usage Guidance
This skill appears to do what it says: it uses your XAI_API_KEY to query the xAI Responses API and returns summarized results with citations. Before installing, consider: (1) only provide an XAI API key you trust the skill to use — avoid sharing high-privilege keys you don't want used for queries; (2) the install step uses Homebrew to install Python (works on systems with Homebrew); (3) the SKILL.md suggests storing the key in ~/.openclaw/openclaw.json — verify any config file you modify; (4) check the publisher/owner (there's a small ownerId mismatch in _meta.json) and only install if you trust the source. If you need higher assurance, run the included scripts locally (they're readable) and inspect network requests to confirm they only go to api.x.ai.
Capability Analysis
Type: OpenClaw Skill
Name: x-search-skill
Version: 1.0.0
The skill bundle is a well-implemented tool for searching X (Twitter) via the xAI API. The code in `scripts/search.py` uses only Python standard libraries, implements strict input validation for handles and dates, and includes a security-conscious custom redirect handler to prevent credential leakage. No signs of data exfiltration, malicious execution, or prompt injection were found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the Python tool calls the xAI Responses API (https://api.x.ai/v1/responses) using a single API key (XAI_API_KEY) to run an x_search tool. Required binary (python3) and the brew install of python are proportionate. Minor note: _meta.json contains a different ownerId than the registry metadata provided (small metadata mismatch that does not affect runtime behavior).
Instruction Scope
SKILL.md instructs only to set XAI_API_KEY and run the included Python script; the script reads only that env var and sends POSTs to api.x.ai. It does not touch other files, other env vars, or external endpoints. Small point: the README suggests optionally storing the key in ~/.openclaw/openclaw.json (a config path), but the skill's declared required config paths list is empty — this is benign but worth noting if you prefer explicit declarations.
Install Mechanism
Install spec is a single Homebrew formula (python). This is a standard, low-risk install path. Be aware brew is macOS/homebrew-specific; on other OSes the install step may be inapplicable but it does not pull arbitrary code from unknown hosts.
Credentials
Only one credential (XAI_API_KEY) is required and used as the Authorization bearer token for api.x.ai. No unrelated secrets or broad environment access are requested.
Persistence & Privilege
The skill is not always-enabled and does not request persistent or cross-skill privileges. It does not modify other skills or system-wide settings; it simply runs as a CLI tool when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-search-skill - After installation, invoke the skill by name or use
/x-search-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of x-search.
- Search X (Twitter) posts using the xAI Grok API with real-time access.
- Supports filtering and excluding specific handles, date range, and image/video understanding.
- Results include readable summaries with post content, author info, and citations.
- Requires an xAI API key and Python 3 for setup.
Metadata
Frequently Asked Questions
What is X-search-skill?
Search X (Twitter) posts using the xAI API. Use when the user wants to find tweets, search X/Twitter, look up what people are saying on X, or find social med... It is an AI Agent Skill for Claude Code / OpenClaw, with 93 downloads so far.
How do I install X-search-skill?
Run "/install x-search-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X-search-skill free?
Yes, X-search-skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X-search-skill support?
X-search-skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X-search-skill?
It is built and maintained by Pratikbhosale7 (@pratikbhosale7); the current version is v1.0.0.
More Skills