← Back to Skills Marketplace
X Search 1.0.0
by
GitHub2Cao
· GitHub ↗
· v1.0.0
· MIT-0
81
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install x-search1
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 (search X via xAI/Grok) and only needs your XAI_API_KEY and python3. Before installing: 1) Confirm you trust the skill publisher — the package metadata includes two different ownerId values (registry vs _meta.json) which you may want to verify. 2) Note SKILL.md mentions storing the key in ~/.openclaw/openclaw.json, but the script only reads XAI_API_KEY from the environment — if you set the key only in the JSON config it may not be picked up. 3) Limit the API key's permissions if possible and check your x.ai console for usage after first runs. 4) You can review and run the included tests (scripts/test_search.py) locally to confirm behavior before giving the key to this environment. 5) If you need higher assurance, ask the publisher to reconcile the ownerId mismatch and confirm whether the skill intends to read ~/.openclaw/openclaw.json.
Capability Analysis
Type: OpenClaw Skill
Name: x-search1
Version: 1.0.0
The x-search skill is a legitimate tool for querying the xAI Grok API to search X (Twitter) content. The implementation in `scripts/search.py` is well-structured, using only Python standard libraries and including robust input validation (regex for handles and dates) and a custom redirect handler for security. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), and required env var (XAI_API_KEY) align with contacting the x.ai Responses (Grok) API to perform searches. The API endpoint (https://api.x.ai/v1/responses) and model usage in code match the stated purpose.
Instruction Scope
SKILL.md instructs only to set XAI_API_KEY and run the included script, which is what the code does. Minor inconsistency: SKILL.md suggests you can set skills."x-search".apiKey or skills."x-search".env.XAI_API_KEY in ~/.openclaw/openclaw.json, but the provided search.py reads only the XAI_API_KEY environment variable and does not read that config file. Also the _meta.json ownerId differs from the registry ownerId in the supplied metadata (two different owner IDs), which is a metadata mismatch worth checking with the publisher.
Install Mechanism
Install spec is a single Homebrew formula for python (standard). No downloads from unknown hosts and no archive extraction; code files are included in the skill package.
Credentials
The skill requests one credential (XAI_API_KEY) which is the expected credential for the xAI API. No other secrets or unrelated environment variables are required.
Persistence & Privilege
The skill does not request always:true and is user-invocable; it does not modify other skills or system configs. It runs on demand and only needs the environment variable to operate.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-search1 - After installation, invoke the skill by name or use
/x-search1 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of X Search skill for searching X (Twitter) posts via xAI API.
- Search X posts in real-time using xAI Grok API.
- Supports filtering by handles, excluding handles, date range, and media (images/videos).
- Provides citations linking directly to original X posts.
- Easy setup with API key and Python 3 dependency.
- Detailed usage examples included for flexible search options.
Metadata
Frequently Asked Questions
What is X Search 1.0.0?
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 81 downloads so far.
How do I install X Search 1.0.0?
Run "/install x-search1" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Search 1.0.0 free?
Yes, X Search 1.0.0 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Search 1.0.0 support?
X Search 1.0.0 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Search 1.0.0?
It is built and maintained by GitHub2Cao (@github2cao); the current version is v1.0.0.
More Skills