前言¶

做 Pinterest 数据采集或竞品分析时，常见的做法是自己翻官方接口文档、写请求、处理分页和限流。Pinterest 的接口分散在用户、图集、画板、关注关系等多个维度，字段命名和分页策略并不统一，人工对接的成本不低。另一个问题是账号维度的数据难以直接拿到——比如某个博主的全部关注者、某个画板下的全部 Pin。

下面介绍的 keyapi-pinterest 是一个面向这类需求的 Agent Skill，把 Pinterest 的常用查询能力封装成可直接调用的步骤。它由社区开发者 user_2e47cd26 发布，当前版本 1.1.2，定位在 data-analysis 分类。

这是什么¶

一句话定位：keyapi-pinterest 是一个通过 KeyAPI REST API 检索并分析 Pinterest 用户、Pin、画板以及关注/被关注关系的 Skill。

它解决的问题是，让 Agent 在对话中直接完成以下动作，而不用每次重新查文档、拼请求：按关键词找用户、取账号资料、遍历某个用户的 Pin 库、取画板集合、遍历关注与被关注网络。

来源归属：社区发布（community），发布者 user_2e47cd26，托管在 SkillHub，坐标 @user_2e47cd26/keyapi-pinterest-analysis。该 Skill 的说明明确写到它使用 KeyAPI 的在线官方文档（live official docs）来对齐接口，因此接口定义以 KeyAPI 当前文档为准。

核心功能¶

已核实的能力如下。

• 用户搜索：按关键词发现 Pinterest 用户。
• 资料信息：查询单个用户的 profile 信息。
• Pin 库：获取某个用户的 pin library。
• 画板集合：获取某个用户的 boards 集合。
• 关注关系：遍历 followers（粉丝）与 following（关注）网络。

这些能力对应官方简介中列出的五类用途：user search、profile information、pin libraries、board collections、follower/following network traversal。

需要强调的是，这些能力都通过 KeyAPI 这一第三方 REST 服务访问，不是直接调用 Pinterest 官方 API。接口地址、鉴权方式、字段含义都以 KeyAPI 文档为准。

安装与启用¶

已抓取资料中没有给出官方的一键安装命令，也没有提供 CLI 或编辑器插件的安装路径，因此这里只写可以核实到的部分。

1、来源信息。Skill 坐标为 @user_2e47cd26/keyapi-pinterest-analysis，托管地址：

https://api.skillhub.cn/user_2e47cd26/keyapi-pinterest-analysis

2、版本与渠道。当前版本 1.1.2，来源 community（社区发布）。

3、API Key 配置。资料中的标签标明 requires_api_key=true，说明使用前必须准备 KeyAPI 的 API Key。具体配置项名称（例如环境变量名或配置文件字段）在已抓取资料中没有出现，请以 KeyAPI 官方文档和 Skill 包内说明为准，不要照抄本文猜测的字段名。

4、启用方式。这类 Skill 基于通用 SKILL.md 格式。在支持该格式的 Agent 环境（如 Cursor、Codex CLI、Claude Code 等）中，按对应平台的 Skill 加载方式指向该坐标即可。已抓取资料未区分各平台的安装差异，本文不做展开。

典型用法¶

已抓取资料未提供可复现的调用示例或命令行输出，因此本节只描述使用路径，不虚构命令与返回值。

使用前先确认三件事：KeyAPI 账号已开通、API Key 已配置、目标查询在 KeyAPI 文档中有对应接口。然后就可以把任务交给 Agent，例如：

• 「搜索关键词为 ××× 的 Pinterest 用户，列出前 20 个」
• 「取用户 ×× 的资料，包括粉丝数和关注数」
• 「遍历用户 ×× 的画板，列出每个画板下的 Pin 数量」
• 「列出用户 ×× 的前 100 个粉丝」

Agent 会按 SKILL.md 中记录的步骤，构造 KeyAPI 请求并解析返回。返回字段的含义需对照 KeyAPI 文档确认。

适用场景与注意¶

适合的场景：

• 需要批量获取 Pinterest 账号资料、Pin 库或画板信息，且能接受通过第三方 API 访问。
• 需要做关注关系网络遍历，例如从某个账号出发做小范围扩散。
• 希望在对话中直接完成查询，而不是自己写采集脚本。

需要注意的限制：

1、依赖第三方。数据来自 KeyAPI，不是 Pinterest 官方接口。KeyAPI 的接口变更、配额策略、可用性都会直接影响这个 Skill。

2、需要 API Key。标签 requires_api_key=true 表明这是强制前置条件，未配置时查询会失败。

3、合规边界。Pinterest 对自动化采集有服务条款约束。做大规模抓取前，确认 KeyAPI 的使用条款以及目标站点的可接受范围。

4、分页与限流。关注关系、Pin 库这类列表型数据通常有分页。具体参数由 KeyAPI 文档定义，使用前先确认。

5、元数据现状。该 Skill 在 SkillHub 上评分 100000，下载 467 次，安装 2 次。下载量不大，使用前建议先读一遍包内的 SKILL.md，确认接口定义与当前 KeyAPI 文档一致。

小结¶

keyapi-pinterest 的价值在于把 Pinterest 的用户、Pin、画板、关注关系四类查询固化成可直接调用的步骤，省去每次重新查文档和拼请求的成本。它依赖 KeyAPI 作为数据通道，需要自备 API Key。

官方地址：https://api.skillhub.cn/user_2e47cd26/keyapi-pinterest-analysis