instagram-skill

分类: 工具与效率 | 上传者: supreme-gg-gg | 下载: 0 | 版本: v1.0（最新）

如何使用 Instagram CLI 代表用户从命令行与 Instagram 进行交互。每当用户想要发送或阅读 Instagram 消息、检查收件箱、回复或取消发送消息或通过 CLI 自动执行任何 Instagram DM 工作流程时，请使用此技能。这包括“在 Instagram 上发送 X 消息”、“检查我的 Instagram 私信”、“向我的朋友发送照片”、“阅读我未读的 Instagram 帖子”等任务，或涉及 Instagram 直接消息的任何自动化/脚本。 --- # Instagram CLI — 代理使用指南 Instagram CLI (`instagram-cli`) 是 Instagram 的终端客户端。对于代理，它公开了打印到标准输出并退出的**单轮命令**，非常适合脚本编写和工具使用。 > 所有一回合命令都要求用户已经登录（`instagram-cli auth login`）。 > 如果命令返回身份验证错误，则提示用户首先登录。请勿尝试自行使用 CLI 登录。 --- ## 线程解析每个针对线程的命令都接受按以下顺序解析的 `<thread>` 参数： 1. **线程 ID**（20+ 位数字，如 `340282366920938463...`） — 直接，零额外 API 调用 2. **用户名** — 准确的 Instagram 用户名（例如 `johndoe`） 3. **线程标题** — 跨收件箱的模糊搜索（例如 `"Book Club"`) **多步骤工作流程的最佳实践：** 首先调用 `inbox --output json` 来获取线程 ID，然后将这些 ID 直接传递给后续命令。这避免了冗余的搜索 API 调用，并且比用户名/标题匹配更可靠。 --- ## JSON 输出所有命令都接受 `-o json` / `--output json`。响应遵循以下信封： ```json { "ok": true, "data": { ... } } { "ok": false, "error": "message" } ``` 当您需要以编程方式解析结果时，请始终使用 `--output json`。 --- ## 命令 ### 列出收件箱 ```bash instagram-cli 收件箱 [--limit <n>] [--output json] ``` 返回最近的线程。每个线程包括：`id`、`title`、`users`、`lastMessage`、`lastActivity`、`unread`。 ```bash # 获取 10 个最近的线程

更新日志: Source: GitHub https://github.com/supreme-gg-gg/instagram-cli

目录结构

当前层级: tree/main/skills/instagram-skill/

📄 SKILL.md 5.3 KB

SKILL.md

---
name: instagram-skill
description: >
  How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.
  Use this skill whenever the user wants to send or read Instagram messages, check their inbox,
  reply to or unsend messages, or automate any Instagram DM workflow via the CLI. This includes
  tasks phrased as "message X on Instagram", "check my Instagram DMs", "send a photo to my friend",
  "read my unread Instagram threads", or any automation / scripting involving Instagram direct messages.
---

# Instagram CLI — Agent Usage Guide

Instagram CLI (`instagram-cli`) is a terminal client for Instagram. For agents, it exposes
**one-turn commands** that print to stdout and exit — perfect for scripting and tool-use.

> All one-turn commands require the user to already be logged in (`instagram-cli auth login`).
> If a command returns an auth error, prompt the user to log in first. Do not attempt to login using the CLI by yourself.

---

## Thread Resolution

Every command that targets a thread accepts a `<thread>` argument resolved in this order:

1. **Thread ID** (20+ digit number like `340282366920938463...`) — direct, zero extra API calls
2. **Username** — exact Instagram username (e.g. `johndoe`)
3. **Thread title** — fuzzy search across inbox (e.g. `"Book Club"`)

**Best practice for multi-step workflows:** call `inbox --output json` first to get thread IDs,
then pass those IDs directly to subsequent commands. This avoids redundant search API calls and
is more reliable than username/title matching.

---

## JSON Output

All commands accept `-o json` / `--output json`. Responses follow this envelope:

```json
{ "ok": true, "data": { ... } }
{ "ok": false, "error": "message" }
```

Always use `--output json` when you need to parse results programmatically.

---

## Commands

### List inbox

```bash
instagram-cli inbox [--limit <n>] [--output json]
```

Returns recent threads. Each thread includes: `id`, `title`, `users`, `lastMessage`, `lastActivity`, `unread`.

```bash
# Get 10 most recent threads as JSON
instagram-cli inbox --limit 10 --output json
```

### Search threads

```bash
instagram-cli inbox --search <query> [--limit <n>] [--output json]
```

Searches by both username and thread title, merging results by relevance score.

```bash
instagram-cli inbox --search "alice" --output json
```

### Send a message

```bash
instagram-cli send <thread> --text <message> [--output json]
instagram-cli send <thread> --file <path> [--type photo|video] [--output json]
```

`<thread>` is a thread ID, username, or title. `--text` and `--file` are mutually exclusive.
Media type is auto-detected from extension; use `--type` to override.

```bash
instagram-cli send johndoe --text "Hey, are you free tonight?"
instagram-cli send 340282366920938463123456789 --text "Got it!"
instagram-cli send "Book Club" --file ./photo.jpg --output json
```

### Read messages

```bash
instagram-cli read <thread> [--limit <n>] [--cursor <cursor>] [--mark-seen] [--output json]
```

Returns messages newest-first. Use `cursor` from the previous response to paginate older messages.
Pass `--mark-seen` to mark the thread as read after fetching.

```bash
instagram-cli read johndoe --limit 20 --output json
instagram-cli read 340282366920938463123456789 --mark-seen
```

Each message in JSON output includes: `id`, `itemType`, `text`, `userId`, `username`, `timestamp`, `isOutgoing`.

### Download media from a message

```bash
instagram-cli read <thread> --message-id <id> --download <path> [--output json]
```

Finds the message by ID (paginates up to `--max-pages`, default 10) and saves the media file.
The file extension is automatically inferred if not provided.

```bash
instagram-cli read johndoe --message-id 340282366... --download ./media
```

### Reply to a message

```bash
instagram-cli reply <thread> --message-id <id> --text <text> [--output json]
```

Sends a threaded reply to a specific message.

```bash
instagram-cli reply johndoe --message-id 340282366... --text "Totally agree!"
```

### Unsend a message

```bash
instagram-cli unsend <thread> --message-id <id> [--output json]
```

```bash
instagram-cli unsend johndoe --message-id 340282366...
```

---

## Multi-Account Support

All commands accept `-u <username>` / `--username <username>` to target a specific logged-in account.
Omitting it uses the default account set via `instagram-cli auth switch`.

```bash
instagram-cli inbox -u myworkaccount --output json
instagram-cli send johndoe --text "Hi" -u mypersonalaccount
```

---

## Typical Agent Workflow

```bash
# 1. Get inbox to find the right thread
INBOX=$(instagram-cli inbox --output json --limit 20)
# Parse "id" fields from INBOX to find the target thread

# 2. Read recent messages (use thread ID for speed)
THREAD_ID="340282366920938463..."
instagram-cli read "$THREAD_ID" --limit 10 --output json

# 3. Reply or send
instagram-cli send "$THREAD_ID" --text "On my way!" --output json

# 4. Mark as seen
instagram-cli read "$THREAD_ID" --mark-seen
```

---

## Error Handling

- **Auth errors** → user needs to run `instagram-cli auth login`
- **"No thread found matching"** → the username/title didn't resolve; try `inbox --search` first
- **`"ok": false`** in JSON output → the `error` field contains the reason
- Rate limits / network errors are surfaced as error messages; retry with backoff if needed

登录后下载/点赞/收藏 ❤ 1.8K | ★ 0

instagram-skill

目录结构

SKILL.md

举报内容

提示