← Back to Skills Marketplace
95
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install x-search-grok
Description
Search X (Twitter) for account posts, trending topics, or topic discussions using Grok API. Outputs Obsidian-ready Markdown.
Usage Guidance
This skill mostly does what it says: it calls api.x.ai to produce structured summaries of X/Twitter content and saves Obsidian-friendly Markdown. Before installing: 1) Confirm the XAI API key requirement — registry metadata omitted XAI_API_KEY but the code will exit if it is not set. 2) Verify the SKILL.md GitHub source (https://github.com/wangyue55/x-search-skill) and review the full code if you don't trust it. 3) Only provide XAI_API_KEY (and optionally XAI_MODEL) — do not pass other secrets. 4) Be cautious when scheduling runs: scheduled jobs will have access to any environment variables available to the scheduler, so avoid exposing other credentials. 5) If you need stronger assurance, ask the author to correct the registry metadata to declare required env vars and pip deps, or run the scripts in an isolated sandbox first.
Capability Analysis
Type: OpenClaw Skill
Name: x-search-grok
Version: 1.0.0
The x-search-grok skill bundle is a legitimate tool designed to search X (Twitter) via the xAI Grok API and format the results into Obsidian-ready Markdown. The core logic in x_search.py and watchlist.py is well-implemented, using safe practices such as yaml.safe_load and list-based subprocess.run to prevent injection vulnerabilities. The skill's behavior, including file system access for saving reports and network access to the official x.ai API, is fully consistent with its stated purpose and documentation (SKILL.md, OPENCLAW.md).
Capability Assessment
Purpose & Capability
The code and SKILL.md are consistent with the stated purpose: they call the xAI/Grok responses endpoint to produce structured X/Twitter search summaries and save them as Markdown. However, the registry metadata claims no required env vars or installs while the SKILL.md and code clearly require XAI_API_KEY (and optionally XAI_MODEL) and Python packages (requests, pyyaml). That mismatch between declared metadata and actual requirements is an incoherence.
Instruction Scope
Runtime instructions and scripts stay within the stated purpose: they build prompts for the Grok API, parse structured output, and optionally save results to user-specified files. The watchlist script runs the local search script via subprocess; files are written only to paths the user supplies or their home directories. There are no instructions to read unrelated system files, other credentials, or to transmit data to unexpected endpoints beyond api.x.ai.
Install Mechanism
This is effectively an instruction-only skill (no complex installer). The SKILL.md recommends installing 'requests' and 'pyyaml' via pip; there is no registry install specification. The included code uses only standard Python plus requests/pyyaml and does not download arbitrary executables or archives. The mismatch between declared install spec (none) and SKILL.md is the main issue, but the install mechanism itself is low-risk.
Credentials
The code requires a single service credential (XAI_API_KEY) and optionally XAI_MODEL; these are proportional to calling the x.ai API. The problem: the registry metadata reported 'Required env vars: none' while SKILL.md and code require XAI_API_KEY. No other unrelated credentials are requested. Ensure XAI_API_KEY is the only secret you provide and that you trust the x.ai endpoint.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills or system-wide configs. It writes output files to user-specified paths and can be scheduled via OpenClaw cron as documented; that is expected for a monitoring/watchlist tool. Scheduling does increase blast radius if you place credentials in environment variables accessible to scheduled jobs — follow least privilege practices.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-search-grok - After installation, invoke the skill by name or use
/x-search-grok - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Search X accounts, trends, and topics via xAI Grok API. Outputs Obsidian-ready Markdown with translation, summary, and keywords.
Metadata
Frequently Asked Questions
What is X Search (Grok API)?
Search X (Twitter) for account posts, trending topics, or topic discussions using Grok API. Outputs Obsidian-ready Markdown. It is an AI Agent Skill for Claude Code / OpenClaw, with 95 downloads so far.
How do I install X Search (Grok API)?
Run "/install x-search-grok" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Search (Grok API) free?
Yes, X Search (Grok API) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Search (Grok API) support?
X Search (Grok API) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Search (Grok API)?
It is built and maintained by wangyue55 (@wangyue55); the current version is v1.0.0.
More Skills