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