用途：查询 Pinterest 公开的个人资料、看板与 Pin，浏览 Ideas 分类体系，并按关键词搜索，结果以规范化 JSON 返回，来自 Crawlora API，无需自行抓取或使用非官方客户端库。
主要能力：搜索 /pinterest/search?query= 返回匹配的 Pin（标题、描述、图片、看板、发布者）；Pin 详情 /pinterest/pin/{id} 返回标题、描述、图片、看板、发布者、评论数、收藏数、创建时间；看板详情 /pinterest/board/{username}/{slug} 返回看板元数据（名称、描述、封面图、Pin 与关注者数、所有者）及一页 Pin；用户资料 /pinterest/user/{username} 返回显示名、简介、网站、头像、关注者/关注/ Pin/看板数；用户看板与 Pin 用 /pinterest/user/{username}/boards 和 /pinterest/user/{username}/pins；Ideas 分类 /pinterest/categories 返回顶层分类（如 Animals、Home Decor、Food And Drink），其 id 用于 /pinterest/ideas/{id} 获取该分类元数据及一页 Pin。
使用方式：先在 https://crawlora.net 获取免费 Crawlora API key（每月 2000 credits，无需信用卡），将 CRAWLORA_API_KEY 设置到环境变量，helper 会读取该变量并请求 https://api.crawlora.net/api/v1，缺失或无效 key 返回 401。所有请求使用 scripts/crawlora.sh，以避免 key 出现在命令行参数中。示例：scripts/crawlora.sh /pinterest/user/marthastewart | jq '.'；scripts/crawlora.sh /pinterest/search query="minimalist home office" | jq '.'；scripts/crawlora.sh /pinterest/categories | jq '.'。完整端点见 reference/endpoints.md。
适用场景：竞品看板审计（对比看板主题、Pin 数与关注者数找内容缺口）、内容选题调研（先查分类再看该分类 feed 当前内容）、品牌或关键词扫描（搜索后查看头部结果的收藏数与发布者）。
限制：仅公开数据，不支持登录或私密看板，需遵守 Pinterest 条款；按成功计费，仅 2xx 计费；看板查询需同时提供 username 与 slug，slug 取自看板自身 /{username}/{slug}/ URL，没有按名称搜索看板的端点；/pinterest/ideas/{id} 需先通过 /pinterest/categories 取得分类 id，id 无法由显示名猜测；列表端点（search、board、user/{username}/boards、user/{username}/pins、ideas/{id}）只返回一页，需检查响应中的 cursor/offset 翻页。key 仅存于 CRAWLORA_API_KEY，切勿硬编码、放入查询参数或提交到仓库。