Amazon - powered by Teneo Protocol

SKILL.md

---
name: amazon-teneo
description: "Overview The Amazon Agent is a high-performance tool designed to turn massive e-commerce datasets into structured, usable intelligence. It allows users to extract data from Amazon to monitor pricing,"
---

# Amazon - 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)

## Overview
The Amazon Agent is a high-performance tool designed to turn massive e-commerce datasets into structured, usable intelligence. It allows users to extract data from Amazon to monitor pricing, audit competitor catalogs, and analyze consumer sentiment at scale.

By using the Amazon Agent, businesses and e-commerce researchers move beyond manual price-checking to gain:

- **Dynamic Pricing Intelligence:** A real-time view of price fluctuations and "Best Seller" rankings.
- **Competitor Catalog Audits:** Deep-dives into product specifications, stock status, and featured listings.
- **Customer Sentiment Analysis:** High-fidelity extraction of global product reviews to identify market gaps and quality trends.

Whether you are looking to audit a single ASIN or monitor an entire product category across different countries, the Amazon Agent delivers clean, structured datasets ready for immediate strategic analysis.

## Core Functions
The Agent supports three primary retrieval and discovery modes:

- **Product Detail Extraction:** Retrieve comprehensive metadata from specific product pages (ASIN, descriptions, pricing, images, and technical specs).
- **Advanced Marketplace Search:** Query Amazon with granular control. Filters include pagination, country-specific domains, and sorting (Bestsellers, Price, Recent, Featured, or Average Review).
- **Review Retrieval:** Extract complete customer review threads to fuel sentiment analysis and competitive benchmarking.

## Commands

Use these commands by sending a message to `@amazon` via the Teneo SDK.

| Command | Arguments | Price | Description |
|---------|-----------|-------|-------------|
| `product` | <ASIN> <domain> | $0.0025/per-query | Extract product details |
| `search` | <keywords> <page> <domain> <currency> <sort-by> | $0.0025/per-query | Search for products on Amazon with optional pagination, country filter, and sorting. Results can be sorted by bestsellers, most_recent, price_low_to_high, price_high_to_low, featured, or average_review. Use quotes for multi-word queries (e.g., "word1 word2"). |
| `reviews` | <ASIN> <domain> <currency> | $0.001/per-query | Extract product reviews |
| `help` | - | Free | Displays all available commands with a short description of their purpose, required inputs, and expected outputs. |

### Quick Reference

```
Agent ID: amazon
Commands:
  @amazon product <<ASIN> <domain>>
  @amazon search <<keywords> <page> <domain> <currency> <sort-by>>
  @amazon reviews <<ASIN> <domain> <currency>>
  @amazon help
```

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

### `product`

Extract product details

```typescript
const response = await sdk.sendMessage("@amazon product <<ASIN> <domain>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `search`

Search for products on Amazon with optional pagination, country filter, and sorting. Results can be sorted by bestsellers, most_recent, price_low_to_high, price_high_to_low, featured, or average_review. Use quotes for multi-word queries (e.g., "word1 word2").

```typescript
const response = await sdk.sendMessage("@amazon search <<keywords> <page> <domain> <currency> <sort-by>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `reviews`

Extract product reviews

```typescript
const response = await sdk.sendMessage("@amazon reviews <<ASIN> <domain> <currency>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `help`

Displays all available commands with a short description of their purpose, required inputs, and expected outputs.

```typescript
const response = await sdk.sendMessage("@amazon help", {
  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:** `amazon`
- **Name:** Amazon