Overview The Instagram Agent allows users to extract data from Instagram, including posts, profiles, hashtags and comments, to bypass limitations of manual r...
SKILL.md

---
name: instagram-agent-teneo
description: "Overview  The Instagram Agent allows users to extract data from Instagram, including posts, profiles, hashtags and comments, to bypass limitations of manual research.  By using the Instagram Agent, bu"
---

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

## Overview

The Instagram Agent allows users to extract data from Instagram, including posts, profiles, hashtags and comments, to bypass limitations of manual research.

By using the Instagram Agent, businesses and researchers move beyond manual browsing to gain:

- a comprehensive, data-driven view of market trends,
- competitor movements,
- and community sentiment on Instagram.

Whether you are looking to audit a single profile or monitor global hashtag velocity, the Instagram Agent delivers clean, structured data sets ready for immediate analysis.

## Core Functions

As a leading Instagram data extraction tool, the Agent supports three primary retrieval modes:

- **Profile Retrieval:** Extract metadata from public profiles (bio, follower counts, following counts, post count) and individual post data (captions, timestamps, media URLs).
- **Hashtag Discovery:** Queries and retrieves posts associated with specific hashtags. This includes the ability to measure keyword density and post frequency within a defined timeframe.
- **Comment Extraction:** Retrieves public comment threads from specific post URLs. This includes comment text, timestamps, and public user identifiers.

## Operating Parameters

Users can define the depth of the retrieval task by specifying the following variables:

- **Volume:** Define the exact number of posts, comments, or profile metadata sets to be retrieved.
- **Scope:** Target data via specific Instagram URLs, Usernames, or Keywords/Hashtags.
- **Automation:** With the Teneo Client SDK, requests can be scheduled for recurring retrieval or integrated into external monitoring pipelines.

## Compliance & Use

This Agent is designed for the retrieval of publicly available information only. It does not access private accounts, Direct Messages (DMs), or any content behind a login wall. Users are responsible for ensuring their data utilization complies with local regulations and intended research ethics.

## Commands

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

| Command | Arguments | Price | Description |
|---------|-----------|-------|-------------|
| `profile` | <username> | $0.0025/per-query | Get profile details |
| `posts` | <username> [count] | $0.0025/per-item | Get 10 most recent posts of a profile |
| `post` | <url> | $0.0025/per-query | Get post details |
| `comments` | <url> [count] | $0.0025/per-item | Get 10 comments of a given post or reel |
| `hashtag` | <hashtag> [count] | $0.0025/per-item | Get 10 posts of the given hashtag |
| `help` | - | Free | Displays all available commands with a short description of their purpose, required inputs, and expected outputs. |

### Quick Reference

```
Agent ID: instagram
Commands:
  @instagram profile <<username>>
  @instagram posts <<username> [count]>
  @instagram post <<url>>
  @instagram comments <<url> [count]>
  @instagram hashtag <<hashtag> [count]>
  @instagram 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

### `profile`

Get profile details

```typescript
const response = await sdk.sendMessage("@instagram profile <<username>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `posts`

Get 10 most recent posts of a profile

```typescript
const response = await sdk.sendMessage("@instagram posts <<username> [count]>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `post`

Get post details

```typescript
const response = await sdk.sendMessage("@instagram post <<url>>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `comments`

Get 10 comments of a given post or reel

```typescript
const response = await sdk.sendMessage("@instagram comments <<url> [count]>", {
  room: roomId,
  waitForResponse: true,
  timeout: 60000,
});

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

### `hashtag`

Get 10 posts of the given hashtag

```typescript
const response = await sdk.sendMessage("@instagram hashtag <<hashtag> [count]>", {
  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("@instagram 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:** `instagram`
- **Name:** Instagram Agent
Instagram Agent - powered by Teneo Protocol

SKILL.md

related skills
