| name | pinterest-search |
| description | Route and run bounded public Pinterest image search that turns a keyword into normalized image, pin, and title records for moodboards, visual references, and creative inspiration. |
| metadata | {"postplus":{"familyId":"pinterest","familyName":"Pinterest"}} |
Pinterest Search
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.
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.
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 |
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.
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.
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.
postplus research collect pinterest-search --request request.json --output result.json
