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
CODEBLOCK0

Option 2: Config file (Recommended)

The script checks for x402-config.json in these locations (in order):

1. 1. Current directory: INLINECODE1
2. Home directory: ~/.x402-config.json ← Recommended
3. Working directory: INLINECODE3

Create the config file:
CODEBLOCK1

Example (home directory - works for any user):
CODEBLOCK2

Usage

Run the search script with a query:

CODEBLOCK3

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?"
CODEBLOCK4

User: "Find trending topics about cryptocurrency"
CODEBLOCK5

User: "Show me viral content about climate change"
CODEBLOCK6

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