pinterest-search

Pinterest 搜索

当用户希望获取公开的 Pinterest 图片证据（图片地址、情绪板来源列表或视觉灵感链接），并从关键词开始时，使用此技能。

仅当关键词工作流需要澄清时，才阅读 references/search.md。

任务

将一个关键词转换为一组范围明确的 Pinterest 图片。将每条结果规范化为 { image_url, pin_url, title }，并按图片地址去重。先执行足以回答请求的最小规模搜索，然后停止并报告搜索范围、结果数量、最有力的结果和后续操作。

参考索引

用户请求	应用方式
使用关键词搜索任意 Pinterest 图片	仅在需要时查阅 references/search.md
扩大搜索范围：获取更多结果、变更筛选条件或使用第二个关键词	查阅 references/search.md
抓取画板、个人资料或 Pin URL，获取购物／产品字段或互动指标	当前公开接口不支持。说明情况并停止
搜索非 Pinterest 图片来源	转交处理；此处仅运行 Pinterest 流程

首要问题

仅当答案会改变执行路径、首轮搜索范围或输出形式时，才提出一个问题。

缺失信息	提问
关键词	我应该在 Pinterest 上搜索哪个关键词？
范围过广	首轮搜索最重要的一个关键词是什么？
筛选意图	应该包含所有 Pin，还是只包含视频 Pin？

不要向用户询问凭据、实现方式、架构字段、隐藏筛选条件或重试策略。

执行规范

1. 使用下方命令；仅在需要时阅读 references/search.md。
2. 执行足以回答首轮搜索的最窄范围采集；从最小限制 20 开始。
3. 将输出规范化为 { image_url, pin_url, title }，并按图片地址去重。
4. 首轮搜索后停止，并报告搜索范围、结果数量、最有力的结果、限制和后续操作。

不要将范围明确的首轮搜索描述为 Pinterest 的完整目录。只能使用该流程展示的公开筛选条件。

公开命令边界

• 运行 postplus research run pinterest-search --query <keyword> --kind <all|videos> --limit <n> --wait --output <result.json>；最小限制为 20。

• 就绪情况诊断：postplus doctor --skill pinterest-search。

• 仅在需要时使用 postplus research run pinterest-search --help 检查标志。

• 首轮搜索范围应保持有限；检查首轮结果后再决定是否扩大范围。

• 执行请求的任务会使用现有 PostPlus 积分；操作前先确认当前价格和余额。仅估算的请求不会执行。若积分不足则停止；不要充值、购买订阅或重复执行结果不确定的付费操作。

仅当平台范围或证据解读仍不明确时，才查阅 平台约定；不要将其作为预检步骤。

证据质量

1. 保留可用的图片记录和来源 pin URL；丢弃没有图片的记录，并按图片 URL 去重。
2. 如果已完成的一轮结果稀少或偏离主题，请在范围内尝试一个聚焦关键词，或更改为受支持的类型。
3. 在范围和预算已获批准的前提下，成功但结果不足时，最多再进行两轮更改后的后续查询；不要重复完全相同的请求，也不要隐瞒失败或待处理的操作。
4. 达到足够结果、达到上限，或后续查询无济于事时就停止。报告有用的证据和不确定之处；保留原始结果和来源链接。

image_url 是素材，pin_url 是其来源页面；缺失的标题应继续缺失，视觉灵感不构成互动证据。 完整的机器字段请使用 postplus research schema --route <route> --json； 仅在处理需要时查阅，不要在每次请求前都查阅。

postplus research run pinterest-search \
  --query "example topic" \
  --wait \
  --output ./result.json

遵循 CLI 的结构化结果和报告的下一步操作；不要根据自由文本消息推断如何恢复。 如果用户已明确批准的范围和最高费用涵盖当前请求，则重用该批准；否则，须先取得批准，再确认报价。不得仅凭任务本身推断已获准支出。 通过返回的检查点或操作继续同一操作；切勿重新提交结果不确定的任务、重复已用尽的恢复步骤，或切换提供商以绕过失败。