---
name: agents.402box.io
description: agents.402box.io hosts an AI-powered X/Twitter search skill that accepts natural-language queries and returns markdown-formatted summaries of trends, account activity, and social insights. It wraps an AI agent layer on top of X/Twitter data, producing synthesized analysis rather than raw tweet objects.
host: agents.402box.io
---

# agents.402box.io

This host provides a single, AI-mediated interface to X/Twitter social data. It is designed for agents that need interpreted social intelligence—trend summaries, topic analysis, account overviews—delivered as readable markdown. It does not expose raw API data or structured tweet exports; the output is always a natural-language synthesis produced by an underlying AI agent.

## When to use this host

Use this host when an agent needs a quick, human-readable summary of X/Twitter trends, a specific account's activity, or social sentiment around a topic—and the output format of markdown prose is acceptable. Do not use it when you need structured data (e.g., JSON arrays of tweets, engagement metrics tables, or bulk historical retrieval); for those use cases, a direct Twitter/X API integration or a dedicated social-data pipeline is more appropriate. Also avoid this host if downstream processing requires machine-parseable fields rather than free-form markdown.

## Capabilities

### Social Media Intelligence

Queries X/Twitter via a natural-language prompt and returns AI-synthesized markdown covering trends, topic analysis, and account or post insights.

- **`search-x-twitter-insights`** — Searches X/Twitter via an AI agent and returns a markdown-formatted response with trends, social insights, and analysis for a given query or prompt.

## Skill reference

### `search-x-twitter-insights`

**XInsight Search** — Searches X/Twitter via an AI agent and returns a markdown-formatted response with trends, social insights, and analysis for a given query or prompt.

*Use when:* Use when an agent needs to retrieve real-time X/Twitter trends, analyze a specific account, post, or topic, or gather social-media insights based on a natural-language query.

*Not for:* Do not use for structured data exports or bulk historical tweet retrieval; this returns a natural-language markdown summary, not raw tweet objects or timelines.

**Inputs:**

- `message` (string, required) — Search query or natural-language prompt for the X/Twitter searcher agent (e.g., a handle, topic, trend, or analysis request).

**Returns:** Returns success=true with a markdown-formatted response string containing X/Twitter analysis, plus usage metrics including token counts, iteration count, execution time, and USDC cost breakdown.

**Example:** `{"message": "What are the top trending topics on X today related to AI?"}`

---