gram

What This Skill Does

The gram skill provides a comprehensive command-line interface (CLI) for interacting with Instagram's private and public APIs. By leveraging session-based authentication (cookies), it allows users to perform actions as an authenticated user, including fetching home and explore feeds, inspecting detailed post and profile information, searching the platform, and performing engagement tasks like liking, saving, or commenting on posts. It is designed for users who prefer terminal-based workflows or need a lightweight, scriptable way to interface with Instagram data without the overhead of a full browser automation suite.

Installation

The gram tool is distributed via NPM. You can install it globally on your system to access the gram command from any terminal directory.

npm install -g @cyberdrk/gram

Alternatively, for a one-shot execution without permanent installation, you can use bunx to run the latest version directly:

bunx @cyberdrk/gram --help

Use Cases

• Data Scraping & Research: Effortlessly aggregate data from profiles or hashtags to analyze trends or gather information for research projects.
• Automated Workflow Integration: Incorporate Instagram interactions into custom scripts, such as piping output into JSON parsers or automated engagement bots.
• Terminal-First Browsing: View content, check follower lists, or search for tags directly in the terminal without being distracted by the full Instagram web interface.
• Bulk Management: Easily manage saved posts or track engagement metrics across multiple accounts using a consistent CLI command structure.

Example Prompts

1. "Check my home feed and list the last 5 posts from people I follow."
2. "Search for the hashtag #photography and give me the user information for the top results."
3. "Like the most recent post from the username @example and then save it for later reference."

Tips & Limitations

• Authentication: gram relies on active Instagram session cookies. If your session expires, you must refresh the session-id and other tokens manually or via browser integration.
• Safety: Avoid excessive API calls, as Instagram's rate limits are strict and can lead to temporary blocks or account suspension. Always use the --json or --json-full flags when integrating with other scripts to ensure clean data parsing.
• Compatibility: Ensure you point the CLI toward your valid browser cookie paths if the default auto-detection fails. Using --no-color is recommended if you are piping the output into files or other CLI tools for further processing.