pinterest-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Pinterest Search

Pinterest搜索

Use this skill when the user wants public Pinterest image evidence — image addresses, moodboard source lists, or visual inspiration links — starting from a keyword.

Apply

references/shared-contract.md

first, then

references/search.md

for the keyword discovery workflow.

当用户需要从关键词出发获取公开的Pinterest图片相关信息——包括图片地址、情绪板来源列表或视觉灵感链接——时，可使用此技能。

请先遵循

references/shared-contract.md

，再按照

references/search.md

执行关键词搜索流程。

Job

任务

Turn one keyword into a bounded set of Pinterest images. Return each result normalized to

{ image_url, pin_url, title }

, deduplicated by image address. Run the smallest first pass that can answer the request, then stop and report scope, count, strongest results, and next action.

将单个关键词转换为一组受限的Pinterest图片。将每个结果标准化为

{ image_url, pin_url, title }

格式，并按图片地址去重。执行能满足请求的最小范围首次搜索，随后停止并报告搜索范围、结果数量、最优结果以及下一步操作。

Reference Index

参考索引

User asks for	Apply
Any Pinterest image search from a keyword	`references/shared-contract.md` , then `references/search.md`
Broader pass: more results, filter variation, or a second keyword	`references/search.md`
Board scrape, profile scrape, pin-URL scrape, shopping/product fields, engagement metrics	Not supported on the current public surface. Say so and stop
Non-Pinterest image sources	Hand off; run only the Pinterest lane here

用户需求	适用文档
通过关键词进行任意Pinterest图片搜索	`references/shared-contract.md` ，随后执行 `references/search.md`
扩大搜索范围：获取更多结果、筛选变体或使用第二个关键词	`references/search.md`
采集画板、个人主页、Pin链接、商品/产品字段、互动数据	当前公开接口不支持该功能，请告知用户并停止操作
非Pinterest图片来源	移交至对应处理流程；此技能仅处理Pinterest相关搜索

First Question

首个问题

Ask one question only when the answer changes the route, first-pass scope, or output shape.

Missing	Ask
Keyword	`What keyword should I search Pinterest for?`
Too broad	`Which one keyword matters most for the first pass?`
Filter intent	`Should I include all pins, or only video pins?`

Do not ask the user for credentials, implementation choice, collection keys, schema fields, hidden filters, or retry strategy.

仅当答案会改变搜索路径、首次搜索范围或输出格式时，才询问用户一个问题。

缺失信息	询问内容
关键词	`What keyword should I search Pinterest for?`
需求过于宽泛	`Which one keyword matters most for the first pass?`
筛选意图	`Should I include all pins, or only video pins?`

请勿向用户索要凭证、实现方案选择、集合密钥、 schema 字段、隐藏筛选条件或重试策略。

Run Discipline

执行规范

Apply
```
references/shared-contract.md
```
.
Apply
```
references/search.md
```
.
Run the narrowest collection that can answer the first pass; start at the minimum limit of 20.
Normalize output to
```
{ image_url, pin_url, title }
```
and deduplicate by image address.
Stop after the first pass and report scope, count, strongest results, limits, and next action.

The result record shape for the collection key is documented in the

postplus-shared

reference

dataset-item-schemas.md

; consult it before writing result-processing code, and probe a single record only to verify.

Do not present a bounded first pass as the full Pinterest catalog. Do not add hosted envelopes, hidden implementation fields, unsupported filters, or compatibility fallbacks to the request.

遵循
```
references/shared-contract.md
```
。
遵循
```
references/search.md
```
。
执行能满足首次请求的最窄范围采集；起始最小限制为20条。
将输出标准化为
```
{ image_url, pin_url, title }
```
格式，并按图片地址去重。
首次搜索完成后停止操作，报告搜索范围、结果数量、最优结果、限制条件以及下一步操作。

集合密钥对应的结果记录格式已在

postplus-shared

参考文档

dataset-item-schemas.md

中说明；编写结果处理代码前请查阅该文档，仅需验证单个记录即可。

请勿将受限的首次搜索结果表述为完整的Pinterest目录。请勿在请求中添加托管信封、隐藏实现字段、不支持的筛选条件或兼容性回退逻辑。

Public Command Boundary

公开命令边界

Build the raw request object
```
{ "query": "...", "filter": "all", "limit": 20 }
```
(
```
filter
```
is
```
all
```
or
```
videos
```
;
```
limit
```
minimum is 20) and run the collect verb directly.

Readiness diagnostics:

postplus doctor --skill pinterest-search

If the owned CLI command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback services, or unpublished tools.

Use

postplus research schema --collection-key pinterest-search --json

only when constructing or repairing an unknown request shape.

Hosted collection:

postplus research collect pinterest-search --request <input.json> --output <result.json>

where the request file is the raw collection input object, not a hosted envelope and not

{ "schemaVersion": 1, "input": ... }

Resume a pending collection:
```
postplus research collect --run-handle <runHandle> --output <result.json>
```
(waits in-command up to 45s per invocation; rerun while pending).
Keep the first pass bounded; expand only after inspecting the first result.
If the CLI returns a quote-confirmation challenge, run
```
postplus quote confirm --json --challenge-file <challenge.json>
```
and retry with the returned token.

bash

postplus research collect pinterest-search --request request.json --output result.json

构建原始请求对象
```
{ "query": "...", "filter": "all", "limit": 20 }
```
（
```
filter
```
可选值为
```
all
```
或
```
videos
```
；
```
limit
```
最小值为20），直接执行采集命令。

就绪性诊断：

postplus doctor --skill pinterest-search

。

若自有CLI命令执行失败，请报告确切错误并停止操作。请勿通过仅返回元数据、就绪性探测、本地负载重写、回退服务或未发布工具来绕过失败。

仅在构建或修复未知请求格式时，使用

postplus research schema --collection-key pinterest-search --json

。

托管采集命令：

postplus research collect pinterest-search --request <input.json> --output <result.json>

，其中请求文件为原始采集输入对象，而非托管信封或

{ "schemaVersion": 1, "input": ... }

格式。

恢复待处理的采集任务：
```
postplus research collect --run-handle <runHandle> --output <result.json>
```
（每次调用最多等待45秒；任务待处理时可重新执行命令）。
首次搜索需保持受限；仅在查看首次结果后再扩大范围。
若CLI返回确认挑战，请执行
```
postplus quote confirm --json --challenge-file <challenge.json>
```
，并使用返回的令牌重试。

bash

postplus research collect pinterest-search --request request.json --output result.json