pp-scrape-creators

Scrape Creators — Printing Press CLI

前置条件：安装 CLI

此技能通过 scrape-creators-pp-cli 二进制文件运行。调用此技能中的任何命令前，必须确认 CLI 已安装。 如果尚未安装，请先安装：

1. 通过 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

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

2. 验证：scrape-creators-pp-cli --version
3. 确保所报告的安装目录已加入将调用此技能的 Agent/运行时的 $PATH。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接通过 Go 安装（需要 Go 1.26.6 或更高版本）。安装位置为 $GOPATH/bin（默认为 $HOME/go/bin），因此请将该目录加入 $PATH：

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

如果安装后 --version 报告“command not found”，说明运行时无法通过 $PATH 找到二进制文件目录。在验证成功之前，请勿继续执行技能命令。

官方 CLI 会映射端点，官方技能则介绍 curl 工作流；两者都不会在运行之间保留任何信息。此 CLI 会将个人资料、帖子、评论及其回复、文字记录和广告同步到 SQLite，并使用 FTS5 进行搜索；根据积分成本选择评论线程的获取方式（comments thread）；依据实际数据审核回复完整性（comments coverage）；并通过预检积分估算来控制高成本的数据抓取（account estimate）。

何时使用此 CLI

当任务涉及大规模获取公开社交媒体数据时，请使用此 CLI：例如为品牌挖掘评论、在多个平台筛选创作者、监控竞争对手的广告，或搜索已同步的文字记录/评论语料。只要需要考虑积分成本，它就是合适的选择——其线程路由、数据抓取预算和预检估算，都是为了让 Agent 不再盲目消耗积分。

不适用场景

请勿在以下场景使用此 CLI：

• 请勿使用此 CLI 在任何平台上发帖、点赞、关注或发送消息——它仅用于抓取公开数据
• 请勿用于私密内容或仅限登录用户查看的内容；它只能获取公众可见的内容
• 请勿将其用作非社交网站的通用网页抓取工具；请改用爬取工具

独特功能

其他用于此 API 的工具均不具备这些功能。

评论线程完整性

• comments thread — 获取单条帖子的完整评论线程，并自动选择成本较低的方式：15 积分的固定费用 include_replies 调用，或每条评论 1 积分的回复调用（不要依据 child_comment_count 决定：该值并不可靠）。默认只获取顶层评论的第一页；如果还有更多评论，会通过 truncated: true 报告。传入 --max-credits N，即可在积分预算内继续获取后续页面；每次付费调用前都会检查预算（结果封装中的 note 会说明停止获取的原因）。

  当你需要获取某条帖子的所有回复，而不想手动计算积分时，请使用此命令。

  scrape-creators-pp-cli comments thread https://www.instagram.com/reel/C8rKmYvsrck --agent
  scrape-creators-pp-cli comments thread https://www.instagram.com/reel/C8rKmYvsrck --max-credits 60 --agent
  

• comments coverage — 按 API 报告的评论数与实际写入本地存储的评论数之间的差异，对已同步的帖子排序；当 API 的 child_comment_count 不适合作为线程筛选条件时，此功能可提供真实数据。

  完成一轮数据抓取后，可用此命令找出哪些帖子缺少回复，但 API 并未明确提示。

  scrape-creators-pp-cli comments coverage bracken.design --agent
  

• comments sweep — 一条命令即可获取某个账号近期的帖子及其评论，并在达到你设定的积分预算时平稳停止。

  这是一种预算控制的一站式方式，可替代需要处理数百条帖子的评论挖掘流程。

  scrape-creators-pp-cli comments sweep bracken.design --since 7d --max-credits 200 --agent
  

积分管理

• account estimate — 根据当前积分余额，估算计划任务的积分成本；如果任务会耗尽预算，则以非零状态码退出。

  执行任何批量抓取前都应运行此命令，避免 Agent 在工作流中途耗尽积分。

  scrape-creators-pp-cli account estimate --posts 950 --with-replies flat --agent
  

• account budget — 查看 API 积分的消耗速度，以及按当前速度还可维持多少天。

  在承诺启动新的定期工作流前，先检查剩余可用时间。

  scrape-creators-pp-cli account budget --agent
  

跨平台智能

• creator find — 输入一个用户名，即可并排查看该创作者入驻的 12 个创作者平台及其粉丝数。

  在获取各平台详细信息前，先从这里开始评估合作资格。

  scrape-creators-pp-cli creator find mkbhd --agent
  

• creator compare — 并排比较两个或多个创作者的粉丝数、互动率和内容数量。

  剔除虚高的粉丝数，不让它影响合作决策。

  scrape-creators-pp-cli creator compare mkbhd mrwhosetheboss --agent
  

• content spikes — 找出表现远超创作者自身基准的视频，也就是实际走红的视频。

  无需逐条查看数百条帖子，即可找到表现异常的内容。

  scrape-creators-pp-cli content spikes mkbhd --platform youtube
  

• trends triangulate — 一次调用即可查看某个标签或主题在各平台上的快照，了解它在哪个平台最热门。

  在创作内容前决定发布平台。

  scrape-creators-pp-cli trends triangulate "matcha" --agent
  

可持续积累的本地数据

• transcripts search — 使用 FTS5 对你已同步的所有平台文字稿进行全文搜索，涵盖 YouTube、TikTok、Instagram、Facebook、LinkedIn、Rumble 等平台的九种资源类型。

  搜索已付费获取的文字稿，无需再次抓取。

  scrape-creators-pp-cli transcripts search "pricing objection" --limit 10
  

• ads monitor — 获取品牌在 Facebook、TikTok、Google 和 LinkedIn 广告资料库中的在线广告快照；再次运行时，对比新广告和已消失的广告。

  每周重新运行，只查看竞争对手广告活动的变化。

  scrape-creators-pp-cli ads monitor nike --agent
  

• comments search — 离线全文搜索所有已同步的评论和回复。

  无需消耗积分，就能从已抓取的评论中挖掘问题和投诉。

  scrape-creators-pp-cli comments search "refund" --limit 20
  

• creator track — 每次运行时记录指定平台上的粉丝数快照，之后可查看一段时间内的增长趋势。

  按你设定的计划跟踪合作伙伴的增长情况。

  scrape-creators-pp-cli creator track mkbhd --platform instagram
  

• creator tagged — 获取创作者或品牌被标记的帖子快照，再次运行时对比新增提及。

  每周检查客户品牌的 UGC，无需重新浏览完整列表。

  scrape-creators-pp-cli creator tagged bracken.design --agent
  

命令参考

account — 管理账户

• scrape-creators-pp-cli account list — 返回你的 Scrape Creators 账户剩余的 API 积分数。
• scrape-creators-pp-cli account list-getapiusage — 返回分页的 API 请求列表，包括调用的端点、状态码、使用的积分和时间戳。
• scrape-creators-pp-cli account list-getdailyusagecount — 返回最近 30 天的每日使用情况汇总统计
• scrape-creators-pp-cli account list-getmostusedroutes — 按调用次数列出使用最多的 20 个 API 端点，并显示每个端点消耗的积分总数。

amazon — 管理 amazon

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

apple-music — 抓取 Apple Music 艺人、歌曲、专辑和搜索结果

• scrape-creators-pp-cli apple-music list — 获取公开的 Apple Music 专辑详情，包括标题、艺人、封面图、发行信息和曲目
• scrape-creators-pp-cli apple-music list-applemusic — 获取公开的 Apple Music 艺人详情，包括封面图、编辑说明、热门歌曲、专辑和音乐视频
• scrape-creators-pp-cli apple-music list-applemusic-2 — 搜索 Apple Music，并返回艺人、专辑、歌曲、播放列表和电台的公开结果分类
• scrape-creators-pp-cli apple-music list-applemusic-3 — 根据 ID 或 URL 获取公开的 Apple Music 歌曲详情。支持带有 i= 歌曲 ID 的专辑曲目 URL。

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

• scrape-creators-pp-cli bluesky list — 根据 URL 获取单条 Bluesky 帖子，返回帖子的记录文本、作者信息、嵌入内容和 replyCount
• scrape-creators-pp-cli bluesky list-profile — 获取 Bluesky 用户的公开个人资料，包括 handle、displayName、avatar、description 和 followersCount
• scrape-creators-pp-cli bluesky list-user — 分页获取 Bluesky 用户的帖子动态，返回每条帖子的 uri、记录文本和作者信息

detect-age-gender — 管理年龄和性别检测

• scrape-creators-pp-cli detect-age-gender — 使用 AI 分析创作者的个人资料照片，估算其年龄和性别。

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

• scrape-creators-pp-cli facebook create — 从 Meta 广告资料库获取某家公司当前投放的所有广告。
• scrape-creators-pp-cli facebook create-adlibrary — 按关键词搜索 Meta 广告资料库，并返回匹配的广告。
• scrape-creators-pp-cli facebook list — 获取某个城市的活动。请查看此 [链接](https://www.facebook.
• scrape-creators-pp-cli facebook list-adlibrary — 根据 ID 或 URL 获取指定 Facebook 广告的详细信息。
• scrape-creators-pp-cli facebook list-adlibrary-2 — 根据 ID 或 URL 获取单条 Facebook 广告资料库视频广告的文字稿。
• scrape-creators-pp-cli facebook list-adlibrary-3 — 从 Meta 广告资料库获取某家公司当前投放的所有广告。
• scrape-creators-pp-cli facebook list-adlibrary-4 — 按关键词搜索 Meta 广告资料库，并返回匹配的广告。
• scrape-creators-pp-cli facebook list-adlibrary-5 — 在 Meta 广告资料库中按名称搜索公司，并返回可用于其他广告资料库工具的主页 ID
• scrape-creators-pp-cli facebook list-event — 根据 URL 或 ID 获取指定活动
• scrape-creators-pp-cli facebook list-events — 按名称搜索活动。
• scrape-creators-pp-cli facebook list-group — 获取 Facebook 群组“关于”页面上显示的公开信息，包括简介、隐私设置和可见性
• scrape-creators-pp-cli facebook list-group-2 — 获取公开 Facebook 群组的帖子；由于 API 限制，每页最多返回 3 条帖子。
• scrape-creators-pp-cli facebook list-marketplace — 根据商品 ID 或 Marketplace 商品 URL 获取 Facebook Marketplace 商品详情，包括标题、描述和价格
• scrape-creators-pp-cli facebook list-marketplace-2 — 按关键词和经纬度搜索 Facebook Marketplace 商品。支持使用返回的游标进行分页。
• scrape-creators-pp-cli facebook list-marketplace-3 — 搜索 Facebook Marketplace 地点/城市，并返回可用于 Marketplace 搜索端点的坐标。
• scrape-creators-pp-cli facebook list-post — 根据 URL 获取单条公开 Facebook 帖子或短视频。
• scrape-creators-pp-cli facebook list-post-2 — 使用基于游标的分页方式获取 Facebook 帖子或短视频的评论。
• scrape-creators-pp-cli facebook list-post-3 — 提取 Facebook 视频帖子或短视频中的文字稿。
• scrape-creators-pp-cli facebook list-post-4 — 获取某条评论的回复。
• scrape-creators-pp-cli facebook list-profile — 获取 Facebook 公共主页的详细信息，包括类别、地址、电子邮件、电话、网站、服务、priceRange 和 rating
• scrape-creators-pp-cli facebook list-profile-2 — 获取 Facebook 公共主页的活动
• scrape-creators-pp-cli facebook list-profile-3 — 分页获取 Facebook 公共主页的照片。
• scrape-creators-pp-cli facebook list-profile-4 — 返回公开可见的 Facebook 个人资料帖子；由于 API 限制，每页最多返回 3 条帖子。
• scrape-creators-pp-cli facebook list-profile-5 — 每次请求从 Facebook 公共主页获取最多 10 条短视频。

github — 抓取 GitHub 个人资料、代码仓库和公开动态

• scrape-creators-pp-cli github list — 获取一个 GitHub 仓库的公开元数据，包括所有者、描述、语言、星标数、复刻数和主题
• scrape-creators-pp-cli github list-trending — 抓取 GitHub 的公开热门开发者页面。
• scrape-creators-pp-cli github list-trending-2 — 抓取 GitHub 的公开热门仓库页面。
• scrape-creators-pp-cli github list-user — 获取公开的 GitHub 用户详情，包括姓名、简介、头像、公司、所在地、博客和关注者数量
• scrape-creators-pp-cli github list-user-2 — 从公开个人资料的活动时间线获取用户的 GitHub 个人资料贡献活动。
• scrape-creators-pp-cli github list-user-3 — 获取用户和指定年份的公开 GitHub 贡献图
• scrape-creators-pp-cli github list-user-4 — 获取用户的公开 GitHub 关注者。每位关注者都包含登录名、头像、用户 URL、类型和 GitHub ID。
• scrape-creators-pp-cli github list-user-5 — 获取 GitHub 用户关注的公开账号。
• scrape-creators-pp-cli github list-user-6 — 使用 GitHub 的公开搜索索引，搜索用户创建的公开 GitHub 拉取请求。
• scrape-creators-pp-cli github list-user-7 — 获取用户的公开仓库及其元数据，例如描述、语言、星标数、复刻数、主题和许可证

google — 抓取 Google 搜索结果

• scrape-creators-pp-cli google list — 获取特定 Google 广告的详细信息，包括 advertiserId、creativeId、format 和 firstShown
• 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、title 和 description。

instagram — 获取 Instagram 个人资料、帖子和 Reels

• scrape-creators-pp-cli instagram list — 按用户 ID 获取精简版 Instagram 个人资料摘要，返回用户名、全名和个人简介
• scrape-creators-pp-cli instagram list-audio — 获取 Instagram 音频页面（例如 instagram.com/reels/audio/{audio_id}/）展示的 Reels。
• scrape-creators-pp-cli instagram list-media — 为 Instagram 视频帖子或 Reel 生成由 AI 驱动的语音转文字转录。
• 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-post-3 — 获取对特定 Instagram 评论的公开回复。
• scrape-creators-pp-cli instagram list-profile — 获取公开 Instagram 个人资料信息，包括个人简介和简介链接
• scrape-creators-pp-cli instagram list-reels — 从 Instagram 的公开 instagram.com/reels 页面获取热门 Reels。
• scrape-creators-pp-cli instagram list-reels-2 — 仅需获取与关键词或短语匹配的 Google 索引 Instagram Reels 时使用
• scrape-creators-pp-cli instagram list-search — 查找 Instagram 原生账号、话题标签或地点时使用。
• scrape-creators-pp-cli instagram list-search-2 — 已知确切话题标签，且需要获取 Google 索引的公开 Instagram 帖子或 Reels 时使用；可选日期筛选
• scrape-creators-pp-cli instagram list-search-3 — 探索 Instagram 话题及 Instagram 为其精选的帖子时使用。
• scrape-creators-pp-cli instagram list-search-4 — 根据 Google 索引的 Instagram 个人资料页面和简介中的关键词，广泛发掘创作者时使用
• scrape-creators-pp-cli instagram list-user — 返回 Instagram 用户个人资料小组件的原始 HTML 嵌入代码片段。
• scrape-creators-pp-cli instagram list-user-2 — 列出 Instagram 用户的所有快拍精选集。
• scrape-creators-pp-cli instagram list-user-3 — 返回用户公开 Instagram Reels（短视频）的分页列表。
• scrape-creators-pp-cli instagram list-user-4 — 每页最多返回 Instagram 用户“已标记”选项卡中的 10 条公开帖子。
• scrape-creators-pp-cli instagram list-user-5 — 返回用户公开 Instagram 帖子的分页动态，包括 Reels、照片、视频和轮播帖子。
• scrape-creators-pp-cli instagram list-user-6 — 按 ID 获取特定 Instagram 快拍精选集的完整内容。

kick — 抓取 Kick 片段

• scrape-creators-pp-cli kick — 按 URL 获取 Kick 片段的详细数据，包括视频、元数据和频道信息。

komi — 抓取 Komi 页面

• scrape-creators-pp-cli komi — 按 URL 抓取 Komi 页面，提取创作者资料、社交链接和精选内容。

kwai — 抓取 Kwai 个人资料、帖子和用户动态

• scrape-creators-pp-cli kwai list — 获取公开 Kwai 帖子的详细信息，包括说明文字、媒体 URL、封面图片、数量、作者信息和音乐元数据。
• scrape-creators-pp-cli kwai list-profile — 获取公开 Kwai 个人资料数据，包括用户名、个人简介、头像、认证状态、性别和公开数量。
• scrape-creators-pp-cli kwai list-user — 获取用户公开 Kwai 帖子的分页列表，包括说明文字、媒体 URL、封面、数量和作者信息

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

• scrape-creators-pp-cli linkbio — 按 URL 抓取 Linkbio (lnk.bio) 页面，提取创作者资料及其所有链接。

linkedin — 抓取 LinkedIn

• scrape-creators-pp-cli linkedin list — 根据 URL 获取特定 LinkedIn 广告的详细信息。
• scrape-creators-pp-cli linkedin list-ads — 按公司名称、关键词或 companyId 搜索 LinkedIn 广告资料库，并可选按国家和日期筛选。
• scrape-creators-pp-cli linkedin list-company — 获取 LinkedIn 公司主页，包含名称、描述、徽标、封面图片、标语和所在地等详细信息
• 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-post-2 — 当 LinkedIn 公开提供字幕时，获取 LinkedIn 帖子视频的文字稿。
• scrape-creators-pp-cli linkedin list-profile — 获取某人的公开 LinkedIn 个人资料数据，包括姓名、照片、所在地和关注者数量（followers）
• scrape-creators-pp-cli linkedin list-search — 使用 Google Search 按关键词查找公开的 LinkedIn 帖子、动态更新和 Pulse 文章

linkme — 获取 Linkme 个人资料信息

• scrape-creators-pp-cli linkme — 根据 URL 获取 Linkme 个人资料，包括身份信息、社交链接和联系方式。

linktree — 抓取 Linktree 页面

• scrape-creators-pp-cli linktree — 根据 URL 抓取 Linktree 页面，提取创作者的个人资料和所有链接。

pillar — 抓取 Pillar 页面

• scrape-creators-pp-cli pillar — 根据 URL 抓取 Pillar 页面，提取创作者的个人资料、社交链接和产品。

pinterest — 抓取 Pinterest Pin

• scrape-creators-pp-cli pinterest list — 根据 URL 获取 Pinterest 画板中的分页 Pin 列表，并返回每个 Pin 的 ID、描述、标题和图片
• scrape-creators-pp-cli pinterest list-pin — 根据 URL 获取单个 Pinterest Pin 的详细信息，并返回标题、描述、链接和 dominantColor
• scrape-creators-pp-cli pinterest list-search — 搜索 Pinterest 中与查询匹配的 Pin，并返回包含 ID、URL、标题、描述、图片、链接和域名的结果
• scrape-creators-pp-cli pinterest list-user — 获取 Pinterest 用户的分页画板列表，并返回每个画板的名称、URL、描述和 pin_count

reddit — 抓取 Reddit 帖子和评论

• scrape-creators-pp-cli reddit create — 根据 URL 获取 Reddit 帖子的评论和详细信息。
• scrape-creators-pp-cli reddit list — 在整个 Reddit 中搜索与查询匹配的帖子。
• scrape-creators-pp-cli reddit list-post — 根据 URL 获取 Reddit 帖子的评论和详细信息。
• scrape-creators-pp-cli reddit list-post-2 — 当 Reddit 公开提供 VTT 字幕文件时，获取 Reddit 视频帖或直接 v.redd.it URL 的文字稿。
• scrape-creators-pp-cli reddit list-subreddit — 获取 subreddit 中的帖子，并提供排序和筛选选项。
• scrape-creators-pp-cli reddit list-subreddit-2 — 按名称或 URL 获取 subreddit 的元数据。subreddit 名称区分大小写。
• scrape-creators-pp-cli reddit list-subreddit-3 — 在指定 subreddit 中搜索与查询匹配的帖子、评论和媒体内容。

rumble — 抓取 Rumble 搜索结果、视频、文字稿和频道视频

• scrape-creators-pp-cli rumble list — 按关键词搜索 Rumble 视频。
• scrape-creators-pp-cli rumble list-channel — 按用户名或 URL 获取 Rumble 频道的视频。
• scrape-creators-pp-cli rumble list-video — 根据 URL 获取 Rumble 视频的详细信息。
• scrape-creators-pp-cli rumble list-video-2 — 根据 URL 获取 Rumble 视频的所有顶级评论。
• scrape-creators-pp-cli rumble list-video-3 — 当字幕可用时，获取 Rumble 视频的文字稿。

snapchat — 抓取 Snapchat 用户个人资料及其快拍

• scrape-creators-pp-cli snapchat list — 通过用户名获取 Snapchat 用户的公开个人资料，包括身份信息、快拍和 Spotlight 内容。
• scrape-creators-pp-cli snapchat list-spotlight — 通过 URL 获取 Snapchat Spotlight 视频的公开数据。
• scrape-creators-pp-cli snapchat list-spotlight-2 — 通过 URL 从 Snapchat 的 Spotlight 评论 API 获取公开评论。

soundcloud — 抓取 SoundCloud 播放列表和曲目

• scrape-creators-pp-cli soundcloud list — 通过用户名或 URL 获取 SoundCloud 艺术家的详细信息。
• scrape-creators-pp-cli soundcloud list-artist — 通过用户名或 URL 获取 SoundCloud 艺术家的曲目／歌曲。
• scrape-creators-pp-cli soundcloud list-track — 通过 URL 获取 SoundCloud 曲目／歌曲的详细信息。

spotify — 抓取 Spotify 艺术家、歌曲和专辑

• scrape-creators-pp-cli spotify list — 通过 ID 或 URL 获取 Spotify 专辑的详细信息，包括专辑元数据、艺术家和发行日期
• scrape-creators-pp-cli spotify list-artist — 通过用户名获取 Spotify 艺术家的详细信息，包括姓名、粉丝数和流派
• scrape-creators-pp-cli spotify list-podcast — 通过 ID 或 URL 获取 Spotify 播客的详细信息。
• scrape-creators-pp-cli spotify list-podcast-2 — 返回 Spotify 播客的单集。传入响应中返回的游标即可获取下一页。
• scrape-creators-pp-cli spotify list-search — 在 Spotify 中搜索曲目、艺术家、专辑、单集、播客和有声读物。
• scrape-creators-pp-cli spotify list-track — 通过 ID 或 URL 获取 Spotify 曲目的详细信息，包括曲目元数据、艺术家和专辑信息

threads — 获取 Threads 帖子

• scrape-creators-pp-cli threads list — 通过 URL 获取单条 Threads 帖子，返回帖子说明文字、like_count、view_counts 和 reshare_count
• scrape-creators-pp-cli threads list-profile — 获取 Threads 用户的公开个人资料，包括用户名、全名、简介、profile_pic_url 和 follower_count
• scrape-creators-pp-cli threads list-search — 在 Threads 中搜索符合关键词的帖子，最多返回 10 条结果，包括说明文字、like_count 和 reshare_count
• scrape-creators-pp-cli threads list-search-2 — 按用户名搜索 Threads 用户，返回匹配的个人资料，包括用户名、全名和 profile_pic_url
• scrape-creators-pp-cli threads list-user — 获取 Threads 用户最近发布的帖子，返回 id、说明文字、code、like_count 和 reshare_count

tiktok — 抓取 TikTok 个人资料、视频等

• scrape-creators-pp-cli tiktok list — 获取指定地区的 TikTok 热门／For You 信息流，可用于发现热门内容和当前趋势

• scrape-creators-pp-cli tiktok list-adlibrary — 按 ID 或 URL 获取一条 TikTok 广告。首先会检查 Creative Center Top Ads（ads.tiktok.

• scrape-creators-pp-cli tiktok list-adlibrary-2 — 按广告主名称或关键词搜索 TikTok 公共广告库。

• scrape-creators-pp-cli tiktok list-collection — 获取公开 TikTok 收藏集中的视频，TikTok 也将其称为播放列表。传入收藏集 URL。

• scrape-creators-pp-cli tiktok list-creators — 发现热门和受欢迎的 TikTok 创作者，可按粉丝数量范围、创作者所在国家筛选

• scrape-creators-pp-cli tiktok list-live — 使用 TokAPI 的直播信息端点获取 TikTok 直播间的整理后信息。

• scrape-creators-pp-cli tiktok list-product — 按 URL 获取特定美国 TikTok Shop 商品的完整详情，包括库存水平和联盟视频。

• scrape-creators-pp-cli tiktok list-profile — 按 TikTok 用户的账号名或 user_id 获取公开个人资料数据，可用于查询创作者身份

• scrape-creators-pp-cli tiktok list-profile-2 — 返回公开个人资料的 TikTok 地区代码，例如美国为 US，墨西哥为 MX。

• scrape-creators-pp-cli tiktok list-profile-3 — 获取 TikTok 用户发布的视频

• scrape-creators-pp-cli tiktok list-search — 按特定话题标签搜索 TikTok 视频，可用于查找特定主题或趋势的内容。

• scrape-creators-pp-cli tiktok list-search-2 — 按关键词或短语搜索 TikTok 视频，即覆盖整个 TikTok 的通用视频搜索。

• scrape-creators-pp-cli tiktok list-search-3 — 获取用户输入搜索内容时 TikTok 显示的自动补全建议。

• scrape-creators-pp-cli tiktok list-search-4 — 按查询词搜索 TikTok 的“Top”结果，返回视频和照片轮播

• scrape-creators-pp-cli tiktok list-search-5 — 按关键词或名称搜索 TikTok 用户，可用于查找符合查询条件的创作者或账号。

• scrape-creators-pp-cli tiktok list-shop — 按 URL 列出特定 TikTok Shop 店铺的所有商品。

• scrape-creators-pp-cli tiktok list-shop-2 — 在 TikTok Shop 中搜索符合关键词查询的商品。

• scrape-creators-pp-cli tiktok list-shop-3 — 按 URL 或 product_id 获取 TikTok Shop 商品的客户评价。

• scrape-creators-pp-cli tiktok list-song — 按 clipId 获取特定 TikTok 音效或歌曲的详细元数据。

• scrape-creators-pp-cli tiktok list-song-2 — 获取使用特定音效或歌曲的 TikTok 视频，音效或歌曲由 clipId 标识。

• 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 用户关注的账号。

• 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 视频的文字记录、字幕或说明文字。

• scrape-creators-pp-cli tiktok list-video-4 — 按评论 ID 获取特定 TikTok 评论的回复。 truthsocial — 管理 truthsocial

• scrape-creators-pp-cli truthsocial list — 根据 URL 获取单条 Truth Social 帖子，返回文本、id、created_at、url、content 和账号详情

• scrape-creators-pp-cli truthsocial list-profile — 获取 Truth Social 用户的公开个人资料，包括 display_name、username、avatar、header、followers_count

• scrape-creators-pp-cli truthsocial list-user — 分页获取 Truth Social 用户的帖子列表，返回文本、id、created_at、url、content 和账号信息

twitch — 抓取 Twitch 剪辑

• scrape-creators-pp-cli twitch list — 根据 URL 获取 Twitch 剪辑的详细数据，包括元数据和直接视频 URL。
• scrape-creators-pp-cli twitch list-profile — 根据用户名获取 Twitch 用户的公开个人资料，包括身份信息、社交链接和内容。
• scrape-creators-pp-cli twitch list-user — 根据用户名获取用户的日程安排，返回包含开始时间、结束时间、标题和描述的预定活动列表
• scrape-creators-pp-cli twitch list-user-2 — 获取 Twitch 用户的视频列表（最多 100 个），返回每个视频的 id、slug、url、embedURL、title、viewCount

twitter — 获取 Twitter 个人资料、推文、关注者等信息

• scrape-creators-pp-cli twitter list — 根据 URL 获取 Twitter/X 社区的详细信息。
• scrape-creators-pp-cli twitter list-community — 根据 URL 获取 Twitter/X 社区中发布的推文。
• 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 视频推文的文字稿。
• scrape-creators-pp-cli twitter list-usertweets — 根据用户名获取 Twitter 用户个人资料中的推文。

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

• scrape-creators-pp-cli youtube list — 获取 YouTube 频道资料数据，包括名称、头像图片、订阅者数量（订阅者）
• scrape-creators-pp-cli youtube list-channel — 获取 YouTube 频道「帖子」标签页中的社区帖子，包括帖子 ID、URL、内容、图片和附带视频
• scrape-creators-pp-cli youtube list-channel-2 — 获取 YouTube 频道「直播」标签页中的直播和过往直播，包括标题、URL、缩略图、观看次数
• scrape-creators-pp-cli youtube list-channel-3 — 获取 YouTube 频道「播放列表」标签页中的播放列表，包括播放列表 ID、标题、缩略图、视频数量
• scrape-creators-pp-cli youtube list-channel-4 — 分页获取 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 视频或短视频的完整详情，包括标题、说明、缩略图、观看次数（观看数）
• scrape-creators-pp-cli youtube list-video-2 — 获取 YouTube 视频的评论和回复，包括每条评论的文本内容、作者详情、点赞数
• scrape-creators-pp-cli youtube list-video-3 — 实验性端点。
• scrape-creators-pp-cli youtube list-video-4 — 获取 YouTube 视频或 Short 的字幕或文字稿。
• scrape-creators-pp-cli youtube list-video-5 — 获取 YouTube 视频中特定评论的回复，包括每条回复的文本内容、作者详情（名称

查找合适的命令

知道要做什么，但不确定该用哪个命令时，可以直接向 CLI 提问：

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

which 会根据自然语言能力查询，从该 CLI 精选的功能索引中找到最匹配的命令。退出代码 0 表示至少有一个匹配项；退出代码 2 表示没有可信的匹配项——请改用 --help 或尝试更具体的查询。

示例

完整挖掘一条帖子的评论

scrape-creators-pp-cli comments thread <post-url> --agent --select comments.text,comments.replies.text

采用成本感知路由获取所有顶级评论和回复，然后将结果缩减为 Agent 所需的文本字段。

受预算限制的每周扫描

scrape-creators-pp-cli comments sweep <handle> --since 7d --max-credits 200 --agent

获取本周的帖子及其评论，在达到额度预算时正常停止。

花费额度前查找缺口

scrape-creators-pp-cli comments coverage <handle> --agent

按评论串缺失情况为已同步的帖子排序，让回复额度只用于评论串不完整的帖子。

离线挖掘评论

scrape-creators-pp-cli comments search "delivery" --limit 20

对已同步的语料库进行 FTS5 搜索——不消耗额度。

两次调用筛选合作对象

scrape-creators-pp-cli creator find <handle> --agent && scrape-creators-pp-cli creator compare <handle> <rival> --agent

先生成活跃情况矩阵，再比较互动情况以剔除虚荣粉丝。

身份验证设置

运行 scrape-creators-pp-cli auth setup 可显示获取密钥的 URL 和步骤（添加 --launch 可打开 URL）。然后设置：

export SCRAPECREATORS_API_KEY="<your-key>"

要保存凭据，请使用 scrape-creators-pp-cli auth set-token <token>。存储的密钥位于数据目录下的 credentials.toml 中，而不在 config.toml 中。

运行 scrape-creators-pp-cli doctor 验证设置。

Agent 模式

在任意命令后添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可管道传输 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构；数组会逐个遍历元素。在响应内容冗长的 API 中，这对控制上下文大小至关重要：

  scrape-creators-pp-cli account list --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不发送

• 支持离线 — 有本地 SQLite 存储时，同步／搜索命令可以使用它

• 非交互式 — 绝不提示输入，所有输入都通过标志传入

• 明确重试行为 — 仅当已存在的创建结果应视为成功时，才使用 --idempotent

响应封装

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

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

解析 .results 获取数据，并查看 .meta.source 以确定数据来自实时来源还是本地来源。只有当 stdout 是终端，且未设置任何机器格式标志（--json、--csv、--compact、--quiet、--plain、--select）时，才会将易读的 N results (live) 摘要输出到 stderr；管道／Agent 使用者和显式指定格式的运行，都会在 stdout 上获得纯 JSON。

路径和状态

Agent 应将 CLI 的路径解析器视为运行时契约的一部分：

• 使用 --home <dir> 指定单次调用的目录，或设置 SCRAPE_CREATORS_HOME=<dir>，将所有四种路径类型重定位到同一个根目录下。

• 仅在某种路径类型需要单独指定时，才使用对应类型的环境变量：SCRAPE_CREATORS_CONFIG_DIR、SCRAPE_CREATORS_DATA_DIR、SCRAPE_CREATORS_STATE_DIR、SCRAPE_CREATORS_CACHE_DIR。

• 解析顺序为：对应类型的环境变量、--home、SCRAPE_CREATORS_HOME、XDG（XDG_CONFIG_HOME、XDG_DATA_HOME、XDG_STATE_HOME、XDG_CACHE_HOME），然后是平台默认值。

• config 包含 config.toml 和配置档等设置。data 包含 credentials.toml、data.db、Cookie 和身份验证辅助文件。state 包含持久化查询、作业和 teach.log。cache 包含可重新生成的 HTTP／缓存文件。

• 存储的机密信息位于 data 目录下的 credentials.toml 中。为保持兼容，系统会读取现有旧版 config.toml 中的机密信息，并在首次写入身份验证信息时将其从 config.toml 中移出。

• 运行 scrape-creators-pp-cli doctor --fail-on warn，以显示路径和凭据位置警告。对于需要解析后目录的 Agent，agent-context 会提供 schema v4 的 paths 块。

• 对于 MCP，通过 MCP 主机配置传递重定位设置。MCP 二进制文件不会继承 CLI 标志：

  {
    "mcpServers": {
      "scrape-creators": {
        "command": "scrape-creators-pp-mcp",
        "env": {
          "SCRAPE_CREATORS_HOME": "/srv/scrape-creators"
        }
      }
    }
  }
  

集群优先级：继承的对应类型环境变量会覆盖该类型显式指定的 --home。将 SCRAPE_CREATORS_HOME 或对应类型的变量用作持久的集群配置选项；--home 仅用于单次调用。取消设置环境变量无法撤销重定位；清除 SCRAPE_CREATORS_HOME 前请手动移动文件，否则 doctor 将无法找到留在原根目录下的凭据。

自动学习

此 CLI 内置了自动捕获的学习循环。CLI 会自行记录每次调用；标志使用失败后通过修正重试时，会自动推导出 flag_alias 候选项；对尚无操作手册的查询类别执行 teach 时，会根据本次会话的日志自动合成 playbook_candidate。你只需进行判断：先 recall，对显示出的候选项采取行动，通过 teach 记录最终答案，观察到修正时使用 playbook amend。你无需手动记录失败情况。

第 1 步：任何探索前先执行 recall

对于新的用户问题，在运行列表／搜索／深入查询命令前，先运行：

scrape-creators-pp-cli recall "<user's question>" --agent

响应封装：

{
  "query": "...",
  "normalized": "<normalized form>",
  "query_entities": ["..."],
  "found": true | false,
  "match_score": 0.0,
  "results": [
    { "resource_id": "...", "resource_type": "...", "venue": "...",
      "confidence": 2, "entity_match": "exact|partial|unknown",
      "source": "taught|preseed|pattern", "warnings": ["..."] }
  ],
  "mismatches": [ /* only when --debug-mismatches */ ],
  "warnings": [ /* top-level */ ],
  "candidates": [
    { "id": 12, "class": "flag_alias | playbook_candidate",
      "summary": "...", "sightings": 3, "last_seen": "...",
      "rationale": "...",
      "next_action": ["<trial command>", "scrape-creators-pp-cli learnings confirm 12"] }
  ],
  "playbook": {
    "query_family": "...",
    "playbook": {
      "steps": [ { "cmd": "<command with {slot} substitution>", "purpose": "..." } ],
      "entity_slots": ["$ENTITY"],
      "expected_tool_calls": 3
    },
    "slots_resolved": { "$ENTITY": { "token": "<live token>", "canonical": "<canonical>" } },
    "notes": "<workarounds + gotchas for this query family>"
  },
  "notes": "<duplicate surface for non-playbook callers>"
}

空存储短路：如果存储中尚无学习记录、操作手册或候选项（recall 未找到任何内容，且 learnings list 和 learnings candidates 均为空），则本次会话剩余时间内跳过 recall，避免每次查询都增加开销；等有内容通过 teach 记录后，再恢复先执行 recall 的流程。

步骤 2：决策树

按以下顺序读取 candidates、playbook、notes、results[0] 和警告：

if Candidates present (warnings include "candidates_present"):
    -> candidates are try-then-confirm, never facts. Follow each candidate's
       two-step next_action verbatim: run the trial command first, then run
       `learnings confirm <id>` only after the trial verified the behavior.
       Reject a wrong candidate with `learnings reject <id>`.
    -> NEVER re-teach something recall surfaced as a candidate; confirm or
       reject that candidate instead of teaching a duplicate.
    -> candidates ride alongside playbooks and resource hits, not instead of
       them; continue with the branches below after acting on them.

if Playbook present:
    -> READ Playbook.notes verbatim FIRST (workarounds + gotchas the CLI surface doesn't expose)
    -> replay Playbook.steps in order, substituting Playbook.slots_resolved entries
       for the entity slot tokens. If a step's slot is unresolved, fall back to
       discovery for that step only.
    -> the Playbook's expected_tool_calls is a budget; if you find yourself running
       materially more, record the divergence via `scrape-creators-pp-cli playbook amend`
       at end-of-session.

elif Notes present (no Playbook):
    -> read Notes verbatim before any discovery step; they carry known gotchas
       for this query family even when no structured choreography exists yet.

elif Found AND Results[0].EntityMatch == "exact" AND Results[0].Confidence >= 2:
    -> skip discovery; fetch live data for Results[*].ResourceID in parallel

elif Found AND Results[0].EntityMatch == "partial":
    -> candidate hint, NOT a hit; read the resource title to validate before trusting

elif (any row in Mismatches[] when --debug-mismatches was passed):
    -> treat as cold start; the stored learning is for a different entity
       (different canonical resolved from query_entities)

else:  // Found == false, no playbook, no notes
    -> cold start; run discovery normally; teach the answer afterward (Step 4).
       If the family has no playbook yet, that teach auto-synthesizes a
       playbook candidate from this session's journal - you do not need to
       record one by hand.

Playbook 和 Notes 与逐资源路径相互独立。一次召回响应可以同时包含 Playbook 和 Results[] 命中项——两者都要使用：Playbook 会告诉你要执行哪套流程；资源命中项则可以跳过特定步骤。默认跳过 mismatches；只有在调查冷启动时的意外情况时，才传入 --debug-mismatches。

候选项判断详情：learnings confirm <id> 会在候选项落地前打印其完整载荷——请检查打印出的载荷是否与已验证的行为相符。learnings reject <id> 会将推导签名标记为墓碑，避免同一候选项再次出现。信封中只包含当前值得处理的少数候选项；scrape-creators-pp-cli learnings candidates 会列出所有未处理的候选项。

优雅降级：如果 learnings confirm 是未知命令，说明你正在使用较旧的二进制文件——忽略候选项说明，继续遵循协议的其余部分。

步骤 3：始终读取 warnings

• low_confidence：行存在，但 confidence<2。将其视为提示，而不是可跳过发现流程的命中项。
• resource_not_in_store：本地存储中没有该学习条目指向的资源。匹配验证器无法对实体分类——请直接抓取并重新评估。
• cross_alias_match（逐结果）：该行是在不同别名下记录的，并通过 entity_lookups 与实时查询的规范实体匹配（例如，针对“USA”的记录满足了针对“United States”的召回）。请信任 resource_id。
• similar_shape_different_entity:<canonical>（顶层）：存在结构匹配的行，但其规范实体与实时查询的规范实体不同。按冷启动处理；该警告会提供冲突规范实体作为提示，但该行不会提升为 Results。
• ambiguous_alias（顶层）：单个查询实体解析出了多个规范实体（例如，“Cards” → Arizona Cardinals + St. Louis Cardinals）。在确定资源之前，请根据上下文说明存在歧义。
• candidates_present（顶层）：信封中包含 candidates 部分。请先通过步骤 2 中的候选项分支处理，再进行其他操作。
• lookup_refresh_available（顶层）：查询中的实体尚无查找行，但同步数据可能会提供一条。运行 scrape-creators-pp-cli sync 以刷新实体查找项。
• 顶层 no_learnings_for_query_family：表中没有高于 Jaccard 阈值的行。属于纯冷启动。

步骤 4：完成回复后始终执行 teach &

教学是无条件的。解决存储无法回答的查询后，请在后台记录最终资源映射——不设调用次数门槛，也不判断这次学习是否“值得”。教学是循环的锚点：对于尚无 Playbook 的类别，它会触发 Playbook 合成；指向同一对象的不同说法会归并到同一类别，因此近似重复的教学不会让存储变得零散。请在整理好面向用户的回复后、发送回复前，用 shell & 启动教学，让调用立即返回：

scrape-creators-pp-cli teach --query "<user's question>" --resource-type <type> --resource <id1> --resource <id2>
# (append shell `&` to background it)

成功时不显示任何信息。错误只会写入已解析状态目录下的 teach.log。请教学最具体的资源——如果用户问的是宽泛问题，而你通过遍历父记录找到了具体答案，请教学叶节点 ID，而不是父节点。CLI 会在召回时使用预置的 entity_lookups 进行跨别名解析，因此在某个别名下进行教学（例如，“Niners”）也会自动满足未来使用其他别名（例如，“49ers”、“San Francisco”）的查询。

PII 规则：教学结构性问题时应去除标识符——绝不要在教学查询或备注中包含姓名、电子邮件、电话号码、账户 ID 或其他个人标识符。CLI 会扫描教学查询中明显的电子邮件/电话号码格式并发出警告，但不会阻止操作；请在教学前去除这些信息，而不要依赖警告。

步骤 5：playbooks——可选标志，自动综合

你无需判断某个会话是否「值得」创建 playbook：对尚无 playbook 的某个系列进行 teach 时，会根据会话日志自动综合出一个 playbook_candidate，并由下一个会话通过 confirm/reject 来判定。只有当你已经掌握值得原样记录的操作流程时，才附加显式的 playbook 标志——例如 CLI 未显示的变通方法（被静默丢弃的标志、未记录的参数、分页技巧、有效负载注意事项）。优先使用集成式单次调用形式——在同一次 teach 调用中记录资源学习内容和 playbook：

# Common case: record both the resource learning AND the playbook in one call.
scrape-creators-pp-cli teach \
  --query "<user's question>" \
  --resource <id> \
  --resource-type <type> \
  --playbook-file ~/playbooks/<shape>.json \
  --playbook-notes-file ~/playbooks/<shape>-notes.md
# (append shell `&` to background it)

# Alternate: playbook-only (no resource to record alongside).
scrape-creators-pp-cli teach-playbook \
  --query "<user's question>" \
  --playbook-file ~/playbooks/<shape>.json \
  --notes-file ~/playbooks/<shape>-notes.md

Playbook 文件是包含 steps、entity_slots、expected_tool_calls 的 JSON 文件。Notes 文件是以 Markdown 编写、原样记录注意事项的文件。仅使用文件的调用方（仅 MCP 的 Agent）可直接传入相同内容：在集成式 teach 形式中使用 --playbook-json 和 --playbook-notes，在 teach-playbook 中使用 --playbook-json 和 --notes。在集成式 teach 形式中，playbook 标志为可选项——如果只进行资源学习，可完全省略这些标志。在独立的 teach-playbook 形式中，必须至少设置 playbook 或 notes 标志之一；两者都为空时会被拒绝。Playbook 根据结构化查询系列建立索引（去除实体），因此，从一个实体形状的查询中学到的操作方案适用于形状相同的所有其他查询；在召回时，slots_resolved 会绑定当前查询的规范值。

如果你在未来的召回中确实找到 playbook，请将其视为事实依据：使用 slots_resolved 替换值后重放步骤，跳过该操作流程已记录的探索过程，并在执行任何步骤前阅读 notes。

步骤 6：当调试响应发现需要修正的内容时，使用 playbook amend &

如果你的调试协议响应发现了 notes 或 playbook 应记录的具体修正内容——例如变通方法、未记录的端点结构、过时的字段名称、观察到的架构漂移、空有效负载回退方案——请在生成面向用户的响应之前触发 playbook amend。采用与 teach 相同的触发后即不等待结果的方式。

scrape-creators-pp-cli playbook amend \
  --query "<exact recall query string>" \
  --add-note "<your concrete correction>"
# (append shell `&` to background it)

值得修订的内容：本次会话中你观察到的、未来的你会受益的行为。值得修订的示例：

• CLI 界面会静默丢弃或调换标志顺序时的变通方法。
• 未记录的端点结构（响应被包装在 {meta, results} 中，有效负载比文档所述多嵌套了两层）。
• 观察到的架构漂移（字段已重命名、索引在不同赛季间发生变化、API 现在返回小写的类别标签）。

不应写入 notes 的内容：

• 用户问题的特定年份或特定实体答案。这是响应，不是学习内容。
• Playbook 已在运行时获取的逐队、逐运动员或逐行数据。
• 对现有 notes 内容的改述。

amend 命令会将内容附加到该系列已有的 notes 中，并带有时间戳标记（[amend YYYY-MM-DDTHH:MMZ]: <text>）。多个 amend 会累积；审计记录可见。如果该系列尚无 playbook，amend 会创建一个仅包含 notes 的 playbook（因此冷启动时的修正也能记录下来）。

amend notes 的 PII 规范

playbook amend notes 旨在未来可能作为共享知识流入 Printing Press 的上游版本。请勿在其中包含可识别用户身份的内容，以便在无需事后清理的情况下保持上游贡献路径畅通：

• 请勿嵌入用户文件系统路径、个人 API 密钥或令牌、用户电子邮件地址、用户 GitHub 用户名，或与单个用户关联的特定查询历史记录。
• 可以包含：端点结构、未记录的字段名称、API 注意事项、观察到的架构漂移、CLI 界面的变通方法、可泛化的分页或重试技巧。

如果某项修正只有结合用户特定上下文才有意义，请将其记在个人笔记中，而不是 playbook amend 中。

衡量闭环效果

scrape-creators-pp-cli learnings stats 会从本地 learn_events 表中报告召回命中率、教学到复用率、操作手册解析率，以及候选项确认／拒绝次数。在有分母之前，相关比率为 null；所有数据都保留在本机。用它来检查此 CLI 的闭环是否发挥了应有的作用。

禁用学习

• 单次命令使用 --no-learn，会同时短路 recall 和 teach 写入路径。适用于不得受累积学习结果影响的确定性 Agent 流程或测试。
• 在环境中设置 SCRAPE_CREATORS_NO_LEARN=true，可全局禁用该流程。

Agent 反馈

当你（或 Agent）发现此 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

条目会以 feedback.jsonl 的形式存储在解析后的数据目录中。除非设置了 SCRAPE_CREATORS_FEEDBACK_ENDPOINT，并且传入了 --send 或设置了 SCRAPE_CREATORS_FEEDBACK_AUTO_SEND=true，否则绝不会发送 POST 请求。默认行为仅在本地存储。

记录让你感到意外的地方，而不是提交错误报告。简短、具体、一行即可：这才是能不断积累价值的部分。

输出传送

每条命令都接受 --deliver <sink>。输出会发送到指定目标，同时也可替代标准输出，因此 Agent 无需手动通过管道传递结果即可路由命令结果。支持三种目标：

目标	效果
stdout	默认；仅写入标准输出
file:<path>	将输出原子性地写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（使用 --compact 时为 application/json 或 application/x-ndjson）

不支持的方案会被拒绝，并返回列出支持方案的结构化错误。Webhook 失败会返回非零状态码，并在标准错误中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。当定时或周期性运行的 Agent 在每次提供不同输入时，都使用相同的已保存标志，就适合使用配置。

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 下列出所有可用配置，供进行自省的 Agent 在运行时发现它们。

退出码

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

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 scrape-creators-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并附带 --agent）

安装 MCP 服务

1. 安装 MCP 服务：

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

2. 在 Claude Code 中注册：

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

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which scrape-creators-pp-cli 如果未找到，请提供安装选项（参见本技能顶部的先决条件）。
2. 根据用户查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

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

4. 如果不明确，请查看子命令帮助：scrape-creators-pp-cli <command> --help。