Skill: tzannetosgiannis/x-search-x402 (version 1.0.0)

--- 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** ```bash 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: ```json { "private_key": "0x1234567890abcdef..." } ``` **Example (home directory - works for any user):** ```bash echo '{"private_key": "0x..."}' > ~/.x402-config.json ``` ## Usage Run the search script with a query: ```bash scripts/search.sh "<search query>" ``` 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?" ```bash scripts/search.sh "AI agents discussions and opinions" ``` **User:** "Find trending topics about cryptocurrency" ```bash scripts/search.sh "cryptocurrency trends today" ``` **User:** "Show me viral content about climate change" ```bash 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

path: scripts/search.sh
content: #!/bin/bash
# X/Twitter search via x402 protocol
# Usage: search.sh "<query>"

set -e

QUERY="$*"

# Check if query is provided
if [ -z "$QUERY" ]; then
    echo "Error: No search query provided"
    echo "Usage: search.sh \"<query>\""
    exit 1
fi

# Try to find config file in multiple locations
CONFIG_LOCATIONS=(
    "./x402-config.json"
    "$HOME/.x402-config.json"
    "$PWD/x402-config.json"
)

# Check each location for config file
for CONFIG_FILE in "${CONFIG_LOCATIONS[@]}"; do
    if [ -f "$CONFIG_FILE" ]; then
        PRIVATE_KEY=$(jq -r '.private_key' "$CONFIG_FILE" 2>/dev/null || echo "")
        if [ -n "$PRIVATE_KEY" ]; then
            export X402_PRIVATE_KEY="$PRIVATE_KEY"
            break
        fi
    fi
done

# Check if private key is available
if [ -z "$X402_PRIVATE_KEY" ]; then
    echo "Error: X402 private key missing"
    echo ""
    echo "Please configure your private key using one of these methods:"
    echo "1. Set environment variable: export X402_PRIVATE_KEY=\"0x...\""
    echo "2. Create x402-config.json in current directory with:"
    echo '   {"private_key": "0x..."}'
    echo "3. Create ~/.x402-config.json in your home directory"
    exit 1
fi

# Execute the search
npx -y @itzannetos/x402-tools-claude x-search "$QUERY"


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (HIGH)