mcpField
P
pinterest-research

pinterest-research

github.com/crawlora-org其他141 次安装1 天前更新
代码仓库

关于 pinterest-research

通过 Crawlora API 查询 Pinterest 的公开个人资料、画板、图钉和 Ideas 分类，并以规范化 JSON 返回，适用于趋势发掘、内容研究和竞品审查。

主要功能

  1. 01按关键词搜索图钉
  2. 02获取图钉和画板详情
  3. 03查看公开资料及图钉
  4. 04浏览 Ideas 分类
  5. 05获取规范化 JSON

适用场景

  1. 01审查竞品画板
  2. 02从分类动态中寻找内容灵感
  3. 03查看图钉详情和收藏数

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill pinterest-research

安装后在 Claude Code 中输入/pinterest-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Pinterest 调研

通过 Crawlora API 查询公开的 Pinterest 个人资料、收藏夹和 Pin，浏览 “Ideas” 类别体系并进行关键词搜索，所有数据均为规范化 JSON；无需抓取 Pinterest，也无需使用非官方客户端库。

适用场景

  • “ 的 Pinterest 个人资料、粉丝数或收藏夹是什么情况？”
  • “获取这个收藏夹中的 Pin / 该用户自己发布的 Pin。”
  • “这个 Pin 里有什么？”（标题、描述、图片、收藏数）
  • “在 Pinterest 上搜索关于 的 Pin。”
  • “Pinterest 的 Ideas 类别有哪些？ 中什么内容正在流行？”
  • Pinterest 竞品收藏夹审查、内容创意调研或趋势探索。

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个积分，无需银行卡）。
  • 运行辅助程序前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助程序从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

  1. 搜索 — /pinterest/search?query= 根据文本查询搜索匹配的 Pin（每条结果包含标题、描述、图片、收藏夹和发布者）。
  2. Pin 详情 — /pinterest/pin/{id} 获取单个 Pin 的完整详情：标题、描述、图片、收藏夹、发布者、评论数、收藏数和创建时间。
  3. 收藏夹详情 — /pinterest/board/{username}/{slug} 获取收藏夹元数据（名称、描述、封面图片、Pin 数量、粉丝数、所有者）以及其中一页 Pin。
  4. 用户资料 — /pinterest/user/{username} 获取用户的公开资料：显示名称、简介、网站、头像，以及粉丝、关注、Pin 和收藏夹数量。
  5. 用户的收藏夹 / Pin — /pinterest/user/{username}/boards 和 /pinterest/user/{username}/pins 分别获取该用户自己收藏夹或 Pin 的一页内容。
  6. Ideas 类别 — /pinterest/categories 获取顶级 “Ideas” 类别体系（例如 “Animals”、“Home Decor”、“Food And Drink”）；每个条目的 id 可用于调用 /pinterest/ideas/{id}，获取该类别的元数据以及其动态流中的一页 Pin。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Profile + boards + pins:
scripts/crawlora.sh /pinterest/user/marthastewart | jq '.'
scripts/crawlora.sh /pinterest/user/marthastewart/boards | jq '.'
scripts/crawlora.sh /pinterest/user/marthastewart/pins | jq '.'

# Search + pin detail:
scripts/crawlora.sh /pinterest/search query="minimalist home office" | jq '.'
scripts/crawlora.sh /pinterest/pin/123456789 | jq '.'

# Ideas categories + a category feed:
scripts/crawlora.sh /pinterest/categories | jq '.'
scripts/crawlora.sh /pinterest/ideas/home-decor | jq '.'

所有请求均使用 scripts/crawlora.sh；它会避免将 API 密钥放在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Pinterest 端点。

示例

  • 竞品收藏夹审查： 获取竞品的个人资料以及 /pinterest/user/{username}/boards，比较收藏夹主题、Pin 数量和粉丝数，以发现内容空白。
  • 内容创意调研： 通过 /pinterest/categories 找到相关的 “Ideas” 类别，然后调用 /pinterest/ideas/{id} 查看该类别动态流中当前呈现的内容，再规划新的 Pin。
  • 品牌提及 / 关键词全面搜索： 使用 /pinterest/search 搜索品牌或产品名称，然后对排名靠前的结果调用 /pinterest/pin/{id}，查看收藏数和发布者详情。

注意事项与限制

  • **额度 / 成功后付费：**仅对 2xx 响应计费；免费层级每月提供 2,000 个额度。 在 https://crawlora.net 获取密钥。
  • 仅限公开数据——公开个人资料/画板/图钉；无需登录，不支持私密画板。请遵守 Pinterest 的条款。
  • **安全性：**密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交到代码库。
  • 查询画板需要同时提供 username 和 slug——从画板自身的 /{username}/{slug}/ URL 获取 slug；没有按名称搜索画板的端点。
  • /pinterest/ideas/{id} 需要先从 /pinterest/categories 获取类别 ID——无法根据类别的显示名称推测 ID。
  • 列表端点（search、board、user/{username}/boards、user/{username}/pins、ideas/{id}）会返回一页结果——检查响应中的游标/偏移量，以获取后续页面。

评论

支持 Markdown