gramInstagram CLI for viewing feeds, posts, profiles, and engagement via cookies.
Install via ClawdBot CLI:
clawdbot install arein/gramInstall gram (npm):
Install gram (npm)Requires:
Instagram CLI using REST/GraphQL API + cookie auth.
# npm/pnpm/bun
npm install -g @cyberdrk/gram
# One-shot (no install)
bunx @cyberdrk/gram whoamigram uses cookie-based auth from your Instagram web session.
Use --session-id, --csrf-token, and --ds-user-id to pass cookies directly, or --cookie-source for browser cookies.
Run gram check to see which source is active. For Arc/Brave, use --chrome-profile-dir .
gram whoami # Show logged-in account
gram check # Show credential sources
gram query-ids --refresh # Refresh GraphQL query ID cachegram post <shortcode-or-url> # View a post
gram <shortcode-or-url> # Shorthand for post
gram comments <shortcode> -n 20 # View comments on a post
gram likers <shortcode> # View users who liked a postgram feed -n 20 # Home feed
gram explore -n 20 # Explore/discover feedgram user <username> # View user profile
gram user @instagram --json # JSON output
gram posts <username> -n 20 # User's posts
gram following [username] # Users someone follows (defaults to you)
gram followers [username] # Someone's followers (defaults to you)gram search "query" # Search users, hashtags, places
gram search "coffee" --type users
gram search "nyc" --type places
gram search "#photography" --type hashtagsgram like <shortcode> # Like a post
gram unlike <shortcode> # Unlike a post
gram save <shortcode> # Save/bookmark a post
gram unsave <shortcode> # Unsave a post
gram comment <shortcode> "nice!" # Comment on a post
gram follow <username> # Follow a user
gram unfollow <username> # Unfollow a user--json # JSON output
--json-full # JSON with raw API response in _raw field
--plain # No emoji, no color (script-friendly)
--no-emoji # Disable emoji
--no-color # Disable ANSI colors (or set NO_COLOR=1)--session-id <token> # Instagram sessionid cookie
--csrf-token <token> # Instagram csrftoken cookie
--ds-user-id <id> # Instagram ds_user_id cookie
--cookie-source <source> # Cookie source for browser cookies (repeatable)
--chrome-profile <name> # Chrome profile name
--chrome-profile-dir <path> # Chrome/Chromium profile dir or cookie DB path
--firefox-profile <name> # Firefox profile
--timeout <ms> # Request timeout
--cookie-timeout <ms> # Cookie extraction timeout~/.config/gram/config.json5 (global) or ./.gramrc.json5 (project):
{
cookieSource: ["safari", "chrome"],
chromeProfile: "Profile 1",
timeoutMs: 60000
}Environment variables: GRAM_TIMEOUT_MS, GRAM_COOKIE_TIMEOUT_MS
gram query-ids --refresh--cookie-source--chrome-profile-dir--session-id, --csrf-token, --ds-user-idTL;DR: View feeds, profiles, search, and engage with Instagram via CLI. 📸
Generated Mar 1, 2026
Agency teams use gram to automate Instagram monitoring and engagement for clients. They can fetch feeds, track user interactions, and perform actions like liking or commenting to boost visibility without manual browser work.
Content creators and researchers utilize gram to analyze competitor posts, explore trending hashtags, and gather data on user engagement. The JSON output option facilitates data extraction for further analysis or reporting.
Businesses integrate gram into support workflows to monitor Instagram comments and respond programmatically. This helps manage customer inquiries or feedback on posts efficiently through CLI automation.
Researchers employ gram to collect Instagram data on user behavior, follower networks, or post metrics for studies. The CLI's search and profile commands enable structured data gathering without web scraping complexities.
Influencers use gram to automate routine tasks like checking followers, scheduling likes on relevant posts, or saving content for inspiration. It saves time by handling interactions directly from the command line.
Offer a subscription-based platform that wraps gram's CLI into a user-friendly dashboard with analytics and scheduling features. Agencies pay monthly for enhanced Instagram management tools that reduce manual effort.
Provide curated Instagram data feeds extracted via gram to businesses for market intelligence. Clients access real-time insights on trends, competitors, or audience demographics through API integrations.
Deliver tailored solutions by integrating gram into existing business systems for automation, such as CRM or support platforms. Revenue comes from project-based fees for development, training, and ongoing support.
💬 Integration Tip
Use environment variables like GRAM_TIMEOUT_MS for configuration and leverage the config file for persistent settings to streamline automation scripts.
Fetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it.
Fetch and summarize YouTube video transcripts. Use when asked to summarize, transcribe, or extract content from YouTube videos. Handles transcript fetching via residential IP proxy to bypass YouTube's cloud IP blocks.
Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.
Interact with Twitter/X — read tweets, search, post, like, retweet, and manage your timeline.
LinkedIn automation via browser relay or cookies for messaging, profile viewing, and network actions.
Search YouTube videos, get channel info, fetch video details and transcripts using YouTube Data API v3 via MCP server or yt-dlp fallback.