pinterest-search
Find public Pinterest images from a keyword for moodboards and visual inspiration. Return usable image links, source pins, and titles.
- Installs
- 526
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/postplusai/postplus-skills --skill pinterest-search- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads pinterest-search automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
Read references/search.md only when the keyword workflow needs clarification.
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/search.md only if needed |
| 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, schema fields, hidden filters, or retry strategy.
Run Discipline
- Use the command below; read
references/search.mdonly if needed. - 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.
Do not present a bounded first pass as the full Pinterest catalog. Use only the public filters shown by the route.
Public Command Boundary
-
Run
postplus research run pinterest-search --query <keyword> --kind <all|videos> --limit <n> --wait --output <result.json>; the minimum limit is 20. -
Readiness diagnostics:
postplus doctor --skill pinterest-search. -
Inspect flags with
postplus research run pinterest-search --helponly when needed. -
Keep the first pass bounded; expand only after inspecting the first result.
-
Requested tasks use existing PostPlus credits after the current price and balance are checked. Estimate-only requests do not execute. Stop on insufficient credits; do not recharge, buy a subscription, or repeat an uncertain paid operation.
Only if platform scope or evidence interpretation remains unclear, consult platform contract; it is not a preflight.
Evidence Quality
- Keep usable image records and source pin URLs; discard records without an image and deduplicate by image URL.
- If a completed pass is sparse or off-topic, try one focused keyword or supported kind change within scope.
- Allow at most two changed follow-up passes after successful but insufficient results, within approved scope and budget; do not repeat an identical request or hide a failed/pending operation.
- Stop when sufficient, at the bound, or when another pass would not help. Report useful evidence and uncertainty; preserve raw results and source links.
image_url is the asset, pin_url is its source page; missing titles stay missing and visual inspiration is not engagement evidence.
Full machine fields belong to postplus research schema --route <route> --json;
consult it only when required for processing, not before every request.
postplus research run pinterest-search \
--query "example topic" \
--wait \
--output ./result.json
Follow the CLI's structured result and reported next action; do not infer recovery from free-text messages. Reuse explicit user approval that already covers the requested scope and maximum cost; otherwise obtain approval before confirming a quote. Never infer spending authorization from a task alone. Resume the same operation through its returned checkpoint or action; never resubmit uncertain work, repeat exhausted recovery, or switch providers to bypass failure.
<!-- END GENERATED EXECUTION EXAMPLE -->FAQ
What does the pinterest-search skill do?
Find public Pinterest images from a keyword for moodboards and visual inspiration. Return usable image links, source pins, and titles.
How do I install pinterest-search?
Run npx skills add https://github.com/postplusai/postplus-skills --skill pinterest-search in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pinterest-search/ (personal) or .claude/skills/pinterest-search/ (project).
Which AI agents can use pinterest-search?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is pinterest-search safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains pinterest-search?
It is published by postplusai in postplusai/postplus-skills. It has 526 recorded installs.
More from postplusai/postplus-skills
audio-transcription
postplusai/postplus-skills
Transcribe local or remote audio into text and timestamps. Convert an existing timed transcript locally into SRT or ASS without another transcription job.
video-transcription
postplusai/postplus-skills
Transcribe speech in local or remote videos with timestamps. Convert existing timed transcripts locally into SRT or ASS; use media-analysis for visual understanding.
google-trends-research
postplusai/postplus-skills
Research Google Trends keyword momentum, regional interest, and related queries. Use search-interest evidence without treating it as sales or total demand.
facebook-research
postplusai/postplus-skills
Research public Facebook pages, groups, posts, reels, comments, ads, events, marketplace listings, and profiles for audience or competitor evidence.
youtube-research
postplusai/postplus-skills
Research public YouTube channels, video metrics, and comment samples; obtain downloadable video records when requested. Use for content and audience evidence.
video-analysis
postplusai/postplus-skills
Analyze local or remote social videos through PostPlus, especially for TikTok/Reels shot beats, timelines, voiceover or on-screen text capture, creative strategy, and natural Markdown outputs. Use this when you need video-level analysis beyond metadata and want results linked back to source metadata.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image