| 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):
- Current directory:
./x402-config.json
- Home directory:
~/.x402-config.json ← Recommended
- 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 "<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?"
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
