Intelligence, analysis, and data export toolkit for Instagram
15 tools with basic schemas and descriptions, but significant gaps in output documentation, error handling, and parameter completeness. All tools have names starting with action verbs (get_, search_, download_, export_) and descriptions present (avg ~100 chars). However, output schemas are entirely undocumented, LLMs cannot plan downstream calls or extract chaining IDs. Parameter descriptions are minimal (e.g., 'Instagram username' with no format guidance). No error recovery guidance. WRITE tools (download_media, download_stories, export_data) lack confirmation/dry-run patterns. Pagination parameters exist but no documentation of return structure, total counts, or next_cursor. Security concern: no mention of rate limiting or Instagram API credential handling.
Download media (posts, reels, carousel images) to a local directory
Download all active stories for a user to a local directory
Export followers, following, or media data to a file (CSV, JSON, or YAML)
Get comments on a specific media post
Calculate engagement metrics (engagement rate, avg likes, avg comments) for a user
Get the list of followers for an Instagram user
No output schemas documented. LLMs cannot infer what fields are returned, breaking tool chaining and forcing discovery detours. E.g., get_user_info returns what? (user_id, username, follower_count, bio, is_verified, etc.?). Without this, agents cannot plan multi-step workflows.
Pagination parameters (limit) present but no documentation of return structure. Do list tools return total_count, next_cursor, or has_more? How does pagination work? Agents cannot safely iterate large result sets.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | <=2025-11-25 | v2 |
Get the list of accounts a user is following
Get a list of media posts (photos, videos, reels) for a user
Get detailed information about a specific media post including caption, hashtags, tagged users, location
Find mutual connections (accounts both users follow) between two users
Get active stories for a user
Get detailed profile information for an Instagram user including follower count, bio, verification status, etc.
Search for hashtags by query
Search for locations by query
Search for Instagram users by query
WRITE tools (download_media, download_stories, export_data) lack confirmation/dry-run patterns. Agents can accidentally download/export large datasets or overwrite files without user consent. No error guidance on permission failures or disk space issues.
Parameter descriptions lack format/constraint guidance. E.g., 'Instagram username', is it case-sensitive? Does it accept '@' prefix? What's the max length? 'media_id', what format? Numeric, alphanumeric, UUID? LLMs guess and fail.
No error handling guidance. What happens if a user is private? If a media post is deleted? If rate limits are hit? Agents receive raw errors with no recovery path. No actionable error messages.