🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί X Search (x402)
πŸ¦€ ClawHub

X Search (x402)

by @tzannetosgiannis

AI-powered X/Twitter search for real-time trends, breaking news, sentiment analysis, and social media insights. Use when users want to search Twitter/X for topics, hashtags, viral content, or public opinion. Costs $0.05 USDC per request via x402 protocol on Base network.

Versionv1.0.0
Downloads2,982
Installs8
#writing#social-media#legal
TERMINAL
clawhub install x-search-x402

πŸ“– About This Skill

name: x-search description: AI-powered X/Twitter search for real-time trends, breaking news, sentiment analysis, and social media insights. Use when users want to search Twitter/X for topics, hashtags, viral content, or public opinion. Costs $0.05 USDC per request via x402 protocol on Base network.

X Search

Search X/Twitter using an AI-powered agent for real-time insights and social media intelligence.

Configuration

The private key must be available via one of these methods:

Option 1: Environment variable 

export X402_PRIVATE_KEY="0x..."

Option 2: Config file (Recommended)

The script checks for x402-config.json in these locations (in order): 1. Current directory: ./x402-config.json 2. Home directory: ~/.x402-config.json ← Recommended 3. Working directory: $PWD/x402-config.json

Create the config file: 

{
  "private_key": "0x1234567890abcdef..."
}

Example (home directory - works for any user): 

echo '{"private_key": "0x..."}' > ~/.x402-config.json

Usage

Run the search script with a query:

scripts/search.sh ""

The script:

  • Executes the npx CLI tool with payment handling
  • Costs $0.05 USDC per request (Base network)
  • Returns AI-processed search results

    • Examples

    User: "What are people saying about AI agents on Twitter?" 

    scripts/search.sh "AI agents discussions and opinions"

    User: "Find trending topics about cryptocurrency" 

    scripts/search.sh "cryptocurrency trends today"

    User: "Show me viral content about climate change" 

    scripts/search.sh "viral climate change posts"

    Capabilities

  • Real-time trends and breaking news
  • Social media sentiment analysis
  • Viral content tracking
  • Public opinion research
  • Hashtag and topic analysis

    • Error Handling

  • "Payment failed: Not enough USDC" β†’ Inform user to top up Base wallet with USDC
  • "X402 private key missing" β†’ Guide user to configure private key (see Configuration above)
  • Timeout errors β†’ The API has a 5-minute timeout; complex queries may take time

    • πŸ’‘ Examples

    User: "What are people saying about AI agents on Twitter?" 

    scripts/search.sh "AI agents discussions and opinions"

    User: "Find trending topics about cryptocurrency" 

    scripts/search.sh "cryptocurrency trends today"

    User: "Show me viral content about climate change" 

    scripts/search.sh "viral climate change posts"

    βš™οΈ Configuration

    The private key must be available via one of these methods:

    Option 1: Environment variable 

    export X402_PRIVATE_KEY="0x..."

    Option 2: Config file (Recommended)

    The script checks for x402-config.json in these locations (in order): 1. Current directory: ./x402-config.json 2. Home directory: ~/.x402-config.json ← Recommended 3. Working directory: $PWD/x402-config.json

    Create the config file: 

    {
  "private_key": "0x1234567890abcdef..."
}

    Example (home directory - works for any user): 

    echo '{"private_key": "0x..."}' > ~/.x402-config.json