← 返回 Skills 市场
flyfoxci

Twitter Search

作者 flyfoxCI · GitHub ↗ · v0.1.2
cross-platform ⚠ suspicious
2538
总下载
1
收藏
3
当前安装
3
版本数
在 OpenClaw 中安装
/install twitter-search-skill
功能描述
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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install twitter-search-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /twitter-search-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug twitter-search-skill
版本 0.1.2
许可证
累计安装 3
当前安装数 3
历史版本数 3
常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2538 次。

如何安装 Twitter Search?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install twitter-search-skill」即可一键安装,无需额外配置。

Twitter Search 是免费的吗?

是的,Twitter Search 完全免费(开源免费),可自由下载、安装和使用。

Twitter Search 支持哪些平台?

Twitter Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Twitter Search?

由 flyfoxCI(@flyfoxci)开发并维护,当前版本 v0.1.2。

💬 留言讨论