clinstagram

Automate Instagram actions via CLI with policy-driven backend routing and JSON output.

9|3|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/paperfoot/clinstagram --skill clinstagram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clinstagram
Source: https://github.com/paperfoot/clinstagram/tree/main
Command: npx skills add https://github.com/paperfoot/clinstagram --skill clinstagram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual, browser-based Instagram automation workflow by providing a command-line interface that routes actions to the safest available backend automatically, producing structured JSON output that AI agents can parse.

Core Features & Use Cases

  • Policy-driven backend routing: Automatically selects between Meta Graph API backends and the instagrapi private API based on compliance mode and feature capability.
  • Agent-ready JSON + exit-code contract: Emits consistent machine-readable results and remediation hints so automated systems can recover from failures.
  • Core Instagram automation tasks: Supports posting media, direct messages, story viewing/posting, comments, analytics, followers, user/hashtag lookup, and engagement actions behind a growth safety gate.

Quick Start

Run the clinstagram Skill to check authentication and routing readiness by executing the command: clinstagram --json auth status.

Frequently Asked Questions about clinstagram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Instagram direct messages for AI agents with structured JSON output?

Automating Instagram direct messages for AI agents requires a CLI that routes actions to the safest backend and returns structured JSON. This approach applies policy-driven routing across graph_ig, graph_fb, and private APIs to inspect and reply to messages while emitting machine-readable results.

What is policy-driven backend routing for Instagram automation?

Policy-driven backend routing for Instagram automation is the automatic selection between Meta Graph API and private API backends based on compliance mode and feature capability. It ensures actions like posting media or browsing stories use the safest available endpoint without manual configuration.

How do I safely perform controlled growth actions on Instagram via an API?

Safely performing controlled growth actions on Instagram via an API requires enforcement of growth-action safety gates within the automation CLI. These gates restrict engagement actions behind compliance-mode aware routing to prevent policy violations during follower management.

Can I use Meta Graph API and private Instagram APIs together in one workflow?

Using Meta Graph API and private Instagram APIs together in one workflow is possible through compliance-mode aware backend selection. The CLI automatically routes tasks like posting content or analyzing hashtags to either graph_ig, graph_fb, or the private instagrapi endpoint based on feature support.

Why does my Instagram automation CLI return errors without remediation hints?

Instagram automation CLI errors without remediation hints occur when the tool lacks a standardized exit-code and JSON contract. Implementing an agent-ready JSON response with backend_used plus remediation fields allows automated systems to parse failures and recover gracefully.

How do I check authentication and routing readiness for Instagram automation?

Checking authentication and routing readiness for Instagram automation involves executing a status command that returns JSON. This verifies backend availability across graph_ig, graph_fb, and private APIs while confirming compliance-mode settings before attempting actions like posting media or managing followers.