instagram-api

name	Instagram API
description	Post to Instagram (Feed, Story, Reels, Carousel) and Threads using the official Meta Graph API. Requires Imgur for media hosting.
version	1.1.0
author	raon
requires_env	["INSTAGRAM_ACCESS_TOKEN","INSTAGRAM_BUSINESS_ACCOUNT_ID","IMGUR_CLIENT_ID"]

instagram-api

Meta Graph API를 사용해 Instagram과 Threads에 직접 포스팅하는 스킬. 미디어 호스팅은 Imgur API를 사용 (이미지/영상 공개 URL 생성).

---

Imgur Client ID 발급

Instagram Graph API는 공개 URL로만 미디어를 업로드할 수 있어 Imgur가 필요합니다.

1. https://api.imgur.com/oauth2/addclient 접속
2. Application name: 원하는 이름 (예: raon-instagram)
3. Authorization type: Anonymous usage without user authorization 선택
4. Authorization callback URL: https://localhost (Anonymous이므로 형식만 맞추면 됨)
5. 이메일 입력 후 제출 → Client ID 확인
6. 환경변수 설정:

   export IMGUR_CLIENT_ID="your_client_id_here"
   

---

환경변수 설정

# ~/.openclaw/.env 또는 ~/.zshrc에 추가
export INSTAGRAM_ACCESS_TOKEN="your_token_here"
export INSTAGRAM_BUSINESS_ACCOUNT_ID="your_account_id_here"

# Threads (선택)
export THREADS_ACCESS_TOKEN="your_threads_token_here"
export THREADS_USER_ID="your_threads_user_id_here"

# Imgur (이미지 호스팅용 — 피드/릴스 업로드 시 필요)
export IMGUR_CLIENT_ID="your_imgur_client_id_here"

---

Meta Graph API 토큰 발급

1. Meta for Developers 접속
2. 앱 생성 → Business 유형 선택
3. Instagram Graph API 제품 추가
4. 권한 요청:
   • instagram_basic
   • instagram_content_publish
   • pages_read_engagement
5. Access Token 발급:
   • Graph API Explorer: https://developers.facebook.com/tools/explorer/
   • 장기 토큰(Long-lived token)으로 교환: 60일 유효
6. Business Account ID 확인:

   curl "https://graph.facebook.com/v21.0/me/accounts?access_token=YOUR_TOKEN"
   

💡 Imgur Client ID: https://api.imgur.com/oauth2/addclient (Anonymous usage 선택)

---

스크립트 사용법

피드 포스팅

bash scripts/post-feed.sh <이미지경로> <캡션파일>

# 예시
bash scripts/post-feed.sh ./photo.jpg ./caption.txt

스토리 포스팅

bash scripts/post-story.sh <이미지경로>

# 예시
bash scripts/post-story.sh ./story.jpg

릴스 포스팅

bash scripts/post-reels.sh <영상경로> <캡션파일>

# 예시
bash scripts/post-reels.sh ./reel.mp4 ./caption.txt

캐러셀 포스팅

bash scripts/post-carousel.sh <캡션파일> <이미지1> <이미지2> [이미지3...]

# 예시
bash scripts/post-carousel.sh ./caption.txt ./img1.jpg ./img2.jpg ./img3.jpg

Threads 포스팅

bash scripts/post-threads.sh <캡션파일> [이미지URL]

# 예시 (텍스트만)
bash scripts/post-threads.sh ./caption.txt

# 예시 (이미지 포함)
bash scripts/post-threads.sh ./caption.txt "https://example.com/image.jpg"

---

파일 구조

instagram-api/
├── SKILL.md                    # 이 파일
└── scripts/
    ├── post-feed.sh            # 피드 포스팅
    ├── post-story.sh           # 스토리 포스팅
    ├── post-reels.sh           # 릴스 포스팅
    ├── post-carousel.sh        # 캐러셀 포스팅
    └── post-threads.sh         # Threads 포스팅

---

주의사항

• Instagram은 공개 URL로만 미디어 업로드 가능 (로컬 파일 직접 업로드 불가)
• 이 스킬은 Imgur를 통해 임시 공개 URL 생성
• 릴스 동영상 처리에는 수분 소요될 수 있음
• API 호출 실패 시 ~/logs/sns/ 로그 확인