twitter-query

What This Skill Does

The twitter-query skill provides a robust, read-only interface for fetching real-time data from X (formerly Twitter) directly into your OpenClaw environment. By leveraging the twitterapi.io backend, this tool allows users to pull structured tweet data based on specific user handles or complex search queries without the overhead of external LLM summarization. The skill outputs raw, parseable JSON data, ensuring that information remains pristine and ready for downstream processing or programmatic analysis. It is designed to act as a data retrieval layer, focusing on performance, accuracy, and ease of integration.

Installation

To integrate this skill into your workflow, you must have the OpenClaw environment configured. First, ensure you have a valid TWITTER_API_KEY from twitterapi.io. Installation is managed via the ClawHub CLI. Run the following command in your terminal: clawhub install openclaw/skills/skills/alexander10011/twitter-query Once installed, you must configure the environment variable by running export TWITTER_API_KEY="your_key_here" in your shell session. The skill relies on Python 3 for execution, and you should ensure the dependencies listed in the repository are satisfied before initiating any queries.

Use Cases

This skill is ideal for developers and analysts who need to monitor social sentiment, track real-time news, or build datasets from X. Common use cases include:

• Automated social media monitoring for specific industry leaders or competitors.
• Building custom news aggregators that track hashtags or specific ticker symbols like $BTC or $ETH.
• Analyzing historical data from a specific timeline to evaluate communications trends.
• Integrating live tweet feeds into dashboards or notification systems where structured, non-interpreted data is required.

Example Prompts

1. "Use twitter-query to fetch the last 20 tweets from VitalikButerin and output the results for analysis."
2. "Search for the latest 10 tweets containing the hashtag #OpenSource, filtered by latest results."
3. "Retrieve the top tweets from the last 24 hours that mention the term 'Artificial Intelligence' to get a snapshot of current discourse."

Tips & Limitations

• Read-Only: This skill cannot post tweets, like, or follow accounts. It is strictly a retrieval tool.
• Rate Limiting: Performance is subject to your twitterapi.io subscription tier. Always respect the API limits to avoid interruptions.
• Data Handling: Since the output is raw JSON, you may need to use tools like jq or Python's json library if processing large amounts of data at once.
• No LLM Interference: The skill does not provide summaries. If you need a summary of the retrieved data, pass the JSON output to your preferred LLM model within the OpenClaw chat interface.