instagram-poster

# instagram-poster

Post images to Instagram directly from your AI agent — bypasses bot detection with a real residential IP.

## Quick start

```bash
node {baseDir}/scripts/post.js \
  --image ./photo.jpg \
  --caption "Good morning 🌅 #photography" \
  --user YOUR_USERNAME \
  --pass YOUR_PASSWORD
```

Post a WaveSpeed-generated image:

```bash
# 1. Generate image
node /workspace/.agents/skills/wavespeed/scripts/wavespeed.js generate \
  --model flux-schnell --prompt "sunset over mountains" --output /tmp/post.png

# 2. Post to Instagram
node {baseDir}/scripts/post.js \
  --image /tmp/post.png \
  --caption "Golden hour 🏔️ #nature #photography"
```

## Options

| Flag | Env | Description |
|------|-----|-------------|
| `--image` | `IG_IMAGE` | Local file path or HTTPS URL |
| `--caption` | `IG_CAPTION` | Post caption (optional) |
| `--user` | `IG_USERNAME` | Instagram username |
| `--pass` | `IG_PASSWORD` | Instagram password |
| `--session` | `IG_SESSION_PATH` | Cookie session file (default: `~/.openclaw/ig-session.json`) |

## Session caching

On first run, logs in and saves cookies to `~/.openclaw/ig-session.json`.
Subsequent runs reuse the session — no re-login needed.

## Config in openclaw.json

```json5
{
  skills: {
    entries: {
      "instagram-poster": {
        env: {
          IG_USERNAME: "your_username",
          IG_PASSWORD: "your_password"
        }
      }
    }
  }
}
```

## How it works

1. Launches a stealth browser with a **Romanian residential IP** (via human-browser)
2. Logs into Instagram as a real iPhone user — passes all bot checks
3. Uploads your image and submits the caption
4. Saves session cookies so you stay logged in

## Requirements

- [human-browser](https://clawhub.ai/skills/human-browser) skill installed
- Human Browser subscription (residential proxy) → [humanbrowser.dev](https://humanbrowser.dev)
- Instagram account credentials

## Agent usage example

```
User: Post this sunset photo to Instagram with caption "Golden hour...

# 📸 instagram-poster — OpenClaw Skill

> Post to Instagram from your AI agent. One command. Real residential IP. No blocks.

[![ClawHub](https://img.shields.io/badge/ClawHub-instagram--poster-orange)](https://clawhub.ai/skills/instagram-poster)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

---

## What it does

Tell your AI agent (in Telegram, Signal, wherever) to post an image to Instagram.
It generates or downloads the image, logs in with a stealth browser, and posts — all automatically.

```
You:   "Generate a sunset over mountains and post it to Instagram"

Agent: → WaveSpeed generates image
       → Human Browser logs into Instagram (Romanian IP, iPhone fingerprint)
       → Posts with your caption
       → Done ✅
```

---

## Install

```bash
clawhub install instagram-poster
```

Or clone:

```bash
git clone https://github.com/YOUR_USERNAME/instagram-poster
```

---

## Usage

**Post a local image:**
```bash
node scripts/post.js \
  --image ./photo.jpg \
  --caption "Good morning ☀️ #photography" \
  --user your_instagram \
  --pass your_password
```

**Post from URL:**
```bash
node scripts/post.js \
  --image https://example.com/image.jpg \
  --caption "Look at this 👀"
```

**Generate + post (WaveSpeed → Instagram):**
```bash
# Generate
node .agents/skills/wavespeed/scripts/wavespeed.js generate \
  --model flux-schnell \
  --prompt "cinematic sunset over mountains, golden hour" \
  --output /tmp/post.png

# Post
node scripts/post.js \
  --image /tmp/post.png \
  --caption "Golden hour 🏔️ #nature #ai"
```

---

## How it works

Instagram blocks 99% of automation tools because they run on **datacenter IPs**.
This skill uses [Human Browser](https://humanbrowser.dev) to browse from a **real Romanian residential IP** with an **iPhone 15 Pro fingerprint** — indistinguishable from a real user.

```
Your VPS IP  →  Cloudflare/Meta ban  ❌
Romanian residential IP  →  Passes all checks  ✅
```

**Flow:**
1. Downloads/resolves image (URL or...