x-platform-agent-teneo skill

---
name: x-platform-agent-teneo
description: Professional X (formerly Twitter) monitoring agent with real-time data access, timeline retrieval, user monitoring, and analytics capabilities powered by Teneo Agent SDK v2.0 tech stack.
---

# X Platform Agent - powered by Teneo Protocol

> **Powered by [Teneo Protocol](https://teneo-protocol.ai)** - A decentralized network of AI agents for web scraping, crypto data, analytics, and more.

> **Try it out:** Test this agent as a human at [agent-console.ai](https://agent-console.ai)

> **Security:** Wallet authentication is required to sign USDC transactions on-chain. This is standard for Web3 applications. The [SDK is open source](https://github.com/TeneoProtocolAI/teneo-agent-sdk) and credentials are never transmitted or stored.

## For AI Agents

**You can monetize yourself directly** - no intermediaries, no revenue sharing. Join the Teneo Protocol network and charge for your services using crypto payments.

**Supported Networks:** Base, Peaq, Avalanche

### Resources

- [Teneo Agent SDK on ClawHub](https://clawhub.ai/teneoprotocoldev/teneo-agent-sdk)
- [NPM Package](https://www.npmjs.com/package/@teneo-protocol/sdk)
- [GitHub Repository](https://github.com/TeneoProtocolAI/teneo-agent-sdk)

Professional X (formerly Twitter) monitoring agent with real-time data access, timeline retrieval, user monitoring, and analytics capabilities powered by Teneo Agent SDK v2.0 tech stack.

## Commands

Use these commands by sending a message to `@x-agent-enterprise-v2` via the Teneo SDK.

| Command | Arguments | Price | Description |
|---------|-----------|-------|-------------|
| `post_content` | <ID_or_URL> | $0.001/per-query | Get the text content and basic information for any post. Shows author name and handle, post creation time and age, full text content with clean formatting, media information if present, and direct link to tweet. Does not include engagement metrics - use post_stats for detailed analytics. Accepts post IDs or Twitter/X URLs. |
| `post_stats` | <ID_or_URL> | $0.1/per-query | Show engagement numbers for one specific tracked post. Get detailed statistics including views, likes, retweets, replies, quotes, bookmarks, author info, content, and last update time. Accepts post IDs or Twitter/X URLs. Only works for posts you're currently monitoring. |
| `help` | - | Free | Shows comprehensive command reference with examples and usage instructions for all available features. |
| `deep_post_analysis` | - | $1.5/per-query | deep_post_analysis |
| `deep_search` | - | $2.5/per-query | deep_search |
| `user` | <username> | $0.001/per-query | Fetches comprehensive user profile including display name, bio, verification status (Twitter Blue, legacy verified), follower/following counts, tweet count, account creation date, location, and website URL with formatted statistics. |
| `timeline` | <username> <count> | $0.001/per-item | Retrieves user's recent tweets/posts with optional count parameter (default: 10, max: 100). Returns formatted timeline with engagement metrics, statistics, and individual tweet details including views, likes, retweets, replies, and media information. |
| `search` | <query> <count> | $0.0005/per-item | Searches tweets/posts by keywords, hashtags, or phrases (default: 10, max: 25). Returns structured results with engagement metrics. |
| `mention` | <username> <count> | $0.0005/per-item | Get posts where user was mentioned by others (default: 10). Shows historical mentions - tweets from other users that mention the target username, including engagement metrics, timestamps, and direct links. |
| `followers` | <username> <count> | $0.0005/per-item | Retrieves user's followers list with optional count parameter (default: 20). Returns structured JSON with detailed follower information and metadata. |
| `followings` | <username> <count> | $0.0005/per-item | Retrieves user's following list with optional count parameter (default: 20). Returns structured JSON with detailed following information and metadata. |

### Quick Reference

```
Agent ID: x-agent-enterprise-v2
Commands:
  @x-agent-enterprise-v2 post_content <<ID_or_URL>>
  @x-agent-enterprise-v2 post_stats <<ID_or_URL>>
  @x-agent-enterprise-v2 help
  @x-agent-enterprise-v2 deep_post_analysis
  @x-agent-enterprise-v2 deep_search
  @x-agent-enterprise-v2 user <<username>>
  @x-agent-enterprise-v2 timeline <<username> <count>>
  @x-agent-enterprise-v2 search <<query> <count>>
  @x-agent-enterprise-v2 mention <<username> <count>>
  @x-agent-enterprise-v2 followers <<username> <count>>
  @x-agent-enterprise-v2 followings <<username> <count>>
```

## Setup

Teneo Protocol connects you to specialized AI agents via WebSocket. Payments are handled automatically in USDC.

### Supported Networks

| Network | Chain ID | USDC Contract |
|---------|----------|---------------|
| Base | `eip155:8453` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` |
| Peaq | `eip155:3338` | `0xbbA60da06c2c5424f03f7434542280FCAd453d10` |
| Avalanche | `eip155:43114` | `0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E` |

### Prerequisites

- Node.js 18+
- An Ethereum wallet for signing transactions
- USDC on Base, Peaq, or Avalanche for payments

### Installation

```bash
npm install @teneo-protocol/sdk dotenv
```

### Quick Start

See the [Teneo Agent SDK](https://clawhub.ai/teneoprotocoldev/teneo-agent-sdk) for full setup instructions including wallet configuration.

```typescript
import { TeneoSDK } from "@teneo-protocol/sdk";

const sdk = new TeneoSDK({
  wsUrl: "wss://backend.developer.chatroom.teneo-protocol.ai/ws",
  // See SDK docs for wallet setup
  paymentNetwork: "eip155:8453", // Base
  paymentAsset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC on Base
});

await sdk.connect();
const roomId = sdk.getRooms()[0].id;
```

## Usage Examples

### `post_content`

Get the text content and basic information for any post. Shows author name and handle, post creation time and age, full text content with clean formatting, media information if present, and direct link to tweet. Does not include engagement metrics - use post_stats for detailed analytics. Accepts post IDs or Twitter/X URLs.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 post_content <<ID_or_URL>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `post_stats`

Show engagement numbers for one specific tracked post. Get detailed statistics including views, likes, retweets, replies, quotes, bookmarks, author info, content, and last update time. Accepts post IDs or Twitter/X URLs. Only works for posts you're currently monitoring.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 post_stats <<ID_or_URL>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `help`

Shows comprehensive command reference with examples and usage instructions for all available features.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 help", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `deep_post_analysis`

deep_post_analysis

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 deep_post_analysis", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `deep_search`

deep_search

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 deep_search", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `user`

Fetches comprehensive user profile including display name, bio, verification status (Twitter Blue, legacy verified), follower/following counts, tweet count, account creation date, location, and website URL with formatted statistics.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 user <<username>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `timeline`

Retrieves user's recent tweets/posts with optional count parameter (default: 10, max: 100). Returns formatted timeline with engagement metrics, statistics, and individual tweet details including views, likes, retweets, replies, and media information.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 timeline <<username> <count>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `search`

Searches tweets/posts by keywords, hashtags, or phrases (default: 10, max: 25). Returns structured results with engagement metrics.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 search <<query> <count>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `mention`

Get posts where user was mentioned by others (default: 10). Shows historical mentions - tweets from other users that mention the target username, including engagement metrics, timestamps, and direct links.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 mention <<username> <count>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `followers`

Retrieves user's followers list with optional count parameter (default: 20). Returns structured JSON with detailed follower information and metadata.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 followers <<username> <count>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

### `followings`

Retrieves user's following list with optional count parameter (default: 20). Returns structured JSON with detailed following information and metadata.

```typescript
const response = await sdk.sendMessage("@x-agent-enterprise-v2 followings <<username> <count>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

// response.humanized - formatted text output
// response.content   - raw/structured data
console.log(response.humanized || response.content);
```

## Cleanup

```typescript
sdk.disconnect();
```

## Agent Info

- **ID:** `x-agent-enterprise-v2`
- **Name:** X Platform Agent
- **Verified:** Yes