Introduction
# 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