pp-scrape-creators

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scrape Creators — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the

scrape-creators-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install scrape-creators --cli-only

Verify:
```
scrape-creators-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

本技能驱动

scrape-creators-pp-cli

二进制文件。在调用本技能的任何命令之前，必须确认CLI已安装。 如果未安装，请先执行以下步骤：

通过Printing Press安装程序安装：

bash

npx -y @mvanhorn/printing-press install scrape-creators --cli-only

验证：
```
scrape-creators-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等情况），可改用Go直接安装（要求Go 1.23+版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-cli@latest

如果安装后执行

--version

提示“command not found”，说明安装程序未将二进制文件添加到

$PATH

中。请在验证成功前，不要执行技能相关命令。

When to Use This CLI

何时使用此CLI

Use this CLI when an agent needs public social-media data across multiple platforms in one invocation, when you need offline search over previously fetched content, or when you want cross-platform compound queries (presence, ads, trends) that no single API call answers. It's read-only — pair it with a posting tool if you need write capability.

当智能体需要一次性获取跨多个平台的公开社交媒体数据、需要对已抓取内容进行离线搜索，或者需要跨平台复合查询（存在性、广告、趋势）而单一API无法满足时，可使用此CLI。它仅支持只读操作——如果需要写入能力，请搭配发布类工具使用。

When Not to Use This CLI

何时不使用此CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

请勿在需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或修改远程状态的请求中激活此CLI。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.

这些功能是其他同类型API工具所不具备的。

Cross-platform compounding

跨平台复合查询

creator find
— Given a single handle, see which of 11+ platforms the creator is on, with follower counts side-by-side.
When an agent needs a creator's full footprint before writing outreach or analysis, this returns it in one call instead of 11.
bash
```
scrape-creators-pp-cli creator find mrbeast --json
```
trends triangulate
— Snapshot a hashtag or keyword on TikTok, YouTube, Reddit, and Threads in one call to see which platform it's rising fastest on.
Marketers asking 'is this trend cresting on TikTok' can see the answer plus the leading-indicator platform in one command.
bash
```
scrape-creators-pp-cli trends triangulate "AI agents" --json
```
ads search
— Search Facebook, Google, and LinkedIn ad libraries in one query — see every ad a brand is currently running.
Competitive intel without juggling three vendors and three APIs.
bash
```
scrape-creators-pp-cli ads search "Liquid Death" --json
```
ads monitor
— Snapshot a brand's ads on Facebook, Google, and LinkedIn into SQLite; on rerun, diff new ads vs ones that disappeared.
Cron-friendly competitive monitoring without glue code.
bash
```
scrape-creators-pp-cli ads monitor "Liquid Death" --json
```
bio resolve
— Paste any linktree.ee, komi.io, pillar.io, linkbio, or linkme URL and get the unified destination list.
Lead-research tasks that need a creator's full link footprint stop caring which bio service they used.
bash
```
scrape-creators-pp-cli bio resolve https://linktr.ee/mrbeast --json
```

creator find
— 给定一个账号昵称，查看该创作者在11+个平台上的入驻情况，并附带粉丝数量对比。
当智能体需要在撰写推广文案或分析报告前获取创作者的完整足迹时，此命令可一次性返回所有平台数据，无需调用11次单独接口。
bash
```
scrape-creators-pp-cli creator find mrbeast --json
```
trends triangulate
— 一次性获取TikTok、YouTube、Reddit和Threads平台上某个话题标签或关键词的快照，查看该趋势在哪个平台增长最快。
营销人员询问“该趋势是否在TikTok达到顶峰”时，可通过此命令直接获取答案，同时了解哪个平台是领先指标。
bash
```
scrape-creators-pp-cli trends triangulate "AI agents" --json
```
ads search
— 一次查询即可搜索Facebook、Google和LinkedIn的广告库，查看某品牌当前投放的所有广告。
无需同时使用三个供应商的API，即可完成竞品情报收集。
bash
```
scrape-creators-pp-cli ads search "Liquid Death" --json
```
ads monitor
— 将某品牌在Facebook、Google和LinkedIn上的广告快照保存到SQLite数据库；再次运行时，可对比新增广告与已下线广告的差异。
无需额外编写胶水代码，即可通过定时任务实现竞品广告监控。
bash
```
scrape-creators-pp-cli ads monitor "Liquid Death" --json
```
bio resolve
— 输入任意linktree.ee、komi.io、pillar.io、linkbio或linkme链接，即可获取统一的目标链接列表。
在潜在客户研究中，无需关心创作者使用哪种链接服务，即可获取其完整的链接足迹。
bash
```
scrape-creators-pp-cli bio resolve https://linktr.ee/mrbeast --json
```

Local state that compounds

可累积的本地状态

transcripts search
— FTS5-indexed search across all transcripts you've synced — TikTok, YouTube, Instagram, Facebook, and Twitter videos.
Agents doing brand-mention or keyword-monitoring across video content can grep their entire synced corpus offline.
bash
```
scrape-creators-pp-cli transcripts search "affiliate link" --json --select creator,platform,snippet
```
content spikes
— Find videos that performed significantly above a creator's average — the ones that actually went viral.
When asked 'which videos took off,' the agent can answer with statistical confidence instead of guessing.
bash
```
scrape-creators-pp-cli content spikes mrbeast --threshold 2.0 --platform youtube --json
```
creator compare
— Compare two or more creators side-by-side on follower count, engagement rate, posting cadence, and content volume.
Influencer-shortlist work that used to take a spreadsheet now takes one command.
bash
```
scrape-creators-pp-cli creator compare mrbeast pewdiepie --platform youtube --json
```
creator track
— Snapshot a creator's follower count daily across every platform; chart their growth trajectory over time.
Trend lines for momentum decisions (sponsorship, partnership timing).
bash
```
scrape-creators-pp-cli creator track mrbeast --json
```
content cadence
— See when a creator posts — by day of week and hour — across every platform you've synced for them.
Benchmark a competitor's publishing strategy or recommend the right slot for a creator partner.
bash
```
scrape-creators-pp-cli content cadence mrbeast --platform tiktok --json
```
content analyze
— Rank a creator's synced content by engagement rate (not raw likes) so you see their true best performers.
Surfaces over-performers that raw view counts hide.
bash
```
scrape-creators-pp-cli content analyze mrbeast --platform youtube --json
```
trends delta
— Track whether a hashtag is growing or shrinking by comparing video counts across snapshot intervals.
Distinguish a stable hashtag from a rising or dying one in seconds.
bash
```
scrape-creators-pp-cli trends delta "booktok" --days 7 --platform tiktok --json
```

transcripts search
— 对已同步的所有视频字幕（TikTok、YouTube、Instagram、Facebook和Twitter视频）进行FTS5索引搜索。
智能体在进行品牌提及或关键词监控时，可离线检索所有已同步的字幕语料库。
bash
```
scrape-creators-pp-cli transcripts search "affiliate link" --json --select creator,platform,snippet
```
content spikes
— 找出表现显著高于创作者平均水平的视频——即真正走红的爆款内容。
当被问及“哪些视频爆火”时，智能体可基于统计数据给出准确答案，而非猜测。
bash
```
scrape-creators-pp-cli content spikes mrbeast --threshold 2.0 --platform youtube --json
```
creator compare
— 对比两位或多位创作者的粉丝数量、互动率、发布频率和内容体量。
原本需要用电子表格完成的网红筛选工作，现在只需一条命令即可完成。
bash
```
scrape-creators-pp-cli creator compare mrbeast pewdiepie --platform youtube --json
```
creator track
— 每日快照创作者在各平台的粉丝数量，绘制其增长趋势图。
为赞助、合作时机等决策提供趋势数据支持。
bash
```
scrape-creators-pp-cli creator track mrbeast --json
```
content cadence
— 查看创作者的发布时间规律（按星期几和小时统计），涵盖所有已同步的平台数据。
可用于对标竞品的发布策略，或为创作者合作伙伴推荐最佳发布时段。
bash
```
scrape-creators-pp-cli content cadence mrbeast --platform tiktok --json
```
content analyze
— 按互动率（而非原始点赞数）对创作者已同步的内容进行排名，找出其真正的优质内容。
可挖掘出原始浏览量无法体现的高表现内容。
bash
```
scrape-creators-pp-cli content analyze mrbeast --platform youtube --json
```
trends delta
— 通过对比不同快照间隔的视频数量，追踪话题标签的增长或萎缩情况。
可在几秒内区分稳定话题与上升/衰退话题。
bash
```
scrape-creators-pp-cli trends delta "booktok" --days 7 --platform tiktok --json
```

Operator ergonomics

操作便捷性

account budget
— See how fast you're spending API credits and how many days remain at current pace, fused with the API's own usage history.
Catches runaway sync jobs before they exhaust the plan.
bash
```
scrape-creators-pp-cli account budget --json
```

account budget
— 查看API credits的消耗速度，以及按当前速率剩余可用天数，并整合API自身的使用历史数据。
可在同步任务耗尽配额前及时发现并制止。
bash
```
scrape-creators-pp-cli account budget --json
```

Command Reference

命令参考

account — Manage account

```
scrape-creators-pp-cli account list
```
— Returns the number of API credits remaining on your Scrape Creators account. The response contains a single...
```
scrape-creators-pp-cli account list-getapiusage
```
— Returns a paginated list of your API requests, including the endpoint called, status code, credits used, and...
```
scrape-creators-pp-cli account list-getdailyusagecount
```
— Returns aggregated daily usage statistics for the last 30 days, including total credits consumed and number of...
```
scrape-creators-pp-cli account list-getmostusedroutes
```
— Returns your top 20 most called API endpoints ranked by call count, along with total credits consumed per endpoint....

amazon — Manage amazon

```
scrape-creators-pp-cli amazon
```
— Scrapes a creator's Amazon Shop page by URL, returning their storefront profile and product collections. Returns...

bluesky — Get Bluesky posts and profile info

```
scrape-creators-pp-cli bluesky list
```
— Fetches a single Bluesky post by URL, returning the post's record text, author info, embed content, replyCount,...
```
scrape-creators-pp-cli bluesky list-profile
```
— Retrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount,...
```
scrape-creators-pp-cli bluesky list-user
```
— Fetches a paginated feed of posts from a Bluesky user, returning each post's uri, record text, author info, embed...

detect-age-gender — Manage detect age gender

```
scrape-creators-pp-cli detect-age-gender
```
— Uses AI to analyze a creator's profile photo and estimate their age and gender. Returns ageRange with low and high...

facebook — Get public Facebook profiles and posts

```
scrape-creators-pp-cli facebook list
```
— Retrieves a single public Facebook post or reel by URL. Returns post_id, like_count, comment_count, share_count,...
```
scrape-creators-pp-cli facebook list-adlibrary
```
— Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName,...
```
scrape-creators-pp-cli facebook list-adlibrary-2
```
— Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id,...
```
scrape-creators-pp-cli facebook list-adlibrary-3
```
— Searches the Meta Ad Library by keyword and returns matching ads. Each result includes ad_archive_id, page_name,...
```
scrape-creators-pp-cli facebook list-adlibrary-4
```
— Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library...
```
scrape-creators-pp-cli facebook list-group
```
— Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes...
```
scrape-creators-pp-cli facebook list-post
```
— Fetches comments from a Facebook post or reel with cursor-based pagination. Each comment includes id, text,...
```
scrape-creators-pp-cli facebook list-post-2
```
— Extracts the transcript text from a Facebook video post or reel. Returns the transcript as a single text string with...
```
scrape-creators-pp-cli facebook list-profile
```
— Retrieves public Facebook page details including category, address, email, phone, website, services, priceRange,...
```
scrape-creators-pp-cli facebook list-profile-2
```
— Fetches photos from a public Facebook page with pagination support. Each photo includes photo_id,...
```
scrape-creators-pp-cli facebook list-profile-3
```
— Returns publicly visible Facebook profile posts, limited to 3 posts per page due to API limitations. Each post...
```
scrape-creators-pp-cli facebook list-profile-4
```
— Fetches up to 10 reels per request from a public Facebook page. Each reel includes id, url, view_count, description,...

google — Scrape Google search results

```
scrape-creators-pp-cli google list
```
— Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown,...
```
scrape-creators-pp-cli google list-adlibrary
```
— Searches the Google Ad Transparency Library for advertisers by name. Returns a list of matching advertisers with...
```
scrape-creators-pp-cli google list-company
```
— Fetches public ads for a company from the Google Ad Transparency Library by domain or advertiser_id. Each ad...
```
scrape-creators-pp-cli google list-search
```
— Performs a Google search and returns organic results with url, title, and description for each result. Supports an...

instagram — Gets Instagram profiles, posts, and reels

```
scrape-creators-pp-cli instagram list
```
— Fetches a lightweight Instagram profile summary by user ID, returning username, full name, biography, profile...
```
scrape-creators-pp-cli instagram list-media
```
— Generates an AI-powered speech-to-text transcription for an Instagram video post or reel. The video must be under 2...
```
scrape-creators-pp-cli instagram list-post
```
— Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. Returns caption text, like count,...
```
scrape-creators-pp-cli instagram list-post-2
```
— Retrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp,...
```
scrape-creators-pp-cli instagram list-profile
```
— Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following...
```
scrape-creators-pp-cli instagram list-reels
```
— Searches for Instagram reels matching a keyword or phrase via Google Search, bypassing Instagram's login-gated...
```
scrape-creators-pp-cli instagram list-song
```
— DEPRECATED — this endpoint is no longer functional. Instagram removed the public audio pages that this endpoint...
```
scrape-creators-pp-cli instagram list-user
```
— Returns the raw HTML embed snippet for an Instagram user's profile widget. The response contains a single html...
```
scrape-creators-pp-cli instagram list-user-2
```
— Lists all story highlight albums for an Instagram user. Each highlight includes its ID, title, cover thumbnail URL,...
```
scrape-creators-pp-cli instagram list-user-3
```
— Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode,...
```
scrape-creators-pp-cli instagram list-user-4
```
— Returns a paginated feed of a user's public Instagram posts, including photos, videos, and carousels. Each item...
```
scrape-creators-pp-cli instagram list-user-5
```
— Fetches the full contents of a specific Instagram story highlight album by its ID. Returns the highlight's cover...

kick — Scrape Kick clips

```
scrape-creators-pp-cli kick
```
— Fetches detailed data for a Kick clip by URL, including video, metadata, and channel info. Returns clip id, title,...

komi — Scrape Komi pages

```
scrape-creators-pp-cli komi
```
— Scrapes a Komi page by URL, extracting the creator's profile, social links, and featured content. Returns id,...

linkbio — Scrape Linkbio (lnk.bio) pages

```
scrape-creators-pp-cli linkbio
```
— Scrapes a Linkbio (lnk.bio) page by URL, extracting the creator's profile and all their links. Returns handle, id,...

linkedin — Scrape LinkedIn

```
scrape-creators-pp-cli linkedin list
```
— Retrieves detailed information about a specific LinkedIn ad by URL. Returns id, description, headline, adType,...
```
scrape-creators-pp-cli linkedin list-ads
```
— Searches the LinkedIn Ad Library by company name, keyword, or companyId with optional country and date filters. Each...
```
scrape-creators-pp-cli linkedin list-company
```
— Fetches a LinkedIn company page with details including name, description, logo, cover image, slogan, location,...
```
scrape-creators-pp-cli linkedin list-company-2
```
— Retrieves paginated posts from a LinkedIn company page, including each post's URL, ID, publication date, and full...
```
scrape-creators-pp-cli linkedin list-post
```
— Fetches a single LinkedIn post or article, returning the title, headline, full description text, author info with...
```
scrape-creators-pp-cli linkedin list-profile
```
— Retrieves a person's public LinkedIn profile data, including their name, photo, location, follower count...

linkme — Get Linkme profile info

```
scrape-creators-pp-cli linkme
```
— Retrieves a Linkme profile by URL, including identity, social links, and contact details. Returns profile with id,...

linktree — Scrape Linktree pages

```
scrape-creators-pp-cli linktree
```
— Scrapes a Linktree page by URL, extracting the creator's profile and all their links. Returns id, username,...

pillar — Scrape Pillar pages

```
scrape-creators-pp-cli pillar
```
— Scrapes a Pillar page by URL, extracting the creator's profile, social links, and products. Returns id, first_name,...

pinterest — Scrape Pinterest pins

```
scrape-creators-pp-cli pinterest list
```
— Fetches a paginated list of pins from a Pinterest board by URL, returning each pin's id, description, title, images,...
```
scrape-creators-pp-cli pinterest list-pin
```
— Fetches detailed information about a single Pinterest pin by URL, returning title, description, link, dominantColor,...
```
scrape-creators-pp-cli pinterest list-search
```
— Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link,...
```
scrape-creators-pp-cli pinterest list-user
```
— Fetches a paginated list of boards for a Pinterest user, returning each board's name, url, description, pin_count,...

reddit — Scrape Reddit posts and comments

```
scrape-creators-pp-cli reddit list
```
— Retrieves detailed information about a specific Reddit ad by its id. Returns an analysis_summary with headline and...
```
scrape-creators-pp-cli reddit list-ads
```
— Searches the Reddit Ad Library for ads matching a query, returning a maximum of 30 results. Each ad includes id,...
```
scrape-creators-pp-cli reddit list-post
```
— Retrieves comments and post details from a Reddit post by URL. Returns the post with title, author, score, ups,...
```
scrape-creators-pp-cli reddit list-search
```
— Searches across all of Reddit for posts matching a query. Each post includes title, author, selftext, subreddit,...
```
scrape-creators-pp-cli reddit list-subreddit
```
— Fetches posts from a subreddit with sorting and filtering options. Each post includes title, author, selftext,...
```
scrape-creators-pp-cli reddit list-subreddit-2
```
— Retrieves metadata about a subreddit by name or URL. The subreddit name must be case-sensitive. Returns...
```
scrape-creators-pp-cli reddit list-subreddit-3
```
— Searches within a specific subreddit for posts, comments, and media matching a query. Returns posts with title,...

snapchat — Scrape Snapchat user profiles and thier stories

```
scrape-creators-pp-cli snapchat
```
— Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content. Returns...

threads — Get Threads posts

```
scrape-creators-pp-cli threads list
```
— Fetches a single Threads post by URL, returning the post's caption, like_count, view_counts, reshare_count,...
```
scrape-creators-pp-cli threads list-profile
```
— Retrieves a Threads user's public profile including username, full_name, biography, profile_pic_url, follower_count,...
```
scrape-creators-pp-cli threads list-search
```
— Searches Threads for posts matching a keyword, returning up to 10 results with caption text, like_count,...
```
scrape-creators-pp-cli threads list-search-2
```
— Searches for Threads users by username, returning matching profiles with username, full_name, profile_pic_url,...
```
scrape-creators-pp-cli threads list-user
```
— Fetches the most recent posts from a Threads user, returning id, caption text, code, like_count, reshare_count,...

tiktok — Scrape TikTok profiles, videos, and more

```
scrape-creators-pp-cli tiktok list
```
— Fetches TikTok's trending/For You feed for a given region — useful for discovering viral content and what's...
```
scrape-creators-pp-cli tiktok list-creators
```
— Discovers trending and popular TikTok creators, filterable by follower count range, creator country, and audience...
```
scrape-creators-pp-cli tiktok list-hashtags
```
— Discovers trending and popular TikTok hashtags, filterable by time period (7/30/120 days) and country. Returns a...
```
scrape-creators-pp-cli tiktok list-product
```
— Fetches full details for a specific TikTok Shop product by its URL, including stock levels and affiliate videos....
```
scrape-creators-pp-cli tiktok list-profile
```
— Fetches public profile data for a TikTok user by their handle — useful for looking up a creator's identity, bio,...
```
scrape-creators-pp-cli tiktok list-profile-2
```
— Fetches videos posted by a TikTok user, sortable by latest or most popular — use this to get a creator's video...
```
scrape-creators-pp-cli tiktok list-search
```
— Searches for TikTok videos under a specific hashtag — useful for finding content by topic or trend. Returns...
```
scrape-creators-pp-cli tiktok list-search-2
```
— Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. Returns...
```
scrape-creators-pp-cli tiktok list-search-3
```
— Searches TikTok's 'Top' results by query — returns both videos and photo carousels, unlike keyword search which...
```
scrape-creators-pp-cli tiktok list-search-4
```
— Searches for TikTok users by keyword or name — useful for finding creators or accounts matching a query. Returns...
```
scrape-creators-pp-cli tiktok list-shop
```
— Lists all products from a specific TikTok Shop store by its URL. Returns an array of product objects each with...
```
scrape-creators-pp-cli tiktok list-shop-2
```
— Searches TikTok Shop for products matching a keyword query. Returns an array of product objects each with
```
title
```
,...
```
scrape-creators-pp-cli tiktok list-shop-3
```
— Fetches customer reviews for a TikTok Shop product by URL or product_id. Returns
```
product_reviews
```
, an array of...
```
scrape-creators-pp-cli tiktok list-song
```
— Fetches detailed metadata for a specific TikTok sound or song by its clipId. Returns
```
music_info
```
with
```
title
```
,...
```
scrape-creators-pp-cli tiktok list-song-2
```
— Fetches TikTok videos that use a specific sound or song, identified by its clipId. Returns
```
aweme_list
```
, an array of...
```
scrape-creators-pp-cli tiktok list-user
```
— Retrieves audience demographic data for a TikTok user, showing where their followers are located by country. Returns...
```
scrape-creators-pp-cli tiktok list-user-2
```
— Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or...
```
scrape-creators-pp-cli tiktok list-user-3
```
— Retrieves the following list — accounts that a TikTok user follows — by their handle. Returns
```
followings
```
, an...
```
scrape-creators-pp-cli tiktok list-user-4
```
— Checks if a TikTok user is currently live streaming and retrieves their live room details. Returns...
```
scrape-creators-pp-cli tiktok list-user-5
```
— Fetches products featured in a TikTok user's public showcase — the products a creator promotes on their profile....
```
scrape-creators-pp-cli tiktok list-video
```
— Fetches detailed data for a single TikTok video by URL, including its metadata, engagement stats, and optionally its...
```
scrape-creators-pp-cli tiktok list-video-2
```
— Fetches comments on a TikTok video by URL — useful for reading audience reactions, replies, and engagement....
```
scrape-creators-pp-cli tiktok list-video-3
```
— Extracts the transcript, captions, or subtitles from a TikTok video by URL. Returns
```
id
```
,
```
url
```
, and
```
transcript
```
as...
```
scrape-creators-pp-cli tiktok list-video-4
```
— Fetches replies to a specific TikTok comment by its ID. Returns
```
comments
```
, an array of comment objects each with...

truthsocial — Manage truthsocial

```
scrape-creators-pp-cli truthsocial list
```
— Fetches a single Truth Social post by URL, returning text, id, created_at, url, content, account details,...
```
scrape-creators-pp-cli truthsocial list-profile
```
— Retrieves a Truth Social user's public profile including display_name, username, avatar, header, followers_count,...
```
scrape-creators-pp-cli truthsocial list-user
```
— Fetches a paginated list of posts from a Truth Social user, returning text, id, created_at, url, content, account...

twitch — Scrape Twitch clips

```
scrape-creators-pp-cli twitch list
```
— Fetches detailed data for a Twitch clip by URL, including metadata and direct video URLs. Returns clip id, slug,...
```
scrape-creators-pp-cli twitch list-profile
```
— Retrieves a Twitch user's public profile by handle, including identity, social links, and content. Returns id,...
```
scrape-creators-pp-cli twitch list-user
```
— Fetches a list of videos (100 max) for a Twitch user, returning each video's id, slug, url, embedURL, title,...

twitter — Get Twitter profiles, tweets, followers and more

```
scrape-creators-pp-cli twitter list
```
— Retrieves details about a Twitter/X Community by URL. Returns the community name, description, rest_id, join_policy,...
```
scrape-creators-pp-cli twitter list-community
```
— Fetches tweets posted within a Twitter/X Community by URL. Returns an array of tweets, each with id, full_text,...
```
scrape-creators-pp-cli twitter list-profile
```
— Retrieves a Twitter user's profile by handle, including account metadata and statistics. Returns name, screen_name,...
```
scrape-creators-pp-cli twitter list-tweet
```
— Retrieves detailed information about a specific tweet by URL, including the author's profile and engagement metrics....
```
scrape-creators-pp-cli twitter list-tweet-2
```
— Extracts the transcript from a Twitter video tweet using AI-powered transcription. The video must be under 2 minutes...
```
scrape-creators-pp-cli twitter list-usertweets
```
— Fetches tweets from a Twitter user's profile by handle. Note: Twitter publicly returns only ~100 of the user's most...

youtube — Scrape YouTube channels, videos, and more

```
scrape-creators-pp-cli youtube list
```
— Retrieves comprehensive YouTube channel profile data including name, avatar images, subscriber count (subscribers),...
```
scrape-creators-pp-cli youtube list-channel
```
— Retrieves a paginated list of short-form videos (Shorts) from a YouTube channel, including each short's title, URL,...
```
scrape-creators-pp-cli youtube list-channelvideos
```
— Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view...
```
scrape-creators-pp-cli youtube list-communitypost
```
— Retrieves the full details of a YouTube community post, including its text content, attached images, like count,...
```
scrape-creators-pp-cli youtube list-playlist
```
— Retrieves all videos in a YouTube playlist, including the playlist title, owner info, total video count, and each...
```
scrape-creators-pp-cli youtube list-search
```
— Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live...
```
scrape-creators-pp-cli youtube list-search-2
```
— Searches YouTube for content matching a specific hashtag and returns matching videos with title, URL, thumbnail,...
```
scrape-creators-pp-cli youtube list-shorts
```
— Fetches approximately 48 currently trending YouTube Shorts (viral/popular short-form videos) per call, returning...
```
scrape-creators-pp-cli youtube list-video
```
— Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like...
```
scrape-creators-pp-cli youtube list-video-2
```
— Fetches comments and replies from a YouTube video, including each comment's text content, author details, like...
```
scrape-creators-pp-cli youtube list-video-3
```
— Retrieves the captions, subtitles, or transcript of a YouTube video or short. Returns both a timestamped transcript...
```
scrape-creators-pp-cli youtube list-video-4
```
— Fetches replies to a specific comment on a YouTube video, including each reply's text content, author details (name,...

account — 账号管理

```
scrape-creators-pp-cli account list
```
— 返回Scrape Creators账号剩余的API credits数量。响应包含一个...
```
scrape-creators-pp-cli account list-getapiusage
```
— 返回分页的API请求列表，包含调用的端点、状态码、消耗的credits等信息...
```
scrape-creators-pp-cli account list-getdailyusagecount
```
— 返回过去30天的每日使用统计聚合数据，包括总消耗credits和请求数量...
```
scrape-creators-pp-cli account list-getmostusedroutes
```
— 返回调用次数最多的前20个API端点，按调用次数排序，并附带每个端点的总消耗credits...

amazon — Amazon相关操作

```
scrape-creators-pp-cli amazon
```
— 通过URL抓取创作者的Amazon Shop页面，返回其店铺资料和产品集合。返回...

bluesky — 获取Bluesky帖子和资料信息

```
scrape-creators-pp-cli bluesky list
```
— 通过URL抓取单条Bluesky帖子，返回帖子文本、作者信息、嵌入内容、回复数...
```
scrape-creators-pp-cli bluesky list-profile
```
— 获取Bluesky用户的公开资料，包括账号昵称、显示名称、头像、简介、粉丝数...
```
scrape-creators-pp-cli bluesky list-user
```
— 获取Bluesky用户的分页帖子流，返回每条帖子的uri、文本、作者信息、嵌入内容...

detect-age-gender — 年龄性别检测

```
scrape-creators-pp-cli detect-age-gender
```
— 使用AI分析创作者的头像照片，估算其年龄和性别。返回包含最低和最高年龄范围的ageRange字段...

facebook — 获取公开Facebook资料和帖子

```
scrape-creators-pp-cli facebook list
```
— 通过URL获取单条公开Facebook帖子或Reel，返回post_id、点赞数、评论数、分享数...
```
scrape-creators-pp-cli facebook list-adlibrary
```
— 通过ID或URL获取特定Facebook广告的详细信息，返回adArchiveID、页面名称...
```
scrape-creators-pp-cli facebook list-adlibrary-2
```
— 从Meta广告库获取某公司当前投放的所有广告，每条广告包含ad_archive_id...
```
scrape-creators-pp-cli facebook list-adlibrary-3
```
— 按关键词搜索Meta广告库，返回匹配的广告，每条结果包含ad_archive_id、页面名称...
```
scrape-creators-pp-cli facebook list-adlibrary-4
```
— 按名称在Meta广告库中搜索公司，返回其页面ID，供其他广告库命令使用...
```
scrape-creators-pp-cli facebook list-group
```
— 获取公开Facebook群组的帖子，受API限制每页最多3条，每条帖子包含...
```
scrape-creators-pp-cli facebook list-post
```
— 通过游标分页获取Facebook帖子或Reel的评论，每条评论包含id、文本...
```
scrape-creators-pp-cli facebook list-post-2
```
— 提取Facebook视频帖子或Reel的字幕文本，返回单个字符串格式的字幕...
```
scrape-creators-pp-cli facebook list-profile
```
— 获取公开Facebook页面的详细信息，包括类别、地址、邮箱、电话、网站、服务、价格范围...
```
scrape-creators-pp-cli facebook list-profile-2
```
— 获取公开Facebook页面的照片，支持分页，每张照片包含photo_id...
```
scrape-creators-pp-cli facebook list-profile-3
```
— 返回公开可见的Facebook资料帖子，受API限制每页最多3条，每条帖子...
```
scrape-creators-pp-cli facebook list-profile-4
```
— 从公开Facebook页面获取最多10条Reel，每条Reel包含id、url、浏览量、简介...

google — 抓取Google搜索结果

```
scrape-creators-pp-cli google list
```
— 获取特定Google广告的详细信息，包括advertiserId、creativeId、格式、首次展示时间...
```
scrape-creators-pp-cli google list-adlibrary
```
— 按名称在Google广告透明度库中搜索广告主，返回匹配的广告主列表...
```
scrape-creators-pp-cli google list-company
```
— 通过域名或advertiser_id从Google广告透明度库获取某公司的公开广告，每条广告...
```
scrape-creators-pp-cli google list-search
```
— 执行Google搜索，返回自然搜索结果，包含每个结果的url、标题和简介，支持...

instagram — 获取Instagram资料、帖子和Reel

```
scrape-creators-pp-cli instagram list
```
— 通过用户ID获取轻量化的Instagram资料摘要，返回用户名、全名、简介、头像...
```
scrape-creators-pp-cli instagram list-media
```
— 为Instagram视频帖子或Reel生成AI语音转文字字幕，视频时长需在2...
```
scrape-creators-pp-cli instagram list-post
```
— 通过短代码或URL获取单条Instagram帖子或Reel的详细元数据，返回标题文本、点赞数...
```
scrape-creators-pp-cli instagram list-post-2
```
— 获取公开Instagram帖子或Reel的评论，每条评论包含文本、创建时间戳...
```
scrape-creators-pp-cli instagram list-profile
```
— 获取全面的公开Instagram资料信息，包括简介、链接、粉丝和关注数...
```
scrape-creators-pp-cli instagram list-reels
```
— 通过Google搜索查找匹配关键词的Instagram Reel，绕过Instagram的登录限制...
```
scrape-creators-pp-cli instagram list-song
```
— 已废弃——此端点不再可用，Instagram移除了该端点依赖的公开音频页面...
```
scrape-creators-pp-cli instagram list-user
```
— 返回Instagram用户资料组件的原始HTML嵌入代码，响应包含单个html字段...
```
scrape-creators-pp-cli instagram list-user-2
```
— 列出Instagram用户的所有故事高光专辑，每个高光包含ID、标题、封面缩略图URL...
```
scrape-creators-pp-cli instagram list-user-3
```
— 返回用户公开Instagram Reel的分页列表（短视频），每个Reel包含短代码...
```
scrape-creators-pp-cli instagram list-user-4
```
— 返回用户公开Instagram帖子的分页流，包括照片、视频和轮播内容，每个条目...
```
scrape-creators-pp-cli instagram list-user-5
```
— 通过ID获取特定Instagram故事高光专辑的完整内容，返回高光的封面...

kick — 抓取Kick片段

```
scrape-creators-pp-cli kick
```
— 通过URL获取Kick片段的详细数据，包括视频、元数据和频道信息，返回片段id、标题...

komi — 抓取Komi页面

```
scrape-creators-pp-cli komi
```
— 通过URL抓取Komi页面，提取创作者的资料、社交链接和特色内容，返回id...

linkbio — 抓取Linkbio (lnk.bio)页面

```
scrape-creators-pp-cli linkbio
```
— 通过URL抓取Linkbio (lnk.bio)页面，提取创作者的资料和所有链接，返回账号昵称、id...

linkedin — 抓取LinkedIn内容

```
scrape-creators-pp-cli linkedin list
```
— 通过URL获取特定LinkedIn广告的详细信息，返回id、简介、标题、广告类型...
```
scrape-creators-pp-cli linkedin list-ads
```
— 按公司名称、关键词或companyId搜索LinkedIn广告库，支持可选的国家和日期筛选，每条...
```
scrape-creators-pp-cli linkedin list-company
```
— 获取LinkedIn公司页面，包含名称、简介、logo、封面图、标语、位置...
```
scrape-creators-pp-cli linkedin list-company-2
```
— 获取LinkedIn公司页面的分页帖子，包含每条帖子的URL、ID、发布日期和完整...
```
scrape-creators-pp-cli linkedin list-post
```
— 获取单条LinkedIn帖子或文章，返回标题、副标题、完整简介文本、作者信息...
```
scrape-creators-pp-cli linkedin list-profile
```
— 获取个人公开LinkedIn资料数据，包括姓名、照片、位置、粉丝数...

linkme — 获取Linkme资料信息

```
scrape-creators-pp-cli linkme
```
— 通过URL获取Linkme资料，包括身份信息、社交链接和联系方式，返回包含id的profile字段...

linktree — 抓取Linktree页面

```
scrape-creators-pp-cli linktree
```
— 通过URL抓取Linktree页面，提取创作者的资料和所有链接，返回id、用户名...

pillar — 抓取Pillar页面

```
scrape-creators-pp-cli pillar
```
— 通过URL抓取Pillar页面，提取创作者的资料、社交链接和产品信息，返回id、名字...

pinterest — 抓取Pinterest图钉

```
scrape-creators-pp-cli pinterest list
```
— 通过URL获取Pinterest画板的分页图钉列表，返回每个图钉的id、简介、标题、图片...
```
scrape-creators-pp-cli pinterest list-pin
```
— 通过URL获取单条Pinterest图钉的详细信息，返回标题、简介、链接、主色调...
```
scrape-creators-pp-cli pinterest list-search
```
— 按查询关键词搜索Pinterest图钉，返回包含id、url、标题、简介、图片、链接的结果...
```
scrape-creators-pp-cli pinterest list-user
```
— 获取Pinterest用户的分页画板列表，返回每个画板的名称、url、简介、图钉数量...

reddit — 抓取Reddit帖子和评论

```
scrape-creators-pp-cli reddit list
```
— 通过id获取特定Reddit广告的详细信息，返回包含标题和内容的analysis_summary字段...
```
scrape-creators-pp-cli reddit list-ads
```
— 按查询关键词搜索Reddit广告库，最多返回30条结果，每条广告包含id...
```
scrape-creators-pp-cli reddit list-post
```
— 通过URL获取Reddit帖子的评论和详情，返回包含标题、作者、评分、点赞数的帖子...
```
scrape-creators-pp-cli reddit list-search
```
— 在整个Reddit平台搜索匹配查询关键词的帖子，每条帖子包含标题、作者、正文、子版块...
```
scrape-creators-pp-cli reddit list-subreddit
```
— 获取子版块的帖子，支持排序和筛选选项，每条帖子包含标题、作者、正文...
```
scrape-creators-pp-cli reddit list-subreddit-2
```
— 通过名称或URL获取子版块的元数据，子版块名称区分大小写，返回...
```
scrape-creators-pp-cli reddit list-subreddit-3
```
— 在特定子版块内搜索匹配查询关键词的帖子、评论和媒体，返回包含标题的帖子...

snapchat — 抓取Snapchat用户资料和故事

```
scrape-creators-pp-cli snapchat
```
— 通过账号昵称获取Snapchat用户的公开资料，包括身份信息、故事和Spotlight内容，返回...

threads — 获取Threads帖子

```
scrape-creators-pp-cli threads list
```
— 通过URL获取单条Threads帖子，返回帖子标题、点赞数、浏览量、转发数...
```
scrape-creators-pp-cli threads list-profile
```
— 获取Threads用户的公开资料，包括用户名、全名、简介、头像URL、粉丝数...
```
scrape-creators-pp-cli threads list-search
```
— 按关键词搜索Threads帖子，最多返回10条结果，包含标题文本、点赞数...
```
scrape-creators-pp-cli threads list-search-2
```
— 按用户名搜索Threads用户，返回匹配的资料，包含用户名、全名、头像URL...
```
scrape-creators-pp-cli threads list-user
```
— 获取Threads用户的最新帖子，返回id、标题文本、代码、点赞数、转发数...

tiktok — 抓取TikTok资料、视频等内容

```
scrape-creators-pp-cli tiktok list
```
— 获取指定地区TikTok的热门/For You Feed，用于发现爆款内容和当前趋势...
```
scrape-creators-pp-cli tiktok list-creators
```
— 发现热门TikTok创作者，可按粉丝数量范围、创作者国家和受众进行筛选...
```
scrape-creators-pp-cli tiktok list-hashtags
```
— 发现热门TikTok话题标签，可按时间段（7/30/120天）和国家筛选，返回...
```
scrape-creators-pp-cli tiktok list-product
```
— 通过URL获取TikTok Shop特定产品的完整详情，包括库存水平和联盟营销视频...
```
scrape-creators-pp-cli tiktok list-profile
```
— 通过账号昵称获取TikTok用户的公开资料数据，用于查找创作者身份、简介...
```
scrape-creators-pp-cli tiktok list-profile-2
```
— 获取TikTok用户发布的视频，可按最新或最热排序，用于获取创作者的视频...
```
scrape-creators-pp-cli tiktok list-search
```
— 按特定话题标签搜索TikTok视频，用于查找特定主题或趋势的内容，返回...
```
scrape-creators-pp-cli tiktok list-search-2
```
— 按关键词或短语搜索TikTok视频，即全平台通用视频搜索，返回...
```
scrape-creators-pp-cli tiktok list-search-3
```
— 按查询关键词搜索TikTok的“热门”结果，返回视频和照片轮播内容，不同于仅返回视频的关键词搜索...
```
scrape-creators-pp-cli tiktok list-search-4
```
— 按关键词或姓名搜索TikTok用户，用于查找匹配查询条件的创作者或账号，返回...
```
scrape-creators-pp-cli tiktok list-shop
```
— 通过URL获取特定TikTok Shop店铺的所有产品，返回包含多个产品对象的数组，每个对象包含...
```
scrape-creators-pp-cli tiktok list-shop-2
```
— 按关键词搜索TikTok Shop产品，返回包含多个产品对象的数组，每个对象包含
```
title
```
...
```
scrape-creators-pp-cli tiktok list-shop-3
```
— 通过URL或product_id获取TikTok Shop产品的客户评论，返回
```
product_reviews
```
字段，即包含...
```
scrape-creators-pp-cli tiktok list-song
```
— 通过clipId获取特定TikTok音效或歌曲的详细元数据，返回包含
```
title
```
的
```
music_info
```
字段...
```
scrape-creators-pp-cli tiktok list-song-2
```
— 通过clipId获取使用特定音效或歌曲的TikTok视频，返回
```
aweme_list
```
字段，即包含...
```
scrape-creators-pp-cli tiktok list-user
```
— 获取TikTok用户的受众人口统计数据，显示其粉丝所在国家分布，返回...
```
scrape-creators-pp-cli tiktok list-user-2
```
— 通过账号昵称或user_id获取TikTok账号的粉丝列表，用于查看创作者的粉丝群体...
```
scrape-creators-pp-cli tiktok list-user-3
```
— 通过账号昵称获取TikTok用户关注的账号列表，返回
```
followings
```
字段，即包含...
```
scrape-creators-pp-cli tiktok list-user-4
```
— 检查TikTok用户是否正在直播，并获取其直播间详情，返回...
```
scrape-creators-pp-cli tiktok list-user-5
```
— 获取TikTok用户公开展示的产品，即创作者在资料中推广的产品...
```
scrape-creators-pp-cli tiktok list-video
```
— 通过URL获取单条TikTok视频的详细数据，包括元数据、互动统计信息，可选返回...
```
scrape-creators-pp-cli tiktok list-video-2
```
— 通过URL获取TikTok视频的评论，用于查看受众反应、回复和互动情况...
```
scrape-creators-pp-cli tiktok list-video-3
```
— 通过URL提取TikTok视频的字幕、标题或副标题，返回
```
id
```
、
```
url
```
和
```
transcript
```
字段...
```
scrape-creators-pp-cli tiktok list-video-4
```
— 通过ID获取特定TikTok评论的回复，返回
```
comments
```
字段，即包含多个评论对象的数组，每个对象包含...

truthsocial — Truth Social相关操作

```
scrape-creators-pp-cli truthsocial list
```
— 通过URL获取单条Truth Social帖子，返回文本、id、创建时间、url、内容、账号详情...
```
scrape-creators-pp-cli truthsocial list-profile
```
— 获取Truth Social用户的公开资料，包括显示名称、用户名、头像、封面图、粉丝数...
```
scrape-creators-pp-cli truthsocial list-user
```
— 获取Truth Social用户的分页帖子列表，返回文本、id、创建时间、url、内容、账号...

twitch — 抓取Twitch片段

```
scrape-creators-pp-cli twitch list
```
— 通过URL获取Twitch片段的详细数据，包括元数据和直接视频URL，返回片段id、slug...
```
scrape-creators-pp-cli twitch list-profile
```
— 通过账号昵称获取Twitch用户的公开资料，包括身份信息、社交链接和内容，返回id...
```
scrape-creators-pp-cli twitch list-user
```
— 获取Twitch用户的视频列表（最多100条），返回每个视频的id、slug、url、嵌入URL、标题...

twitter — 获取Twitter资料、推文、粉丝等内容

```
scrape-creators-pp-cli twitter list
```
— 通过URL获取Twitter/X社区的详情，返回社区名称、简介、rest_id、加入政策...
```
scrape-creators-pp-cli twitter list-community
```
— 通过URL获取Twitter/X社区内发布的推文，返回包含多个推文的数组，每个推文包含id、全文...
```
scrape-creators-pp-cli twitter list-profile
```
— 通过账号昵称获取Twitter用户的资料，包括账号元数据和统计信息，返回姓名、用户名...
```
scrape-creators-pp-cli twitter list-tweet
```
— 通过URL获取特定推文的详细信息，包括作者资料和互动指标...
```
scrape-creators-pp-cli twitter list-tweet-2
```
— 使用AI语音转文字提取Twitter视频推文的字幕，视频时长需在2分钟以内...
```
scrape-creators-pp-cli twitter list-usertweets
```
— 通过账号昵称获取Twitter用户资料中的推文，注意：Twitter公开仅返回用户最近约100条推文...

youtube — 抓取YouTube频道、视频等内容

```
scrape-creators-pp-cli youtube list
```
— 获取全面的YouTube频道资料数据，包括名称、头像图片、订阅数（subscribers）...
```
scrape-creators-pp-cli youtube list-channel
```
— 获取YouTube频道的短视频（Shorts）分页列表，包括每个短视频的标题、URL...
```
scrape-creators-pp-cli youtube list-channelvideos
```
— 获取YouTube频道上传的视频分页列表，包括每个视频的标题、URL、缩略图、浏览量...
```
scrape-creators-pp-cli youtube list-communitypost
```
— 获取YouTube社区帖子的完整详情，包括文本内容、附加图片、点赞数...
```
scrape-creators-pp-cli youtube list-playlist
```
— 获取YouTube播放列表中的所有视频，包括播放列表标题、所有者信息、总视频数，以及每个...
```
scrape-creators-pp-cli youtube list-search
```
— 按关键词搜索YouTube，返回匹配的视频、频道、播放列表、短视频、合集和直播...
```
scrape-creators-pp-cli youtube list-search-2
```
— 按特定话题标签搜索YouTube内容，返回匹配的视频，包含标题、URL、缩略图...
```
scrape-creators-pp-cli youtube list-shorts
```
— 每次调用获取约48条当前热门的YouTube Shorts（爆款/流行短视频），返回...
```
scrape-creators-pp-cli youtube list-video
```
— 获取YouTube视频或短视频的完整详情，包括标题、简介、缩略图、浏览量（views）、点赞数...
```
scrape-creators-pp-cli youtube list-video-2
```
— 获取YouTube视频的评论和回复，包括每条评论的文本内容、作者详情、点赞数...
```
scrape-creators-pp-cli youtube list-video-3
```
— 获取YouTube视频或短视频的字幕、副标题或转录文本，返回带时间戳的转录文本...
```
scrape-creators-pp-cli youtube list-video-4
```
— 获取YouTube视频上特定评论的回复，包括每条回复的文本内容、作者详情（姓名...

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:

bash

scrape-creators-pp-cli which "<capability in your own words>"

which

resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当你知道要做什么但不知道对应命令时，可直接询问CLI：

bash

scrape-creators-pp-cli which "<用你自己的话描述功能>"

which

命令会将自然语言的功能查询解析为CLI功能索引中最匹配的命令。退出码

表示至少找到一个匹配项；退出码

表示没有明确匹配项——此时可改用

--help

或缩小查询范围。

Recipes

使用示例

Map a creator's full footprint

映射创作者的完整平台足迹

bash

scrape-creators-pp-cli creator find mrbeast --json --select platform,handle,follower_count

Probes every platform's profile endpoint and returns a presence matrix with follower counts. Useful before writing a brief or outreach email.

bash

scrape-creators-pp-cli creator find mrbeast --json --select platform,handle,follower_count

探测所有平台的资料端点，返回包含粉丝数量的存在矩阵，适合在撰写简报或推广邮件前使用。

Find a creator's viral hits

找出创作者的爆款内容

bash

scrape-creators-pp-cli sync --resources youtube && scrape-creators-pp-cli content spikes mrbeast --threshold 2.0 --platform youtube --json

Sync videos to local SQLite, then return videos whose engagement is more than 2× the creator's average.

bash

scrape-creators-pp-cli sync --resources youtube && scrape-creators-pp-cli content spikes mrbeast --threshold 2.0 --platform youtube --json

将视频同步到本地SQLite数据库，然后返回互动率超过创作者平均水平2倍的视频。

Track a brand's ad campaigns across networks

跨平台追踪品牌广告活动

bash

scrape-creators-pp-cli ads monitor "Liquid Death" --json

Snapshots Facebook + Google + LinkedIn ads into SQLite; rerun on a cron and diff new vs disappeared.

bash

scrape-creators-pp-cli ads monitor "Liquid Death" --json

将Facebook + Google + LinkedIn的广告快照保存到SQLite数据库；通过定时任务重复运行，可对比新增广告与已下线广告的差异。

Triangulate where a trend is rising

定位趋势增长最快的平台

bash

scrape-creators-pp-cli trends triangulate "AI agents" --json --select platform,result_count,delta_pct

Probes TikTok, YouTube, Reddit, and Threads for a topic and returns per-platform velocity. Reads the leading platform when run repeatedly.

bash

scrape-creators-pp-cli trends triangulate "AI agents" --json --select platform,result_count,delta_pct

探测TikTok、YouTube、Reddit和Threads平台上的话题，返回各平台的增长速度。重复运行可了解哪个平台是领先指标。

Grep your transcript corpus

检索字幕语料库

bash

scrape-creators-pp-cli transcripts search "affiliate link" --json --select creator,platform,video_url,snippet

FTS5 over every transcript you've synced, returning the creator/platform/URL/match — useful for brand-safety audits.

bash

scrape-creators-pp-cli transcripts search "affiliate link" --json --select creator,platform,video_url,snippet

对所有已同步的字幕进行FTS5搜索，返回创作者/平台/URL/匹配片段——适合品牌安全审核。

Auth Setup

认证设置

Set SCRAPE_CREATORS_API_KEY (get one at https://scrapecreators.com). One header, no OAuth handshake.

Run

scrape-creators-pp-cli doctor

to verify setup.

设置SCRAPE_CREATORS_API_KEY（可在https://scrapecreators.com获取）。仅需设置一个请求头，无需OAuth握手。

运行

scrape-creators-pp-cli doctor

验证设置是否正确。

Agent Mode

智能体模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
scrape-creators-pp-cli account list --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

在任意命令后添加

--agent

参数，等效于：

--json --compact --no-input --no-color --yes

。

可管道传输 — 标准输出为JSON，错误信息输出到标准错误
可筛选 —
```
--select
```
参数保留指定字段子集，点路径可访问嵌套结构；数组可遍历元素，对于冗长的API响应，此参数可有效缩小上下文范围：
bash
```
scrape-creators-pp-cli account list --agent --select id,name,status
```
可预览 —
```
--dry-run
```
参数显示请求内容但不发送
离线友好 — 同步/搜索命令可在本地SQLite存储可用时优先使用
非交互式 — 从不弹出提示，所有输入均通过参数传递
只读 — 请勿使用此CLI执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息或其他修改远程状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令，会将输出包装在来源信封中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

字段获取数据，

.meta.source

字段表示数据来自实时API还是本地存储。当标准输出为终端时，会在标准错误输出打印人类可读的

N results (live)

摘要；当输出为管道/智能体消费时，标准输出仅返回纯JSON。

Agent Feedback

智能体反馈

When you (or the agent) notice something off about this CLI, record it:

scrape-creators-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
scrape-creators-pp-cli feedback --stdin < notes.txt
scrape-creators-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.scrape-creators-pp-cli/feedback.jsonl

. They are never POSTed unless

SCRAPE_CREATORS_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

SCRAPE_CREATORS_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当你（或智能体）发现此CLI存在问题时，可记录反馈：

scrape-creators-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
scrape-creators-pp-cli feedback --stdin < notes.txt
scrape-creators-pp-cli feedback list --json --limit 10

反馈条目会本地存储在

~/.scrape-creators-pp-cli/feedback.jsonl

中。仅当设置了

SCRAPE_CREATORS_FEEDBACK_ENDPOINT

且传递了

--send

参数或设置

SCRAPE_CREATORS_FEEDBACK_AUTO_SEND=true

时，才会发送反馈。默认行为仅本地存储。

请记录让你感到意外的内容，而非正式的错误报告。简短、具体、一句话即可——这样的反馈才最有价值。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

所有命令均支持

--deliver <sink>

参数，输出会除了标准输出外，还会发送到指定的sink，智能体无需手动管道即可路由命令结果。支持三种sink：

Sink	效果
`stdout`	默认值；仅输出到标准输出
`file:<path>`	原子性地将输出写入 `<path>` （先写入临时文件再重命名）
`webhook:<url>`	将输出体POST到指定URL（当使用 `--compact` 参数时，格式为 `application/json` 或 `application/x-ndjson` ）

不支持的协议会返回结构化错误，并列出支持的类型。Webhook失败时返回非零退出码，并在标准错误输出记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

scrape-creators-pp-cli profile save briefing --json
scrape-creators-pp-cli --profile briefing account list
scrape-creators-pp-cli profile list --json
scrape-creators-pp-cli profile show briefing
scrape-creators-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的参数值，可在多次调用中复用。适合定时智能体每次运行相同命令且使用相同配置的场景——即HeyGen的“Beacon”模式。

scrape-creators-pp-cli profile save briefing --json
scrape-creators-pp-cli --profile briefing account list
scrape-creators-pp-cli profile list --json
scrape-creators-pp-cli profile show briefing
scrape-creators-pp-cli profile delete briefing --yes

显式参数优先级高于配置文件值；配置文件值优先级高于默认值。

agent-context

命令会在

available_profiles

字段下列出所有可用配置文件，智能体可在运行时自动发现。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

代码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
4	需要认证
5	API错误（上游问题）
7	速率限制（请等待后重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
scrape-creators-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
scrape-creators-pp-cli --help
```
输出
以
install
开头 → 以
```
mcp
```
结尾 → MCP安装；否则 → 参考上方的前提条件
其他情况 → 直接使用（添加
```
--agent
```
参数执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP server:

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-mcp@latest

bash

claude mcp add scrape-creators-pp-mcp -- scrape-creators-pp-mcp

Verify:
```
claude mcp list
```

安装MCP服务器：

bash

go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-mcp@latest

在Claude Code中注册：

bash

claude mcp add scrape-creators-pp-mcp -- scrape-creators-pp-mcp

验证：
```
claude mcp list
```

Direct Use

直接使用

Check if installed:
```
which scrape-creators-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

scrape-creators-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
scrape-creators-pp-cli <command> --help
```
.

检查是否已安装：
```
which scrape-creators-pp-cli
```
如果未找到，提供安装选项（参考本文顶部的前提条件）。
将用户查询与上方“独特功能”和“命令参考”中的最佳命令匹配。

添加

--agent

参数执行命令：

bash

scrape-creators-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
scrape-creators-pp-cli <command> --help
```
。