← Back to Skills Marketplace
flyfoxci

Twitter Search

by flyfoxCI · GitHub ↗ · v0.1.2
cross-platform ⚠ suspicious
2538
Downloads
1
Stars
3
Active Installs
3
Versions
Install in OpenClaw
/install twitter-search-skill
Description
Advanced Twitter search and social media data analysis. Fetches tweets by keywords using Twitter API, processes up to 1000 results, and generates professional data analysis reports with insights and actionable recommendations. Use when user requests Twitter/X social media search, social media trend analysis, tweet data mining, social listening, influencer identification, topic sentiment analysis from tweets, or any task involving gathering and analyzing Twitter data for insights.
Usage Guidance
This skill appears to implement the described Twitter search and analysis functionality, but take these precautions before using it: 1) Metadata omission: the registry did not declare the required TWITTER_API_KEY — assume you must provide it. 2) Inspect the code yourself (scripts/run_search.sh and scripts/twitter_search.py) before running. 3) Do NOT let the wrapper script eval arbitrary content from your ~/.bashrc or ~/.zshrc: either set TWITTER_API_KEY in your current shell manually or pass the key as --api-key to the wrapper or as the first argument to the Python script. 4) Consider running the scripts in an isolated environment (container or VM) because the wrapper will run pip install if requests is missing. 5) Verify the external API host (twitterapi.io) and its trustworthiness and privacy policy. 6) Prefer passing the key on the command line or exporting it in a controlled, vetted profile file rather than allowing the script to parse and eval your shell rc files. If you need to install this skill for production use, ask the publisher to: (a) declare TWITTER_API_KEY in metadata, (b) remove eval and parse the key safely, (c) avoid implicit pip installs or document them clearly, and (d) document data retention and where query results are transmitted or stored.
Capability Analysis
Type: OpenClaw Skill Name: twitter-search-skill Version: 0.1.2 The skill is classified as suspicious primarily due to the use of `eval` in `scripts/run_search.sh`. This command is used to load the `TWITTER_API_KEY` from `~/.bashrc` or `~/.zshrc` by executing the output of a `grep` command. While the `grep` attempts to narrow the scope to a specific `export` line, `eval` is inherently a high-risk command that could be exploited if the user's shell configuration file were already compromised, potentially leading to arbitrary code execution. The skill also makes external network calls to `https://api.twitterapi.io` for its core functionality, which is expected for a Twitter search skill but involves transmitting an API key to a third-party service. No clear evidence of intentional malicious behavior (e.g., data exfiltration to unauthorized endpoints, persistence, or prompt injection) was found, but the `eval` usage represents a significant security risk.
Capability Assessment
Purpose & Capability
The skill's name/description match the included code (fetch tweets from an external Twitter API and analyze them). However the registry metadata claims no required environment variables or primary credential while the SKILL.md and scripts require a TWITTER_API_KEY — a metadata/instruction mismatch that is confusing and should have been declared.
Instruction Scope
SKILL.md and the wrapper script instruct the agent to load TWITTER_API_KEY from the user's ~/.bashrc or ~/.zshrc. The wrapper uses grep output and eval to set the variable at runtime, which can execute unintended shell content if those files contain malicious/unsafe constructions (e.g., command substitutions). The instructions also encourage using external web search for context (normal) but do not request any other unrelated files/credentials.
Install Mechanism
There is no declared install spec (no package downloads), which is low-risk. The wrapper script will attempt to pip3 install the requests module at runtime if missing (pip3 install requests --user). That is a reasonable but notable runtime install action — not inherently malicious but it modifies the environment and should be audited or run in a controlled environment.
Credentials
The only secret the skill needs is a Twitter API key (TWITTER_API_KEY), which is proportional for its purpose. However the skill metadata fails to declare this required credential. Also the wrapper's practice of reading and eval'ing shell startup files increases the risk of accidental code execution or leaking the key if those files are compromised. The script prints a masked API key prefix (first 8 chars) to stderr — minor disclosure but worth noting.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide agent settings. SKILL.md suggests adding an export line to ~/.bashrc as an installation convenience (user action), which would create persistent storage for the key — this is optional but is a user-facing suggestion that could grant the key to other processes on the machine if not handled carefully.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install twitter-search-skill
  3. After installation, invoke the skill by name or use /twitter-search-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
No user-facing changes in this release. - Version bump with no detected file changes. - Functionality and documentation remain unchanged.
v0.1.1
twitter-search-skill v0.1.1 changelog - Added wrapper script (`scripts/run_search.sh`) for convenient CLI usage, environment variable loading, and dependency checks. - Added core search and analysis script (`scripts/twitter_search.py`) for fetching and analyzing tweets via the Twitter API. - Included a detailed `README.md` with setup, usage instructions, analysis workflow, and output/report guidelines. - Added `references/twitter_api.md` to document Twitter API requirements and integration details.
v0.1.0
twitter-search-skill v0.1.0 - Initial release with Twitter advanced search and analysis capabilities. - Fetch up to 1000 tweets via Twitter API using flexible query syntax. - Supports professional data analysis reports: statistics, trends, influencers, sentiment, and actionable recommendations. - Wrapper script and Python script provided, with options for API key management and output formats (summary or JSON). - Detailed usage instructions and report formatting guidelines in markdown.
Metadata
Slug twitter-search-skill
Version 0.1.2
License
All-time Installs 3
Active Installs 3
Total Versions 3
Frequently Asked Questions

What is Twitter Search?

Advanced Twitter search and social media data analysis. Fetches tweets by keywords using Twitter API, processes up to 1000 results, and generates professional data analysis reports with insights and actionable recommendations. Use when user requests Twitter/X social media search, social media trend analysis, tweet data mining, social listening, influencer identification, topic sentiment analysis from tweets, or any task involving gathering and analyzing Twitter data for insights. It is an AI Agent Skill for Claude Code / OpenClaw, with 2538 downloads so far.

How do I install Twitter Search?

Run "/install twitter-search-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Twitter Search free?

Yes, Twitter Search is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Twitter Search support?

Twitter Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Twitter Search?

It is built and maintained by flyfoxCI (@flyfoxci); the current version is v0.1.2.

💬 Comments