search-x

What This Skill Does

The search-x skill allows you to search X (formerly Twitter) in real-time. It offers two powerful modes for retrieving information: the default xAI Grok mode, which leverages AI for advanced search capabilities up to 30 days back, and the X API mode (--x-api) for direct access to X's native search, limited to the last 7 days. This skill is ideal for staying updated on breaking news, tracking discussions, monitoring brand sentiment, and discovering emerging trends directly from the X platform.

Installation

To install the search-x skill, use the following command:

node {baseDir}/scripts/install.js openclaw/skills/skills/mvanhorn/search-x

Environment Setup:

• For xAI Grok Mode (Default): You need an XAI_API_KEY. Set it as an environment variable:

  export XAI_API_KEY="xai-YOUR-KEY"
  

  Obtain your key from https://console.x.ai.

• For X API Mode: You need an X_BEARER_TOKEN. Set it as an environment variable:

  export X_BEARER_TOKEN="YOUR-BEARER-TOKEN"
  

  Obtain your token from https://console.x.com. Note that the X API uses a pay-per-usage model.

Use Cases

• Real-time News Monitoring: Track breaking news and discussions as they happen.
• Trend Analysis: Identify trending topics and understand public sentiment around them.
• Competitor & Brand Monitoring: Keep an eye on what's being said about your brand or competitors.
• Influencer Research: Find posts and discussions from specific users or accounts.
• Community Engagement: Discover conversations related to your interests or industry.

Example Prompts

1. User: "Find recent tweets about the new AI advancements in healthcare." Action: This would trigger a search for "AI advancements in healthcare" using the default xAI Grok mode.

2. User: "What are people saying about the latest Apple product launch? Show me posts from the last 3 days." Action: This would use search-x --days 3 "Apple product launch".

3. User: "Search X for tweets by @TechCrunch regarding new software releases in the last 7 days." Action: This would trigger search-x --x-api --handles @TechCrunch --days 7 "software releases".

Tips & Limitations

• Grok vs. X API: Grok offers AI-powered search up to 30 days, ideal for richer analysis. The native X API is limited to 7 days but provides direct access. Choose based on your recency and depth requirements.
• API Keys: Ensure your API keys are securely stored and correctly exported as environment variables. The skill will not function without them.
• Rate Limits: Be mindful of potential API rate limits, especially when using the native X API extensively.
• Data Freshness: The X API mode is strictly limited to the last 7 days. Grok mode extends this to 30 days.
• Output Formatting: Utilize --json, --compact, or --links-only flags for tailored output formats depending on your needs.
• Exclusion Filters: Use the --exclude flag to filter out unwanted results, such as automated posts.