← Back to Skills Marketplace
X Trends (using official API)
by
Terry Djony
· GitHub ↗
· v1.0.0
· MIT-0
113
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install x-trends-api
Description
Get trending topics on X (Twitter) using the X API. Use when the user wants to see what's trending or check trends for a location.
Usage Guidance
This skill appears to do what it says: it uses the X API to fetch trends and only requires your X bearer token and python3. Before installing: (1) ensure you trust the skill source because the bearer token grants read access to the API — treat it like a secret and consider creating a token with minimal scope or revoking it if necessary; (2) avoid leaking the token on the command line or history (use your OpenClaw config or environment management), and (3) on non-mac systems Homebrew install may not apply—just ensure python3 is installed by your OS package manager. If you need higher assurance, review the included scripts locally (trends.py and woeid.json) — they are short and readable.
Capability Analysis
Type: OpenClaw Skill
Name: x-trends-api
Version: 1.0.0
The x-trends-api skill bundle is a well-implemented tool for fetching Twitter trends. The Python scripts (trends.py and woeid_lookup.py) include robust input validation using regular expressions to prevent injection attacks and a custom HTTP handler that explicitly blocks redirects to ensure the X_BEARER_TOKEN is not leaked to unauthorized domains. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the included Python scripts and the single required env var (X_BEARER_TOKEN). Required binary (python3) and the bundled WOEID data are appropriate for a trends-by-location tool.
Instruction Scope
SKILL.md instructs only how to provide the bearer token and run the provided scripts; runtime instructions reference only the local woeid.json and the X API endpoint. The scripts do not read unrelated files or env vars.
Install Mechanism
Install spec uses the official 'python' Homebrew formula to provide python3 which is reasonable for macOS/homebrew users; systems without Homebrew must already have python3 available or install it via their package manager. No downloads from untrusted URLs or arbitrary code-execution installs are present.
Credentials
Only a single credential is requested (X_BEARER_TOKEN), which is necessary to call the X API. The skill does not ask for other unrelated secrets or config paths.
Persistence & Privilege
always:false (default) and the skill does not request permanent presence or modify other skills. It can be invoked by the agent but that is the platform default.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install x-trends-api - After installation, invoke the skill by name or use
/x-trends-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of x-trends skill.
- Fetch trending topics from X (Twitter) using the X API.
- Supports trending topics lookup by location (WOEID), with adjustable result limits.
- Includes WOEID lookup tool to help find the code for any city or country.
- Requires an X API Bearer Token for authentication.
- Presents trend names and tweet counts where available.
Metadata
Frequently Asked Questions
What is X Trends (using official API)?
Get trending topics on X (Twitter) using the X API. Use when the user wants to see what's trending or check trends for a location. It is an AI Agent Skill for Claude Code / OpenClaw, with 113 downloads so far.
How do I install X Trends (using official API)?
Run "/install x-trends-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is X Trends (using official API) free?
Yes, X Trends (using official API) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does X Trends (using official API) support?
X Trends (using official API) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created X Trends (using official API)?
It is built and maintained by Terry Djony (@terryds); the current version is v1.0.0.
More Skills