# Send Instagram Content Studio to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "instagram-content-studio",
    "name": "Instagram Content Studio",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/uyeong/instagram-content-studio",
    "canonicalUrl": "https://clawhub.ai/uyeong/instagram-content-studio",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/instagram-content-studio",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=instagram-content-studio",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".env.example.txt",
      "README.md",
      "package-lock.json",
      "package.json",
      "SKILL.md",
      "SPEC.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "instagram-content-studio",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T23:20:30.698Z",
      "expiresAt": "2026-05-06T23:20:30.698Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=instagram-content-studio",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=instagram-content-studio",
        "contentDisposition": "attachment; filename=\"instagram-content-studio-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "instagram-content-studio"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/instagram-content-studio"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/instagram-content-studio",
    "downloadUrl": "https://openagent3.xyz/downloads/instagram-content-studio",
    "agentUrl": "https://openagent3.xyz/skills/instagram-content-studio/agent",
    "manifestUrl": "https://openagent3.xyz/skills/instagram-content-studio/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/instagram-content-studio/agent.md"
  }
}
```
## Documentation

### Instagram API Skill

A skill for managing an Instagram account via the Instagram Graph API. Supports profile viewing, post management, image publishing, video/Reels publishing, and comment operations.

### Prerequisites

A .env file with credentials must be configured.

Required: INSTAGRAM_ACCESS_TOKEN
Recommended (for comment/reply via Facebook Graph): FACEBOOK_USER_ACCESS_TOKEN
Required for FB token refresh: FACEBOOK_APP_ID, FACEBOOK_APP_SECRET


cloudflared must be installed for local image/video posting.
If the user specifies a .env file path, append --env <path> to every command.

Example: node scripts/get-profile.js --env /home/user/.instagram-env


All scripts must be run with this project root as the working directory.

### Available Commands

All commands automatically refresh the token before execution. No manual refresh needed.

### Refresh Token

# Instagram token refresh
node scripts/refresh-token.js

# Facebook user token refresh (for comments/replies flow)
node scripts/refresh-facebook-token.js

Manually refreshes token(s) and returns expiration info.

### View Profile

node scripts/get-profile.js

Returns profile info (name, username, account type, media count).

### List Posts

node scripts/get-posts.js [--limit 10]

Returns the user's post list. Use --limit to set the count (default: 10).

### View Post Detail

node scripts/get-post.js <media-id>

Returns post detail including like count and comment count.

### Publish Image

# Single image (URL)
node scripts/post-image.js --caption "Caption" https://example.com/photo.jpg

# Single image (local file)
node scripts/post-image.js --caption "Caption" ./photos/image.png

# Carousel — multiple images (URL)
node scripts/post-image.js --caption "Caption" https://example.com/a.jpg https://example.com/b.jpg

# Carousel — multiple images (local files)
node scripts/post-image.js --caption "Caption" ./img1.png ./img2.png ./img3.jpg

1 image → single post, 2+ images → automatically posted as carousel (max 10).
Both URLs (http://, https://) and local file paths are supported, but mixing is not allowed.
Supported local file formats: jpg, jpeg, png, gif, webp, heic/heif (HEIC is automatically converted to JPEG).

### Publish Video (Reels)

# Single video (URL)
node scripts/post-video.js --caption "Caption" https://example.com/video.mp4

# Single video (local file)
node scripts/post-video.js --caption "Caption" ./videos/clip.mp4

# With cover image and options
node scripts/post-video.js --caption "Caption" --cover https://example.com/cover.jpg --thumb-offset 5000 --share-to-feed true https://example.com/video.mp4

# Video carousel — multiple videos (URL)
node scripts/post-video.js --caption "Caption" https://example.com/a.mp4 https://example.com/b.mp4

# Video carousel — multiple videos (local files)
node scripts/post-video.js --caption "Caption" ./clip1.mp4 ./clip2.mov

1 video → Reels post, 2+ videos → automatically posted as carousel (max 10).
Both URLs and local file paths are supported, but mixing is not allowed.
Supported formats: mp4, mov (max 100MB per file).
--cover, --thumb-offset, --share-to-feed options are only available for single video posts (not carousels).
Video processing takes longer than images; the script waits up to 10 minutes.

### View Comments

node scripts/get-comments.js <media-id>

Returns comments and replies for a specific post.

### Post Comment

node scripts/post-comment.js <media-id> --text "Comment text"

### Reply to Comment

node scripts/reply-comment.js <comment-id> --text "Reply text"

### Workflow Guidelines

When publishing images or videos, always confirm the caption with the user before executing.
After publishing, report the result ID and permalink to the user (both are included in the output).
Video processing takes longer than images. Inform the user that it may take a few minutes.
When writing comments/replies, confirm the content with the user before executing.
All command outputs are in JSON format.

### Error Handling

If the output contains an error field, an error has occurred. Explain the cause to the user and suggest a resolution.

{ "error": "error message" }

### Token storage

refreshIgToken() and refreshFbToken() overwrite tokens in the .env file in plaintext. Do not commit .env to version control.
Create a dedicated Meta app with minimum required permissions (see below).

### Local file upload

Local image/video posting starts a temporary cloudflared Quick Tunnel to expose files so Instagram servers can download them.
The tunnel is active only during the upload and is shut down immediately after.
Only provide file paths you are comfortable briefly exposing to the internet.

### Minimum required permissions

When creating your Meta app, grant only these permissions:

instagram_business_basic — profile and media read
instagram_content_publish — image/video publishing
instagram_manage_comments — comment read/write
pages_read_engagement — required for comment API via Facebook Graph
pages_show_list — required for page-linked Instagram accounts
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: uyeong
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T23:20:30.698Z
- Expires at: 2026-05-06T23:20:30.698Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/instagram-content-studio)
- [Send to Agent page](https://openagent3.xyz/skills/instagram-content-studio/agent)
- [JSON manifest](https://openagent3.xyz/skills/instagram-content-studio/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/instagram-content-studio/agent.md)
- [Download page](https://openagent3.xyz/downloads/instagram-content-studio)