A powerful Instagram CLI for viewing feeds, profiles, and engaging with content directly from your terminal.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gram
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gram using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is gram?
gram is a feature-rich command-line interface designed for seamless interaction with Instagram using REST and GraphQL APIs. By leveraging browser-based cookie authentication, it allows developers and power users to access their feed, search for content, and manage engagement without a graphical interface. This tool is a standout among Openclaw Skills for those who prefer the efficiency of the terminal for social media management and data extraction.
gram Use Cases
- Monitoring Instagram feeds and user profiles directly from the command line.
- Automating engagement actions like liking, following, or commenting via shell scripts.
- Extracting Instagram post and user data in JSON format for analysis or integration into other tools.
- Managing multiple Instagram accounts by specifying different browser profiles or cookie sources.
How gram Works
- The user authenticates by either providing session cookies manually or allowing the tool to extract them from a supported browser like Chrome, Safari, or Firefox.
- Once authenticated, the user issues commands to the CLI to request specific data from Instagram's internal GraphQL and REST APIs.
- The tool processes the responses and formats them into readable terminal output or structured JSON objects.
- Users can perform authenticated engagement actions, such as liking a post or following a user, which are sent directly to Instagram's servers.
gram Setup
Install the package globally using npm, pnpm, or bun:
npm install -g @cyberdrk/gram
Alternatively, run it without installation using bunx:
bunx @cyberdrk/gram whoami
To check your authentication status and active cookie sources, run:
gram check
gram Data Schema & Taxonomy
The skill manages configuration and output using the following structure:
- Configuration Files: Global settings are stored in
~/.config/gram/config.json5, while project-specific settings use.gramrc.json5. - Output Modes:
--json: Provides a clean, structured JSON object of the requested data.--json-full: Includes the raw API response in an_rawfield for debugging.--plain: Removes emojis and ANSI colors, making it ideal for piping into other command-line utilities.
gram Advanced Features
- Support for multiple cookie sources including Arc, Brave, Chrome, Firefox, and Safari.
- Manual session overrides using
--session-id,--csrf-token, and--ds-user-idfor headless environments. - Automatic GraphQL query ID caching and refreshing to prevent 404 errors during API changes.
- Deep search capabilities filtering by users, hashtags, or geographical places.
- Environment variable support for timeout configurations and cookie extraction limits.
SKILL.md
Loading
Related Openclaw Skills
Travel Concierge
An AI-driven CLI tool that extracts direct contact information from travel listings and places autonomous booking calls.
OCD ERP Therapist
A structured AI coaching skill for conducting evidence-based OCD Exposure and Response Prevention therapy with automated monitoring and progress tracking.
S.I.S. - Sovereign Intelligence System
S.I.S. provides equilibrium-native reasoning for OpenClaw assistants, ensuring every operation maintains logical balance and self-validating coherence.
Raspberry Pi CPU Temperature Monitor
A thermal monitoring and alerting system for Raspberry Pi that integrates hardware sensors with Openclaw Skills for real-time notifications.
Onchain CLI
A versatile command-line tool for tracking cross-chain crypto portfolios, exchange balances, and prediction markets integrated with Openclaw Skills.
Onchain CLI
A comprehensive command-line interface for tracking cryptocurrency portfolios, exchange history, and prediction markets across multiple blockchains.
Featured*
