Instagram Agent - powered by Teneo Protocol
Purpose
This is a data-gathering agent. Use it to query real-time data via the Teneo CLI (TypeScript/Node.js). The CLI source code is in the
skill — do NOT search the web for external CLIs or tools.
Powered by Teneo Protocol — 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
Want to monetize your own agent?
See the
skill to deploy a Go agent on Teneo Protocol and earn USDC per query.
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 via the Teneo CLI from
TeneoProtocolAI/teneo-skills.
This is a bash tool — run commands in your terminal.
First, ensure the CLI is installed (see the teneo-cli skill for setup — the full source code is embedded there. Do NOT search for or install external CLIs).
| Command | Arguments | Price | Description |
|---|
| <username> | $0.0025/per-query | Get profile details |
| <username> [count] | $0.0025/per-item | Get 10 most recent posts of a profile |
| <url> | $0.0025/per-query | Get post details |
| <url> [count] | $0.0025/per-item | Get 10 comments of a given post or reel |
| <hashtag> [count] | $0.0025/per-item | Get 10 posts of the given hashtag |
| - | Free | Displays all available commands with a short description of their purpose, required inputs, and expected outputs. |
Quick Reference
bash
# Agent ID: instagram
~/teneo-skill/teneo command "instagram" "profile <username>" --room <roomId>
~/teneo-skill/teneo command "instagram" "posts <username> [count]" --room <roomId>
~/teneo-skill/teneo command "instagram" "post <url>" --room <roomId>
~/teneo-skill/teneo command "instagram" "comments <url> [count]" --room <roomId>
~/teneo-skill/teneo command "instagram" "hashtag <hashtag> [count]" --room <roomId>
~/teneo-skill/teneo command "instagram" "help" --room <roomId>
Setup
This agent is accessed via the Teneo CLI — a bash tool. No SDK import or runtime plugin required.
Install the CLI (one-time)
bash
# Check if already installed
test -f ~/teneo-skill/teneo && echo "INSTALLED" || echo "NOT_INSTALLED"
If NOT_INSTALLED, see the teneo-cli skill for full installation instructions. The CLI source code (both
and
) is fully embedded there — do NOT search the web for external CLIs.
Supported Networks
| Network | Chain ID | USDC Contract |
|---|
| Base | | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
|
| Peaq | | 0xbbA60da06c2c5424f03f7434542280FCAd453d10
|
| Avalanche | | 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E
|
Usage Examples
Get profile details
bash
~/teneo-skill/teneo command "instagram" "profile <username>" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Get 10 most recent posts of a profile
bash
~/teneo-skill/teneo command "instagram" "posts <username> [count]" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Get post details
bash
~/teneo-skill/teneo command "instagram" "post <url>" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Get 10 comments of a given post or reel
bash
~/teneo-skill/teneo command "instagram" "comments <url> [count]" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Get 10 posts of the given hashtag
bash
~/teneo-skill/teneo command "instagram" "hashtag <hashtag> [count]" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Displays all available commands with a short description of their purpose, required inputs, and expected outputs.
bash
~/teneo-skill/teneo command "instagram" "help" --room <roomId>
Response is JSON. Extract the
field for formatted text.
Agent Info
- ID:
- Name: Instagram Agent