# @framers/agentos-ext-channel-instagram 中文文档

规范地址：https://npmcn.com/package/%40framers/agentos-ext-channel-instagram/

版本：0\.1\.6
npm 元数据更新时间：2026-11-11T07:53:43.375Z
中文译文更新时间：2026-11-15T12:26:02.375Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40framers/agentos-ext-channel-instagram
原文对照：https://npmcn.com/package/%40framers/agentos-ext-channel-instagram/?lang=original
项目主页：https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/channels/instagram#readme
源码仓库：https://github.com/framerslab/agentos-extensions

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：111 kB，60 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@framers/agentos \>=0\.10\.40
- 首次发布：2026-05-02T11:34:48.255Z
- 最新版本发布：2026-11-11T07:53:42.919Z
- 近 30 天下载量：20257（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

AgentOS的Instagram频道适配器——贴出相片,相片,故事,木马相机,DM,标签研究,并通过Instagram Graph API与浏览器自动化回落进行互动分析.

## 安装

```sh
npm install @framers/agentos-ext-channel-instagram
```

也可以使用：`pnpm add @framers/agentos-ext-channel-instagram`、`yarn add @framers/agentos-ext-channel-instagram`、`bun add @framers/agentos-ext-channel-instagram`

## README

# Instagram 频道

此包通过Instagram Graph API 提供代理媒体发布、评论、标签搜索和接触分析 `axios`。 。 。 .

## 安装

```bash
npm install @framers/agentos-ext-channel-instagram
```

同伴依赖 : `@framers/agentos` `>=0.10.40`。 。 。 .

## 使用量

```ts
import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-channel-instagram',
        options: {
          accessToken: process.env.INSTAGRAM_ACCESS_TOKEN,
          igUserId: process.env.INSTAGRAM_USER_ID,
        },
      },
    ],
  },
});
```

## 配置

| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
| --- | --- | --- | --- | --- |
| `accessToken` | `instagram.accessToken` | `INSTAGRAM_ACCESS_TOKEN` | 是的,显示 | 空字符串 |
| `igUserId` | `instagram.igUserId` | `INSTAGRAM_USER_ID` | 没有 | 无 |
| `secrets` |  |  | 没有 | A. 背景情况 `secrets`,则 `{}` |
|  | `instagram.username` |  | 没有 | 未使用显密 |
|  | `instagram.password` |  | 没有 | 未使用显密 |

选择优先于秘密,然后是环境变量。 选项 `secrets` 优先于上下文 `secrets`。激活时,一个空访问令牌触发了搜索 `FileTokenStore` 页:1 `instagram`; 存储元数据也可以提供 `igUserId`没有 `igUserId`,服务从 `/me`。 。 。 .

## 工具

| 工具 | 它会做什么 |
| --- | --- |
| `instagramPost` | 张贴一张照片或图像 旋转木马的字幕. |
| `instagramReel` | 上传视频为 Instagram Reel . |
| `instagramStory` | 将图像发布为 Instagram 故事 . |
| `instagramDm` | 请求直接消息, 但返回权限错误 . |
| `instagramLike` | 请求类似,但只记录意图. |
| `instagramComment` | 对Instagram的媒体文章发表评论. |
| `instagramFollow` | 请求后续或未后续, 但返回一个不支持的动作错误 . |
| `instagramHashtags` | 搜索标签并检索其顶端媒体. |
| `instagramExplore` | 从认证账户读取最近媒体. |
| `instagramAnalytics` | 阅读邮件或账户业务分析. |

### `instagramPost`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `imageUrls` | 字符串 \[\] | 对 | 用于单个帖子或旋转木马的图像 URL. |
| `caption` | 字符串 | 没有 | 有标签的帖子标题 |

### `instagramReel`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `videoUrl` | 字符串 | 对 | 视频文件的 URL |
| `caption` | 字符串 | 没有 | 带标签的缩写 |
| `coverUrl` | 字符串 | 没有 | 封面图像 URL |

### `instagramStory`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `imageUrl` | 字符串 | 对 | 要作为故事张贴的图像的 URL |

### `instagramDm`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `action` | 字符串, enum : `send` | 对 | 管理部的行动 |
| `recipientId` | 字符串 | 对 | 给消息的Instagram 用户ID |
| `text` | 字符串 | 对 | 信件文本 |

### `instagramLike`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `mediaId` | 字符串 | 对 | 喜欢的Instagram媒体ID |

### `instagramComment`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `mediaId` | 字符串 | 对 | 要评论的 Instagram 媒体 ID |
| `text` | 字符串 | 对 | 注释文本 |

### `instagramFollow`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `userId` | 字符串 | 对 | 要跟随/ 不跟随的Instagram 用户ID |
| `unfollow` | 布尔 | 没有 | 设置为对未跟随; 默认 : `false`。 。 。 . |

### `instagramHashtags`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `hashtag` | 字符串 | 对 | (没有#) |
| `action` | 字符串, enum : `search`, (中文(简体) ), `topMedia` | 没有 | `search` 寻找标签, `topMedia` 获取其顶级位置; 默认 : `search`。 。 。 . |
| `hashtagId` | 字符串 | 没有 | Hashtag ID( 需要为 `topMedia` 行动) |

### `instagramExplore`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `limit` | 编号 | 没有 | 最近要获取的帖子数量 |

### `instagramAnalytics`

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| `scope` | 字符串, enum : `post`, (中文(简体) ), `account` | 没有 | 是否获取后级或账户级分析; 默认 : `account`。 。 。 . |
| `mediaId` | 字符串 | 没有 | 分析的媒体ID(员额范围需要) |

## 频道适配器

适配器注册平台 `instagram` 并初始化认证的图形 API 客户端。 它以文字块作为标题,将图像、木马、相机、故事和视频块映射给媒体出版。 只文本信件失败 。 它存储事件处理器,但没有入境事件传送码. 打字指标无所事事;反应称为只记录方法.

## 页:1

出版并评论给Instagram的写作. 里尔出版民意调查 媒体处理 `3000` 最多为 `60000` 毫秒和抛出失败或超时。 DM和跟随工具返回错误,引导呼叫者到浏览器自动化;这个包不执行倒计时. 类似工具在记录后报告成功,没有API请求.

货单需要访问符,但工厂不会在当地拒绝空符. 激活试图使活字存储倒置,然后初始化服务. 需要客户端的电话在初始化前失败 。 缺失的媒体洞察力作为零值度量衡被退回.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @framers/agentos-ext-channel-instagram 是什么？

AgentOS的Instagram频道适配器——贴出相片,相片,故事,木马相机,DM,标签研究,并通过Instagram Graph API与浏览器自动化回落进行互动分析\.

### 如何安装 @framers/agentos-ext-channel-instagram？

在项目目录运行 npm install @framers/agentos-ext-channel-instagram，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@framers/agentos（\>=0\.10\.40）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @framers/agentos-ext-channel-instagram 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @framers/agentos-ext-channel-instagram 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @framers/agentos-ext-channel-instagram 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @framers/agentos-ext-channel-instagram 可以商用吗？

@framers/agentos-ext-channel-instagram 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @framers/agentos-ext-channel-instagram 的下载量有多少？

根据 npm 官方下载统计，@framers/agentos-ext-channel-instagram 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,257 次，日均约 675 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @framers/agentos-ext-channel-instagram 还在维护吗？

最新版本 0\.1\.6 发布于 2026/11/11（4 天前）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/05/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。