scrapesocial-instagram

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scrapesocial Instagram

Use this skill for read-only Instagram research and retrieval. Keep it at the job-to-command level: choose the right entry point quickly, prefer lighter responses first, and reuse IDs or cursors returned by earlier commands.

本技能用于只读的Instagram研究与检索。遵循任务到命令的层级：快速选择合适的入口点，优先返回精简响应，并复用之前命令返回的ID或游标。

Prerequisites

前提条件

A Scrape Creators API key is required for this skill. Get one at scrapecreators.com.

使用本技能需要Scrape Creators API密钥。可在scrapecreators.com获取。

Quick Setup

快速设置

Install the CLI once:

bash

npm install -g scrapesocial

Authenticate with

SCRAPECREATORS_API_KEY

, then run commands with

scrapesocial

bash

SCRAPECREATORS_API_KEY=... scrapesocial instagram ...

Useful global flags:

```
--trim
```
for smaller responses when supported.
```
--format jsonl
```
when streaming lists into downstream tools.
```
--credit-limit <n>
```
when you want the CLI to hide or block expensive requests.

只需安装一次CLI：

bash

npm install -g scrapesocial

使用

SCRAPECREATORS_API_KEY

进行认证，然后通过

scrapesocial

运行命令：

bash

SCRAPECREATORS_API_KEY=... scrapesocial instagram ...

实用全局标志：

当支持时，使用
```
--trim
```
获取更精简的响应。
当需要将列表流式传输到下游工具时，使用
```
--format jsonl
```
。
当希望CLI隐藏或阻止高成本请求时，使用
```
--credit-limit <n>
```
。

Quick Start

快速入门

If the task is about an account as a whole, start with
```
instagram profiles get
```
.
If the task is about a creator's regular feed, use
```
instagram posts
```
.
If the task is about one specific post or reel, use
```
instagram posts get
```
.
If the task is about spoken content in a reel or video post, use
```
instagram transcript
```
.
If the task is about finding relevant reels by topic, use
```
instagram reels search
```
.
If the task is about audience response on one post, use
```
instagram comments
```
.
If the task is about a creator's reels library, use
```
instagram reels
```
.
If the task is about story highlights, use
```
instagram highlights
```
, then
```
instagram highlights detail
```
.
If the task is about embeddable markup for a profile, use
```
instagram embed
```
.

如果任务是针对整个账号，从
```
instagram profiles get
```
开始。
如果任务是针对创作者的常规动态，使用
```
instagram posts
```
。
如果任务是针对单个特定帖子或Reel，使用
```
instagram posts get
```
。
如果任务是针对Reel或视频帖子中的语音内容，使用
```
instagram transcript
```
。
如果任务是按主题查找相关Reel，使用
```
instagram reels search
```
。
如果任务是针对单个帖子的受众反馈，使用
```
instagram comments
```
。
如果任务是针对创作者的Reel库，使用
```
instagram reels
```
。
如果任务是针对故事精选，先使用
```
instagram highlights
```
，再使用
```
instagram highlights detail
```
。
如果任务是针对主页的可嵌入标记，使用
```
instagram embed
```
。

Goal-led workflows

目标导向工作流

Goal	When to use this skill	How to start
Lead generation	Use it to qualify known creator or brand accounts, or to turn reel discovery into a shortlist. Pair it with another source for contact details.	Start with `instagram reels search` , then switch to `instagram profiles get` , `instagram posts` , or `instagram reels` for qualification.
Influencer discovery	Use it when the user wants creators discovered or vetted through niche reels, recurring themes, and account quality.	Start with `instagram reels search` , then validate shortlisted handles with `instagram profiles get` , `instagram reels` , and `instagram highlights` .
Brand monitoring	Use it to monitor a known brand or creator account across feed posts, reels, and highlights.	Start with `instagram profiles get` , then branch into `instagram posts` , `instagram reels` , and `instagram highlights` .
Competitor analysis	Use it to compare how multiple brands or creators package their feeds, reels, highlights, and audience response.	Start with `instagram profiles get` for each account, then compare `instagram posts` , `instagram reels` , and `instagram comments` on representative items.
Content analytics	Use it to explain what makes certain posts or reels work, using item detail, comments, and transcripts.	Start with `instagram posts` or `instagram reels` , then drill into standout items with `instagram posts get` , `instagram comments` , and `instagram transcript` .
Trend research	Use it for reel-led topic scouting and validation of emerging creative patterns.	Start with `instagram reels search` , then inspect the best examples with `instagram posts get` .
Audience analysis	Use it for qualitative audience language, FAQs, and objections. It does not provide demographic audience breakdowns.	Start with `instagram comments` on representative posts or reels, then use `instagram profiles get` and `instagram highlights` for context.

Read references/instagram-command-map.md when you need the full command-selection table.

目标	使用本技能的场景	启动方式
线索挖掘	用于筛选已知创作者或品牌账号，或将Reel发现转化为候选名单。需搭配其他渠道获取联系方式。	从 `instagram reels search` 开始，然后切换到 `instagram profiles get` 、 `instagram posts` 或 `instagram reels` 进行筛选。
网红发现	当用户希望通过细分领域Reel、重复主题和账号质量来发现或审核创作者时使用。	从 `instagram reels search` 开始，然后使用 `instagram profiles get` 、 `instagram reels` 和 `instagram highlights` 验证候选账号。
品牌监测	用于监测已知品牌或创作者账号的动态帖子、Reel和精选故事。	从 `instagram profiles get` 开始，再延伸到 `instagram posts` 、 `instagram reels` 和 `instagram highlights` 。
竞品分析	用于对比多个品牌或创作者在动态、Reel、精选故事和受众反馈上的呈现方式。	对每个账号先使用 `instagram profiles get` ，然后对比 `instagram posts` 、 `instagram reels` 和代表性内容的 `instagram comments` 。
内容分析	用于借助内容详情、评论和文稿解释某些帖子或Reel成功的原因。	从 `instagram posts` 或 `instagram reels` 开始，然后针对突出内容使用 `instagram posts get` 、 `instagram comments` 和 `instagram transcript` 进行深入分析。
趋势研究	用于基于Reel的主题探索和新兴创意模式验证。	从 `instagram reels search` 开始，然后使用 `instagram posts get` 查看最佳案例。
受众分析	用于分析受众的语言特征、常见问题和异议。本工具不提供受众人口统计细分数据。	从代表性帖子或Reel的 `instagram comments` 开始，然后使用 `instagram profiles get` 和 `instagram highlights` 获取背景信息。

如需完整的命令选择表，请阅读references/instagram-command-map.md。

Choose the Starting Input

选择起始输入

Prefer a
```
--handle
```
when the user is researching an account and no richer identifier is available yet.
Prefer a
```
--url
```
when the user gives a specific post or reel. This is the cleanest way to inspect one item or fetch its comments or transcript.
Prefer a
```
--user-id
```
only after another command has already returned it. For reels and highlights, this can be faster than resolving by handle again.
Prefer a returned pagination token over restarting the query. Instagram commands use command-specific cursor fields such as
```
next_max_id
```
,
```
max_id
```
, or
```
cursor
```
.
Prefer a returned highlight ID when drilling into a specific highlight after listing highlights.

当用户研究某个账号且尚无更精准标识符时，优先使用
```
--handle
```
。
当用户提供特定帖子或Reel的链接时，优先使用
```
--url
```
。这是查看单个内容或获取其评论/文稿的最简洁方式。
仅在其他命令已返回
```
--user-id
```
后使用该参数。对于Reel和精选故事，这比再次通过handle解析更快。
优先使用返回的分页令牌，而非重启查询。Instagram命令使用特定的游标字段，如
```
next_max_id
```
、
```
max_id
```
或
```
cursor
```
。
在列出精选故事后，如需深入查看特定精选内容，优先使用返回的highlight ID。

Working Pattern

工作模式

Start with the highest-level command that matches the job.
Use
```
--trim
```
on commands that support it when the goal is quick inspection, summarization, or easier downstream processing.
Keep IDs and cursors from the response so follow-up commands do not repeat the same discovery step.
Rerun without
```
--trim
```
only when you need fields that the smaller response may omit.
Switch from handle-based to ID-based commands after the first lookup when the command supports it and the workflow will page repeatedly.

从与任务匹配的最高层级命令开始。
当目标是快速查看、总结或便于下游处理时，在支持的命令上使用
```
--trim
```
。
保留响应中的ID和游标，以便后续命令无需重复执行相同的发现步骤。
仅当需要精简响应可能省略的字段时，才取消
```
--trim
```
重新运行命令。
首次查询后，如果命令支持且工作流需要多次分页，从基于handle的命令切换为基于ID的命令。

Common Flows

常见流程

Audit a creator account

审核创作者账号

Use

instagram profiles get

to understand the account first, then branch:

Use
```
instagram posts
```
for the feed history.
Use
```
instagram reels
```
for short-form video output.
Use
```
instagram highlights
```
for archived stories.
Use
```
instagram embed
```
if the output needs embeddable markup rather than analysis.

先使用

instagram profiles get

了解账号，再分支操作：

使用
```
instagram posts
```
查看动态历史。
使用
```
instagram reels
```
查看短视频内容。
使用
```
instagram highlights
```
查看存档故事。
如果输出需要可嵌入标记而非分析结果，使用
```
instagram embed
```
。

Analyze one post or reel

分析单个帖子或Reel

Use

instagram posts get

when the user has a single Instagram URL and wants metadata or content details. Branch again only if needed:

Use
```
instagram comments
```
to inspect audience reaction.
Use
```
instagram transcript
```
to extract spoken dialogue from video content.

当用户提供单个Instagram链接并需要元数据或内容详情时，使用

instagram posts get

。仅在需要时进一步分支：

使用
```
instagram comments
```
查看受众反应。
使用
```
instagram transcript
```
提取视频内容中的语音对话。

Research a topic on Instagram Reels

在Instagram Reel上研究主题

Use

instagram reels search

for topical discovery, trend scouting, or seed collection. Once a specific reel is interesting, move to

instagram posts get

instagram comments

with the reel URL.

使用

instagram reels search

进行主题发现、趋势探索或种子内容收集。当找到感兴趣的Reel后，使用该Reel的链接调用

instagram posts get

或

instagram comments

。

Command Notes

命令说明

```
instagram profiles basic
```
is a niche follow-up command when you already have a user ID and only need the lighter basic-profile view.
```
instagram highlights detail
```
is not a discovery command. Use it only after
```
instagram highlights
```
returns the highlight ID you want.
```
instagram comments
```
,
```
instagram posts
```
, and
```
instagram reels
```
are pagination-friendly. Keep the returned cursor values for iterative collection.
```
instagram transcript
```
is only useful for media that actually contains speech.
This CLI is for retrieval and analysis, not posting, messaging, liking, or other write actions on Instagram.

```
instagram profiles basic
```
是一个细分的后续命令，仅当你已拥有用户ID且只需要轻量的基础主页视图时使用。
```
instagram highlights detail
```
不是发现类命令。仅在
```
instagram highlights
```
返回你需要的highlight ID后使用。
```
instagram comments
```
、
```
instagram posts
```
和
```
instagram reels
```
支持分页。保留返回的游标值以进行迭代收集。
```
instagram transcript
```
仅对包含语音的媒体内容有用。
本CLI仅用于检索和分析，不支持在Instagram上发布、消息发送、点赞或其他写入操作。

Reference

参考

Read references/instagram-command-map.md for a command-by-command matrix with typical inputs, outcomes, and follow-up moves.

如需包含典型输入、输出和后续操作的逐命令矩阵，请阅读references/instagram-command-map.md。